Alexander Peshkov Fonts embedding Embeds fonts of different types (Type1, TrueType, OpenType) and shows appopropiate configuration settings. 2003-07-21 RenderX XEP allows you to use several types of fonts in your document: Adobe standard Latin fonts, PostScript Type 1 fonts, OpenType fonts (CID-based OpenType fonts are supported for PDF output only; subsetting is not implemented yet), TrueType fonts (PDF output only). In general, to configure a font you must add the appropriate record in XEP configuration file (xep.xml): <font-group xml:base="file:/path_to_font/" label="MyFont Group"> <font-family name="MyFont" embed="true" subset="true"> <font> <font-data ttf="MyFont-Regular"/> </font> <font style="oblique"> <font-data ttf="MyFont-Italic"/> </font> <font weight="bold"> <font-data ttf="MyFont-Bold"/> </font> <font weight="bold" style="oblique"> <font-data ttf="MyFont-BoldItalic"/> </font> </font-family> </font-group> Detailed information about fonts usage can be found in XEP documentation included in the distribution. XEP 4.0 Reference for Java, section 2.4 "Fonts Configuration" (reference.pdf) Embedded Type 1 font As an example we will embed Cyrillic handwriting font (PT Pushkin) with an old orthography. To use this font we place it in the fonts directory specified by xml:base attribute (on the parent font-group element) and add the following code into xep.xml: <font-family name="Pushkin" embed="true"> <font style="italic"> <font-data afm="Pushkin.afm" pfa="Pushkin.pfa" glyph-list="Pushkin.glyphs"/> </font> </font-family> As specified by embed property this font will be embedded in the resulting document. Take note of the presence of glyph-list attribute, which provides glyph list registration. This is necessary since this font has non-standard glyph names. The following paragraph has font-family="Pushkin" attribute and will be rendered using this font. абвг абвг External Type1 font An examplary configuration of a non-embedded Type 1 font: <font-family name="Zapf Chancery" embed="false"> <font style="italic"> <font-data afm="uzcmi8a.afm" pfa="uzcmi8a.pfa"/> </font> </font-family> Since this font is not embedded it must be available on the target system in order to make the output look like expected. The paragraph below has font-family="ZapfChancery" attribute and will be rendered using this font. Rosa fresca aulentissima ch’apari inver’ la state le donne ti disïano, pulzell’ e maritate: tràgemi d’este focora, se t’este a bolontate; per te non ajo abento notte e dia, penzando pur di voi, madonna mia. Embedded TrueType font TrueType fonts in XEP can be used with PDF generator only; these fonts must be Unicode-enabled. An examplary configuration of an embedded ArialMT TrueType font looks as follows: <font-family name="Arial" embed="true" subset="true"> <font> <font-data ttf="arial.ttf"/> </font> <font style="oblique"> <font-data ttf="ariali.ttf"/> </font> <font weight="bold"> <font-data ttf="arialbd.ttf"/> </font> <font weight="bold" style="oblique"> <font-data ttf="arialbi.ttf"/> </font> </font-family> <font-alias name="ArialMT" value="Arial"/> Each font attribute (font-weight/font-style) requires a separate font record in xep.xml. The subset attribute controls font subsetting. An embedded TrueType font can be subsetted: instead of storing the entire font in the document, it is possible to leave only those glyphs that are actually used in the text. This option reduces the output document size but makes it unsuitable for subsequent editing. The following paragraph has font-family="ArialMT" attribute and will be rendered using this font. This is the title "Tevie the Milkman" in Yiddish: טעװיע דער מילכיקער OpenType font You can use OpenType fonts (for example, Adobe fonts from Acrobat CJK packs). Those fonts are supported in PDF output only. As an example we will configure OpenType fonts included in the Adobe Asian Font Packs for Acrobat versions 4, 5, and 6: <font-group xml:base="path_to_Adobe_fonts/" label="Adobe OpenType" embed="true" subset="false"> <font-family name="Kozuka Mincho Pro Acro R"> <font> <font-data ttf="KozMinPro-Regular-Acro.otf"/> </font> </font-family> <font-alias name="KozMinPro" value="KozukaMinchoProAcroR"/> </font-group> Note that fonts themselves are not included in the distribution, and shall be made visible to the formatter in order to use them. The following paragraph has font-family="KozMinPro" attribute and will be rendered using this font. 日本日本 日本日本