Managing Fonts

This topic describes how to manage fonts stored in your DocuVault(s).

Overview

Cypress builds fonts for documents as they are needed. Fonts captured by Cypress are identified as either system fonts (standard Windows fonts) or document-centric fonts (e.g., PDF fonts). Document-centric fonts are dynamically created fonts and are typically found in PDF, PostScript, and other documents. Derived fonts are specialized fonts that are created from a standard font (i.e., a font that is a larger size than the size of the normal font).

See the ASG-Cypress Advanced Formatting Administrator’s topic for more information on working with fonts.

Using the font_prog Utility

You can use the font_prog utility to manage and modify the fonts stored in your DocuVault(s). Cypress builds fonts for documents as they are needed.

To enter a font_prog command

Open a command prompt window, and change the working directory to the Cypress Server directory.

You might find it useful to increase the viewable area of the command prompt window by modifying its properties. This table lists the font_prog commands:

font_prog Command	Description
add	Loads the specified font into the DocuVault without replacing the existing font.
delete_all_unused_fonts	Deletes all fonts that are not associated with a document.
delete_unused_doc_fonts	Deletes any document-centric font that is not associated with a document in the DocuVault.
load	Loads the specified font or metrics to the DocuVault. The load command replaces an existing font or metrics file if it has already been loaded.
rebuild	Rebuilds all derived fonts in the DocuVault.
show_font_use	Displays a list of documents in which the specified font appears.

Help is available for the font_prog utility from the command prompt window by entering font_prog ?.

Loading a Font into the DocuVault

You can use the load font command to load a font into a DocuVault if you want to replace an existing font with a new one. If you want to add a new version of a font while retaining an older version, use the add font command.

To load a font

Open a command prompt window, and change the working directory to the Cypress Server directory. Enter this command to load a font:

font_prog load font to <DocuVault name>

where:

is the file name of the font, which is not case-sensitive.

<DocuVault name> is the name of the DocuVault in which you want to load the font, which is case-sensitive.

If you do not include a fully qualified file path with the file name, Cypress will look for the font in the current directory. If you want Cypress to look in the Windows system font directory instead, add the keyword system to the load font command. For example:

font_prog load system font to <DocuVault name>

The parameter can include the standard asterisk (*) and question mark (?) wildcards, for example:

font_prog load system font arial.ttf to University@255.1.1.255

font_prog load font Arial?.ttf to ABCDocuVault@CypABC

Enclose the and <DocuVault name> parameters in quotation marks if they contain spaces, for example:

font_prog load system font “Univers Bold” to CompanyABC@CypABC

font_prog load font C:\temp\ar*.ttf to “Production 1@CypServer”

Adding a Font to the DocuVault

You can use the add font command to add a new version of a font to a DocuVault without replacing the existing versions of the font. Use the load font command if you want to replace the older versions with the newer version.

To add a font

Open a command prompt window, and change the working directory to the Cypress Server directory. Enter this command to add a font:

font_prog add font to <DocuVault name>

where:

is the file name of the font, which is not case-sensitive.

<DocuVault name> is the name of the DocuVault to which you want to add the font, which is case-sensitive.

font_prog add system font to <DocuVault name>

The parameter can include the standard asterisk (*) and question mark (?) wild cards, for example:

font_prog add system font Georgia.ttf to CompanyABC@CypABC

font_prog add font Mistral.ttf to Production_1@Vega

You must enclose the and <DocuVault name> parameters in quotation marks if they contain spaces, for example:

font_prog add system font “Times New Roman.ttf” to University@255.1.1.255

font_prog add font “Univers Bold.ttf” to “Test 1@Vega”

Loading a Metrics File into the DocuVault

You can use the load metrics command to load a metrics file into a DocuVault. Loading a new metrics file replaces any existing metrics files.

To load a metrics file

Open a command prompt window, and change the working directory to the Cypress Server directory. Enter this command to load a metrics file:

font_prog load metrics <metrics name> to <DocuVault name>

where:

<metrics name> is the name of the metrics file, which is not case-sensitive.

<DocuVault name> is the name of the DocuVault to which you need to load the metrics file, which is case-sensitive.

If you do not include a fully qualified file path with the file name, Cypress will look for the file in the current directory.

The <metrics name> parameter can include the standard asterisk (*) and question mark (?) wild cards, for example:

font_prog load metrics Cour*.cypmet to University@255.1.1.255

You must enclose the <metrics name> and <DocuVault name> parameters in quotation marks if they contain spaces, for example:

font_prog load metrics “Univers Bold.cypmet” to CompanyABC@CypABC

font_prog load font ar*.cypmet to “Production 1@CypABC”

Rebuilding Fonts

If a derived font (e.g., an Adobe Type-1 font or a PCL font) becomes corrupt, you might have to rebuild your DocuVault’s derived fonts. You can use the font_prog’s rebuild command to do this.

To rebuild a DocuVault’s derived fonts

Open a command prompt window, and change the working directory to the Cypress Server directory. From that directory, enter this command:

font_prog rebuild <DocuVault name>

where <DocuVault name> is the name of the DocuVault whose derived fonts you need to rebuild. The DocuVault name is case-sensitive. For example:

font_prog rebuild ABC_DocuVault@CypABC

You must enclose the <DocuVault name> parameter in quotation marks if it contains spaces, for example:

font_prog rebuild “Production 1@CypABC”

This example shows typical output from font_prog’s rebuild command:

Deleting Unused Fonts

It is not necessary to delete unused fonts. You can, however, use this function periodically to remove any fonts not referenced in existing documents.

To remove all document-centric fonts from the DocuVault

Open a command prompt, and enter this command:

font_prog delete_unused_doc_fonts from <DocuVault name>

where <DocuVault name> is the name of the DocuVault from which you want to remove document-centric fonts. The DocuVault name is case-sensitive.

For example, to delete all unused document-centric fonts from the CompanyABC DocuVault, you would enter this command:

font_prog delete_unused_doc_fonts from CompanyABC@CypressABC

If the DocuVault name includes a space, enclose it in quotes, for example:

font_prog delete_unused_doc_fonts from “Production 1@255.1.1.255”

To delete both document-centric and standard Windows fonts from the DocuVault

Open a command prompt, and enter this command:

font_prog delete_all_unused_fonts from <DocuVault name>

where <DocuVault name> is the name of the DocuVault from which you want to remove the fonts. The DocuVault name is case-sensitive.

For example, to delete all unused fonts from the CompanyABC DocuVault, you would enter this command:

font_prog delete_all_unused_fonts from CompanyABC@CypressABC

If the DocuVault name includes a space, enclose it in quotes, for example:

font_prog delete_all_unused_fonts from “Production 1@255.1.1.255”

Showing Font Use

To display font usage

Determine the font DocuVault and font identifier of the font in question:

Open the Resource Manager application, and expand the Font node in the tree view at the left side of the screen.

Find the font in which you are interested in the alphabetical list of fonts below the Font node. You will see the font DocuVault and font ID in parentheses after the font’s name.

For example, the Arial font might be listed as Arial (DocuVault :1):”

Open a command prompt window, and set the working directory to the Cypress Server directory. At the command prompt, enter this command:

font_prog show_font_use in <DocuVault name>

where:

is the font DocuVault from the Resource Manager. This parameter is case-sensitive.

is the font identifier from the Resource Manager.

<DocuVault name> is the name of the DocuVault to which you need to add the fonts. This parameter is case-sensitive.

For example, a valid show_font_use command might look like this:

font_prog show_font_use ABC_DocuVault 1116 in ABC_DocuVault@CompanyABC

You must enclose the and <DocuVault name> parameters in quotation marks if they contain spaces, for example:

font_prog show_font_use “Production 1” 728 in ABC_DocuVault@CompanyABC

font_prog show_font_use ABC_DocuVault 916 in “Production 1@CompanyABC”

Executing the command will generate output like this example: