5–1 Getting Font information

When Antenna House PDF API retrieves font information, it references the system's font folder or uses "font configuration file." How to reference the file differs depending on the OS. Regarding the "font configuration file", see "5-2 Font Configuration File Settings" below.

• [For Windows version]
  • Refers to fonts located in the system fonts folder (usually "{system drive}:\WINDOWS\Fonts").
  • If you want to use fonts located in a location other than the font folder, you can set a "font configuration file".
• [For Linux version]
  • "Font configuration file" settings are required.

5–2 Font Configuration File Settings

If you want to get font information from a specific folder, set the font configuration file. The font configuration file [font-config.xml] is created in the following folder path during installation.

To write font information, write the folder path where the font file exists in the "font-folder path" tag in [font-config.xml].

<font-config>

  <font-folder path="C:\TestFont"></font-folder>

</ font-config>

5–3 Creating Environment Variables

In order to reflect the settings of the font configuration file, you need to create an environment variable and set the value.

"run.sh" is a shell script that executes a Command-line application after setting environment variables with installation destination information. For details, see "10-1-2 Running on Linux versions" in this manual.

5–4 Supported Font Formats

Antenna House PDF API supports the following font formats:

• TrueType fonts (those with Unicode cmap)
• OpenType fonts (those with Unicode cmap)
• Type1 font

The following fonts are not supported:

• Bitmap font
• Type3 font

5–5 Embedding Fonts

If you specify font embedding during processing with Antenna House PDF API, font information will be embedded in the PDF file. However, for the following fonts, font information will not be embedded even if embedding instructions are provided.

• TrueType, OpenType: Fonts for which font embedding is prohibited.
• Type1: Font for which PFB file does not exist

See "-embedFonts: Embedding fonts" in this manual for the actual settings in the command.

5–6 Merging Fonts

If you specify to merge fonts during PDF optimization processing using Antenna House PDF API, duplicate font information will be merged.

Merging fonts has the following conditions:

• Merging fonts is done for fonts embedded in the PDF.
• The following fonts are to be integrated.
  • TrueType, Type1 (CFF format only), CIDFontType2, CIDFontType0
• Even if the font type is the same, if the Font dictionary values (Ascent, CapHeight, etc.) are different, they will not be merged.
• TrueType fonts and CIDFontType2 fonts are subject to be merged only if the cmap, head, hhea, hmtx, maxp, cvt, fpgm, and prep tables are the same.

For details on how to actually specify merging fonts using commands, see Chapter 13 of this manual, "-optimize: Optimizing PDF Files."

5–7 Font Limitations

There are limitations of Antenna House PDF API when processing using fonts.

• Bitmap fonts and Type3 fonts are not supported.
• In vertical writing, even if italic is specified, if the font does not have glyphs, it will not become italic.

For limitations on other than fonts, see "Chapter 8 Limitations " in this manual.

5–8 Processing that Handles Fonts

The commands for specifying fonts on Antenna House PDF API Command-line are covered in "Chapter 13 Parameters for Commands" in this manual.

The specific commands are as follows:

• 13-17 -writeText: Adding Text
• 13-9 -setTextWatermark: Inserting Text Watermark
• 13-21 -addPageNumber: Adding Page Number