Option Setting File

The Option Setting File is an XML file which describes the operating setup for AH Formatter V6.3. It can be loaded by the -i option in Command-line Interface, etc. In Windows Graphical User Interface, the Option Setting File is loaded automatically if AHFSettings.xml (AHFSettings(x64).xml for Windows x64 version) exists in the application specific data directory. The application data directory is indicated by the environment variable, APPDATA as follows: [APPDATA]\AntennaHouse\AHFormatter\6.3\

When the content of the Option Setting File is corrected with the editor, etc. while AH Formatter V6.3 is running, the correction is not reflected to AH Formatter V6.3. Please exit AH Formatter V6.3 once or load the Option Setting File from the [Format]-[Import Option Setting Dialog] menu in GUI. (There may be some which cannot be changed by reloading settings).

The following are the elements of the Option Setting File:

Element Location Description
<formatter-config> root element Root element of the AH Formatter V6.3 Option Setting File.
<formatter-settings> child of <formatter-config> Formatter Settings element.
<font-settings> child of <formatter-config> Font Settings element.
<script-font> child of <font-settings> Generic font mapping settings element.
<font-alias> child of <font-settings> Font alias settings element.
<pdf-settings> child of <formatter-config> The element of PDF Output Settings.
<embed-font> child of <pdf-settings> Embedding font settings element.
<ps-settings> child of <formatter-config> The element of PostScript Output Settings.
<svg-settings> child of <formatter-config> SVG Output Settings element.
<inx-settings> child of <formatter-config> INX Output Settings element.
<mif-settings> child of <formatter-config> MIF Output Settings element.
<text-settings> child of <formatter-config> TEXT Output Settings element. no-LT
<mathml-settings> child of <formatter-config> MathML Settings element.
<xslt-settings> child of <formatter-config> XSLT Settings element.
<param> child of <xslt-settings> The xslt:param settings element.
<stylesheet> child of <xslt-settings> Default stylesheet settings element.

AH Formatter V6.3 allows you to specify one of the following units for the parameter (designated with asterisk * sign) that takes the length value. In addition to these, relative units like em or % can be specified for the parameter with double asterisk ** sign.

Representation Meanings
cm centimeter
mm millimeter. 1 mm = 1/10 cm
in inch. 1 in = 2.54 cm
pt point. 1 pt = 1/72 in
pc pica. 1 pc = 12 pt
jpt 1 jpt = 0.3514 mm
q 1 q = 0.25 mm

Formatter Settings

These settings are used for the formatting.

Element Location Attribute Default Description
<formatter-settings> child of <formatter-config> abbreviation-character-count 3 Specify the number of characters considered to be an abbreviation when a line break is inserted. See also axf:abbreviation-character-count.
append-non-end-of-line-characters Specifies to append the non-end-of-line characters. White spaces are disregarded even though they are specified. See also axf:append-non-end-of-line-characters in extended FO.
append-non-starter-characters Specifies to append the non-starter characters. White spaces are disregarded even though they are specified. See also axf:append-non-starter-characters in extended FO.
auto-break-footnote true Specifies whether to break the footnote automatically when axf:footnote-max-height="auto" is specified.
auto-formatter-type html When the detection of formatting type is set automatically and the decision of XHTML or HTML is unclear, the priority can be given by specifying the following values.
  • html
  • xhtml
See also Detection of Formatting Type.
baseline-mode 6 In AH Formatter V6, there are some changes from XSL Formatter V4 in deciding the baseline in the text with different scripts like a mixture of Western and Japanese. The following values can be specified.
  1. Operates the same as XSL Formatter V4.
  2. Adds the improved operation by AH Formatter V5.
  3. Adds the improved operation by AH Formatter V6.
See also Difference in Formatting with AH Formatter V6.0. In addition, when baseline-mode="4" is specified, the text-altitude and text-depth properties are invalid.
bold-ratio 1.0 Specifies the weight of a font without bold in the font family. When 1.0 is specified, only the amount decided by the system is made thicker. For instance, when 1.5 is specified, it is drawn 1.5 times thicker. When 0.0 or less is specified, it is considered as 1.0 thick. This setting is effective with PDF Output and PostScript Output.
border-medium-width * 3pt Specifies the default border width in medium style with the real-type numeric value.
border-thick-width * 5pt Specifies the default border width in thick style with the real-type numeric value.
border-thin-width * 1pt Specifies the default border width in thin style with the real-type numeric value.
css-media-type print AH Formatter V6.3 evaluates 'print' among @media settings of CSS. You can specify any number of media types using the white space character as a delimiter. For example, specify like css-media-type="print screen". When the setting is empty, all @media will not be evaluated.
default-CJK Specifies the language (such as jpn or kor) to be applied when a script is ambiguous for CJK. Although the default value is determined from the operating environment, Japanese language is assumed when the operating environment is other than CJK.
default-color #000000 Specifies the default color of text with the format of #RRGGBB.
default-font-size * 10pt Specifies the default font size with the real-type numeric value.
default-from-page-master-region false In XSL1.1, there is no compatibility with XSL1.0 in the method of evaluating writing-mode or reference-orientation. If true is specified, it becomes the same operation as when writing-mode="from-page-master-region()" reference-orientation="from-page-master-region() is specified for fo:page-sequence. Refer to from-page-master-region() for details.
default-html-charset UTF-8 Specifies the default encoding of HTML. This setting is applied to HTML with unknown encoding. When the setting is in HTML, or the encoding can be recognized by BOM, they are adopted. See also <text-settings encoding>. Case insensitive.
default-lang Specifies the default language code. The language code follows ISO 639-2. There is no default value. default-lang specifies the language when FO doesn't have the language specification. This is outputted as the language information to the PDF. The default value of default-lang is empty. At this time, if the language is not specified for FO etc., the language information is not outputted to the PDF. The language specified to default-lang2 is adopted when default-lang is empty.
default-lang2 eng Specifies the language actually adopted when default-lang is empty. When default-lang2 is empty, it depends on the locale of the system.
default-page-height * 297mm Specifies the default page height with the real-type numeric value.
default-page-margin-bottom * 10% Specifies a default page margin with the real-type numeric value. A percent value is considered as a ratio out of the page width or the page height.
default-page-margin-left * 10%
default-page-margin-right * 10%
default-page-margin-top * 10%
default-page-width * 210mm Specifies the default page width with the real-type numeric value.
except-non-end-of-line-characters Specifies the except-non-end-of-line characters. This setting will be ignored even if white spaces are specified. See also the extension property axf:except-non-end-of-line-characters.
except-non-starter-characters Specifies the except-non-starter characters. This setting will be ignored even if white spaces are specified. See also the extension property axf:except-non-starter-characters.
fixed-width-space-treatment always The glyph such as EM SPACE (U+2003) etc. which corresponds to the white space with fixed width is not contained in many fonts. Therefore, alternative glyph, such as an square symbol, will be displayed. In such a case, it specifies whether to put the white space or not without displaying an alternative glyph. If true is specified, an white space will be generated. If false is specified, an alternative glyph will be displayed. The target characters and their widths are as follows. (in units of em)
U+2000EN QUAD1/2
U+2001EM QUAD1
U+2002EN SPACE1/2
U+2003EM SPACE1
U+2004THREE-PER-EM SPACE1/3
U+2005FOUR-PER-EM SPACE1/4
U+2006SIX-PER-EM SPACE1/6
U+2007FIGURE SPACEThe same width of the figure '0'.
U+2008PUNCTUATION SPACEThe same width of the punctuation period '.'.
U+2009THIN SPACEDepends on the setting of thin-space-width.
U+200AHAIR SPACEDepends on the setting of hair-space-width.
U+205FMEDIUM MATHEMATICAL SPACE4/18
hair-space-width 0.1 Specifies the character width of HAIR SPACE (U+200A) in units of em, when fixed-width-space-treatment="true" is specified.
hyphenation-TeX When HyphenationOption="true" is specified, enumerates comma-delimited languages which you want to hyphenate with TeX dictionary, e.g.: hyphenation-TeX="ces,deu". V6.3 no-LT
HyphenationOption true Specifies whether to hyphenate words by using the original processing that supports over 40 languages or to use the TeX dictionary. I f false is specified, Words will be hyphenated by using the TeX dictionary. At that time, only the languages that have the dictionaries can be hyphenated.
intrusion-displace-mode 6 In AH Formatter V6, there are some changes from AH Formatter V5 in the behavior of the intrusion-displace property. Please specify when you want to make it the same as V5.
  1. Operates the same as AH Formatter V5.
  2. Adds the modified operation by AH Formatter V6.
See also Difference in Formatting with AH Formatter V5.
issue-scale-to-fit false Specifies whether to report the scale-change ratio when the scale ratio of the image is changed by scale-to-fit/scale-down-to-fit/scale-up-to-fit with the value of true or false. If true is specified, the level 1 is reported.
justify-leader false Although the reader functions in the justified line, the reader itself is not justified. leader-alignment="none" specifies whether the reader itself is justified or not when the contents are only the text, by leader-pattern="dots" or leader-pattern="use-content" If true is specified, the space may be generated between characters in the leader, the leader may become irregular against the other leaders. However, the space at the end of the leader will disappear. V6.2MR2
keep-footnote-anchor true When a block including a footnote anchor does not fit within the page, the lines up to the dividable position after the anchor are sent to the previous page. See also Difference in Formatting with AH Formatter V6.2 in Technical Notes. V6.3
latin-ligature true Specifies whether to process the ligature in European languages with the value of true or false. If true is specified, the ligature will be processed. If false is specified, it will not be processed. This setting affects the value of axf:ligature-mode="auto".
non-starter-ideographic-space true Specifies whether to treat the ideographic space as a non-starter character. See also Treatment of full-width white space in Technical Notes
normal-line-height 1.2 Specifies the default line height with the real-type numeric value. A unit is not specified. The value means the ratio to the font size. The initial value is 1.2. Therefore, in case the font size is 10pt, the line height becomes 12pt.
normalize NFC Specifies the method of the normalization to be adopted when axf:normalize="auto" is specified. The following values can be specified: no-LT
  • none : Does not normalize text.
  • NFC : Performs NFC.
  • NFD : Performs NFD.
  • NFKC : Performs NFKC.
  • NFKD : Performs NFKD.
See also Difference in Formatting with AH Formatter V6.0.
oblique-skew 0 Specifies the amount of the inclination when using "font-style ="oblique" or "Backslant". When 0 or less is specified, it is considered as the system default. The font is inclined by the system default whenever there is no italic in the font when using "font-style ="italic". This setting is effective in the following outputs.
omit-uppercase-word-accents ell Specifies the language you want to remove a certain kind of accent mark by comma separated values when text-transform="uppercase" is specified. The language code defined by ISO 639 can be specified. For the moment, only Greek is supported.
omit-uppercase-word-accents="ell"
In Greek, the processing of removing tonos is performed. The target characters are as follows: However, U+0389 is excluded when it is an independent word. The accent to a diphthong can also be adjusted.
  • U+0386
  • U+0388
  • U+0389
  • U+038A
  • U+038C
  • U+038E
  • U+038F
  • U+03D3
V6.2MR1
overflow-limit-block ** 0pt Specifies the default value of axf:overflow-limit-block. V6.2MR3
overflow-limit-inline ** 0pt Specifies the default value of axf:overflow-limit-inline. V6.2MR3
printer-marks-line-length * 10mm Specifies the length of the printer marks.
printer-marks-line-width * 0.24pt Specifies the width of the printer marks.
printer-marks-zero-margin * 3mm Specifies the margin between the page and the printer marks when bleed is 0. no-LT
PrinterOrientation auto When the paper is placed in landscape in the PS Printer, there may be a case that the printer rotate-output the line and EPS incorrectly because some printers cannot get information. Possible to correct the rotation by specifying one of the following values. (The value should be anti-clockwise rotation degree).
  • auto
  • 0
  • 90
  • 270
This setting is effective only with Windows version.
PscriptPassThrough true Possible to makes Pass Through output invalid when outputting to PS printer. If true is specified, Pass Through output is executed. If false is specified, Pass Through output is not executed but the output is executed only by GDI operator. This setting is effective only with Windows version.
pair-kerning true Specifies whether to process the pair kerning with the value of true or false. I f true is specified, the ligature will be processed. If false is specified, it will not be processed. This setting affects the value of axf:kerning-mode="auto".
punctuation-spacing 50% Specifies the space width between the adjacent Japanese full width characters with the percentage value. The value means the ratio to the font size. This setting affects the value of axf:punctuation-spacing="auto" in extended FO.
punctuation-trim true When Japanese full width characters (punctuations, brackets) are used in succession or come at the start of a line, you can specify whether to trim the letter spacing or keep the same letter spacing with the value of true or false. If the value is true, the letter spacing will be tracked narrow. If the value is false, it will be the same as that of other full width characters. This setting affects the values of axf:punctuation-trim="auto" and axf:text-justify-trim="auto" in extended FO.
pxpi 96 In XSL or CSS, you can specify px (pixel) as a unit of measurement. pxpi specifies the coefficient, which converts the value of the specified px, as "the number of pixels per inch" when formatting. It's specified with the real-type numeric value.
ruby-align Specifies the arrangement when axf:ruby-align="auto" is specified. When nothing or "auto" is specified, it is considered as "Distribute-space center".
SeparatePrinterDuplexJob true Specifies whether to batch print without interrupting a job for printing, even if the switching of the printer between simplex/duplex modes is set when axf:printer-duplex is specified. If true is specified, the file is split and outputted, if false is specified the file is batch printed.
small-caps-emulation-size 70% Specifies the scale-down ratio when the font does not have small-caps when font-variant="small-caps" is specified.
tab-overlap-treatment ignore-tab Specifies a behavior when tab alignment makes letters overlapped, by selecting from either ignore-tab or next-tab. Please refer to axf:tab-overlap-treatment. V6.3 no-LT
table-auto-layout-limit 100 When table-layout="auto" is specified, it is necessary to look ahead and read the table to decide the width of column. The number of row to read ahead can be limited because it takes a long time to read all row in a too huge table. After reading ahead up to the number of row specified here, the width of column is decided. If 0 is specified, all row is read, and then the width of column is decided. Refer to Table Auto Layout for details.
table-is-reference-area false In XSL1.1, there is no compatibility with XSL 1.0 about whether to make fo:table a reference area. If true is specified, fo:table will be made a reference area and its operation will be the same as XSL1.0. Refer to Incompatibility of fo:table for more details.
text-autospace true Specifies whether to insert spaces surrounding ideographic glyphs to make them look better with the value of true or false, in the document ideographic and non-ideographic glyphs are mixed. If the value is true, a space will be inserted to make them look better. If the value is false, a space won't be inserted. This setting affects the value of axf:text-autospace="auto" in extended FO.
text-autospace-width 25% Specifies the space width surrounding ideographic glyphs characters with the percentage value. The value means the ratio to the font size. This setting affects the value of axf:text-autospace-width="auto" in extended FO.
text-decoration-mode 1 Specifies how much the underline, strikethrough and overline exceed the length of a word.
0.Do not exceed the word length.
1.Exceed half-length of the space between words.
2.Do not exceed the start edge of a word, but exceed the end edge of a word by the full space between words.
text-justify-mode 5 In AH Formatter V5 or later, there are some changes from XSL Formatter V4 in trimming a line. Please specify the value when you want to make it the same operation as V4. This adjusts the initial value when axf:text-justify-trim="auto" is specified. The following values can be specified.
  1. Operates the same as XSL Formatter V4. That is, it is considered that ideograph and inter-word are specified.
  2. Adds the improved operation by AH Formatter V5.
See also Difference in Formatting with XSL Formatter V4.
text-kashida-space 100% Specifies the percentage of the Kashida in Arabic justification. The value indicates the percentage of white space and Kashida. If the value is 0%, Kashida is not inserted and only the white space expands as well as the normal justification. If the value is 100%, Kashida is inserted as much as possible. This setting affects the value of axf:text-kashida-space="auto" in extended FO.
text-orientation-mode 6 Specifies whether UTR#50: Unicode Vertical Text Layout is taken into consideration by the value of axf:text-orientation when rendering alphanumeric characters, etc. upright in vertical writing mode. no-LT
5.UTR#50 is not taken into consideration.
6.SVO and MVO are taken into consideration.
Note:
text-underline-mode 6 Some improved changes have been added for the position of underline and overline with AH Formatter V6. Please specify when you want to make it the same as V5.
  1. Operates the same as AH Formatter V5.
  2. Adds the improved operation by AH Formatter V6.
See also Difference in Formatting with AH Formatter V5.
thin-space-width 0.2 Specifies the character width of THIN SPACE (U+2009) in units of em, when fixed-width-space-treatment="true" is specified.
two-pass-formatting false When formatting a huge document with a large amount of unresolved <fo:page-number-citation>, a large amount of memories are consumed because the cancellation of the page information is impossible. Therefore, the limit is caused in the number of pages to format. This parameter solves that problem by making the formatting two passes. Although its processing time may be increased, only the page number information which should be solved will consume the memory and the memory consumption will be extremely decreased. This setting is invalid with CSS formatting. This setting is invalid with GUI. ☞ Formatting Large Document no-LT
use-default-page-margin-CSS true Specifies whether default-page-margin-* is adopted or not when there is no margin specification in @page in CSS.
use-default-page-margin-XSL false Specifies whether default-page-margin-* is adopted or not when there is no margin specification in fo:simple-page-master in XSL.
vertical-block-width-mode 6 The behavior of the auto value of the width of vertical-text block within horizontal-text flow (or the height of horizontal-text block within vertical-text flow) is changed with AH Formatter V6. Please specify when you want to make it the same as V5.
  1. Operates the same as AH Formatter V5. The width of vertical-text block is given by the width of the outer area.
  2. Adds the improved operation by AH Formatter V6. The width of vertical-text block shrinks to fit the content.
See also Difference in Formatting with AH Formatter V5.
vertical-underline-side auto In the XSL specification, there is no description about the underline in vertical writing mode. The vertical-underline-side property is an option which specifies whether to place the underline in vertical writing mode on the right side or on the left side. If left or right is specified, the underline is placed on the left or on the right. If auto is specified, the underline is placed on the right side when the language property is Japanese(jpn) or Korean(kor). The underline is placed on the left side when the language property is other than Japanese(ja) or Korean(ko). If there is no language properties specified, it depends on the standard CJK language setting. This setting affects the value of the extension property, axf:vertical-underline-side="auto".
viewport-length-units-mode 6 Specifies whether to adapt the CSS3 interpretation of the vw and vh units .
  1. Makes the vw and vh units based on the page size.
  2. Makes the vw and vh units based on the size of the area excluding the page margins.
See also Difference in Formatting with AH Formatter V6.0.
watermark-font-family sans-serif Specifies the font family to the character string which you set to watermark-text.
watermark-font-style normal Specifies the font style to the character string which you set to watermark-text.
watermark-font-weight normal Specifies the font weight to the character string which you set to watermark-text. Possible to specify normal, bold or the numerical value from 100 to 900.
watermark-text Displays the specified watermark text on each page. Possible to make it multiple lines by delimiting with the line feed &#10;. This setting is invalid with the evaluation version. With AH Formatter V6.3 Lite, the watermark that shows the evaluation version is shown after the 300 pages, which is the limited formatted pages with the Lite version. You will need to specify an appropriate watermark-font-family according to the text you specify. Please confirm it by outputting PDF. In addition, complex scripts such as Thai and Arabic cannot be specified. The text that cannot be outputted by a single font cannot be specified.
watermark2-font-family Specifies the font family to the character string which you set to watermark2-text. If not specified, the default value is the same as watermark-font-family. V6.2MR1
watermark2-font-style normal Specifies the font style to the character string which you set to watermark2-text. V6.2MR1
watermark2-font-weight normal Specifies the font weight to the character string which you set to watermark2-text. Possible to specify normal, bold or the numerical value from 100 to 900. V6.2MR1
watermark2-text Displays the specified watermark text on each page. This setting is invalid with the evaluation version. You will need to specify an appropriate watermark2-font-family according to the text you specify. Please confirm it by outputting PDF. In addition, complex scripts such as Thai and Arabic cannot be specified. The text that cannot be outputted by a single font cannot be specified. Multiple lines of text cannot be specified. V6.2MR1
WindowsFontAPI AH Formatter V6.3 handles Arabic, Hebrew, Hindi, Thai, etc. originally, it's possible to display these languages without depending on the platform. However there are some unsupported scripts and fonts which cannot be displayed correctly. Available to specify the script to be displayed by using WindowsAPI. Specify the scripts using the notation defined by ISO 15924 and putting commas between scripts. The following shows an example of Devanagari.
WindowsFontAPI="Deva"
However in this case, the same result cannot be gained when outputting to PDF. In order to get the same result, please use Adobe Distiller to create PDF. In order to make this setting effective, you need to specify use-windows-api="true" as well. The default value is empty. This setting is effective only with Windows version.
CAUTION: Some fonts may not be displayed correctly.
zwsp-mode 5 The operation of ZERO WIDTH SPACE (U+200B) was corrected with AH Formatter V6. However, it's compatible with V5 by default. Please specify when you want make it operate as V6.
  1. Operates the same as AH Formatter V5.
  2. Adds the modified operation by AH Formatter V6.
See also Difference in Formatting with AH Formatter V5.
<list-style-type> child of <formatter-settings> box U+25AB Specifies the character to use by list-style-type="box".
check U+2713 Specifies the character to use by list-style-type="check". ]
circle U+25E6 Specifies the character to use by list-style-type="circle".
diamond U+2666 Specifies the character to use by list-style-type="diamond".
disc U+2022 Specifies the character to use by list-style-type="disc".
hyphen U+2043 Specifies the character to use by list-style-type="hyphen".
square U+25AA Specifies the character to use by list-style-type="square".
<script-chars> child of <formatter-settings> script Evaluates all characters specified to the code as scripts specified to the script. For example, by specifying as follows,

<script-chars script="Jpan" code="&#x5C;"/>

&#x5C; is displayed as ¥. (Note that it is applied only when the font corresponding to Jpan is specified for font-family). When code not being specified, all characters specified to script are canceled. When script not being specified, all characters specified to code are canceled.
code
<space-end-punctuation> child of <formatter-settings> language Specifies the language code.
code Specifies the character to be applied. For the specified language, the specified space is placed end the code specified. When code not being specified, all characters specified to script are canceled.
space Specifies the amount of space with the real type numerical value. The value means the ratio to the fontsize.
<space-start-punctuation> child of <formatter-settings> language Specifies the language code.
code Specifies the character to be applied. The specified space is placed start the specified code for the specified language. When the code is not being specified, all characters specified to script are canceled.
space Specifies the amount of space with the real type numerical value. The value means the ratio to the fontsize.
<space-between-digit-and-punctuation> child of <formatter-settings> language Specifies the language code.
code Specifies the character to be applied. For the specified language, the specified space is placed between the digit and the code specified. When code not being specified, all characters specified to script are canceled.
space Specifies the amount of space with the real type numerical value. The value means the ratio to the fontsize.
<space-between-punctuation-and-digit> child of <formatter-settings> language Specifies the language code.
code Specifies the character to be applied. For the specified language, the specified space is placed between the code specified and the digit. When code not being specified, all characters specified to script are canceled.
space Specifies the amount of space with the real type numerical value. The value means the ratio to the fontsize.
<usercss> child of <formatter-settings> Specifies the CSS user stylesheet you want to add by &lt;css&gt;. See also Cascading Order of CSS.
<css> child of <usercss> path Specifies the path of the CSS user stylesheet.
<script-language-in-CJK> child of <formatter-setting> script When the script specified to the script attribute appears in the sentence of CJK languages, the character string of the script is considered as the language that is specified to the language attribute. For example,

<script-language-in-CJK script="Latn" language="eng"/>

The Latn character string that appears in Japanese or Chinese sentences can be recognized as English. If hyphenate="true" is specified, the hyphenation can be processed by considering this part as English. The CJK languages cannot be specified to language. When nothing is specified to the language attribute, the language specification to the script attribute is canceled.
language
<multimedia> child of <formatter-settings> video When specifying multimedia, such as video or audio as graphics, the setting of content-type is indispensable. AH Formatter may not sometimes recognize if the content-type other than video/* or audio/* formats indicates the multimedia automatically. For such content-type, please specify video or audio explicitly as follows:
<multimedia
video="application/x-shockwave-flash"/>
audio
<GS1-128> child of <formatter-settings> AI Registers the format of application identifier (AI) of GS1-128. Some formats of AI has been already registered, but you can specify when you change the format or the format is not registered. AI is a number with 2 to 4 digits. AI starting from 0 should be 2 digits. The last digit can be set as * if AI is a 3 or 4 digit number. For instance, AI="380*" indicates 3800 to 3809. The following formats can be specified to the format attribute.
  • n3 : 3-digit numbers
  • x3 : 3-digit arbitrary characters
  • n-10 : Numbers with greater than or equal to 1 and less than or equal to 10 digits.
  • x3-10 : Arbitrary characters with greater than or equal to 3 and less than or equal to 10 digits.
For example, specify as follows;

<GS1-128 AI="380*" format="n-15"/>

format
<UTR50> child of <formatter-settings> code Specifies the code point to code you change. The code point can be specified as follows: Characters greater than or equal to U+10000 cannot be specified.
  • One character : or &#x201C;, etc.
  • 4-digit hexadecimal numbers : 201C
  • Set of 4-digit hexadecimal numbers : 202A-202E
U or R or V can be specified to SVO or MVO. It means that U renders upright, R rotates 90-degree clockwise. See also text-orientation-mode. V is same as U, but when vertical writing glyph is designed to rotate 90-degree counterclockwise originally, it is displayed by rotating 90-degree clockwise. no-LT
SVO
MVO

Font Settings

These settings are used for the fonts.

Element Location Attribute Default Description
<font-settings> child of <formatter-config> auto-fallback-font true Specifies whether to look for a fall back font automatically when a font with a glyph cannot be found in the font family which was specified by FO or CSS. See also Font Selection to learn more about the fall back method.
barcode-text-font OCRB,monospace Specifies the font used when you add the text of an original code to the linear barcode with Barcode Generator Option.
default-font-family serif Specifies the default font family. Usually, it is one of the generic font families: serif, sans-serif, cursive, fantasy or monospace. See also Font Selection.
fallback-glyph 1 Specifies whether to report it or not when the glyph is found in a fall back font. When the glyph corresponding to the specified character in the font family is not found, if auto-fallback-font is specified, a fall back font will be looked for. The following either can be specified.
0.No error message will be reported.
1.The level 1 error message will be reported.
2.The level 2 error message will be reported.
font-selection-mode 6 Specifies the selection method of fonts. The following values can be specified.
  1. The setting of font-selection-strategy is disregarded and always considered as auto.
  2. When font-selection-strategy="character-by-character" is specified, the first font that has a glyph is adopted.
See also Font Selection.
font-stretch-mode 6 Specifies whether the information on font-stretch is used when selecting fonts. The following values can be specified.
  1. The information on font-stretch will not be used. The operation is the same as AH Formatter V5.
  2. The information on font-stretch will be used.
See also Difference in Formatting with AH Formatter V6.0.
missing-font 1 Specifies whether to warn when a font is not found from the specified font family. The following either can be specified.
0.No error message will be reported.
1.The level 1 error message will be reported.
2.The level 2 error message will be reported.
missing-glyph 1 Specifies whether to warn when the glyph corresponding to the specified character is not found in the specified font family or the fallback font. The following either can be specified.
0.No error message will be reported.
1.The level 1 error message will be reported.
2.The level 2 error message will be reported.
missing-glyph-all false Usually the report on missing-glyph is given only once to the same character. However, by specifying missing-glyph-all="true", the report can be given to all. Please note that careless specification could cause huge amount of error. This setting is similarly applied to fallback-glyph as well.
use-windows-api false Specifies true when you want to use Windows API with the Windows version, without using the original API for the acquisition of the font information. Since Windows API and the original API are not completely the same, some difference may occur in the formatted result. Effective only with the Windows version. If false is specified, the setting of <formatter-settings WindowsFontAPI> is invalid.
<script-font> child of <font-settings> script Specifies the script codes for multilingual setting. The available scripts conform to ISO 15924. However, the AH Formatter V6.3 does not support all scripts. The following scripts can be specified here.
  • Latn : Latin
  • Grek : Greek
  • Cyrl : Cyrillic
  • Arab : Arabic
  • Hebr : Hebrew
  • Deva : Devanagari
  • Beng : Bengali
  • Guru : Gurmukhi
  • Gujr : Gujarati
  • Orya : Oriya
  • Taml : Tamil
  • Telu : Telugu
  • Knda : Kannada
  • Mlym : Malayalam
  • Sinh : Sinhala V6.2MR1
  • Thai : Thai
  • Khmr : Khmer
  • Laoo : Lao
  • Mymr : Myanmar V6.3
  • Hang : Hangul
  • Hans : Han (Chinese Simplified)
  • Hant : Han (Chinese Traditional)
  • Jpan : Japanese (Han+Hira+Kana)
  • Hrkt : Hiragana+Katakana
For generic fonts you may omit the setting of the script or specify as script=".".
serif Specifies the generic serif font when specified by the script.
sans-serif Specifies the generic sans-serif font when specified by the script.
monospace Specifies the generic monospace font when specified by the script.
cursive Specifies the generic cursive font when specified by the script.
fantasy Specifies the generic font for fantasy when specified by the script.
fallback Specifies the fall back font of the script specified by script. Two or more fonts can be enumerated by comma separated values.
<font-alias> child of <font-settings> src Formats the font name src (source) appearing in FO (or HTML etc.) by replacing with dst (destination). This is achieved by specifying an arbitrary font name for src and dst. This makes it possible to substitute an unknown font in a document made in a different environment, without modifying the document. However, in the following sample,
<font-alias src="A" dst="B">
<font-alias src="B" dst="C">
"A" would never be replaced with "C". Moreover, the setting for <font-alias> doesn't affect the font name in the Option file.
dst

PDF Output Settings

These settings are used for PDF Output.

Element Location Attribute Default Description
<pdf-settings> child of <formatter-config> color-compression auto When the color image format cannot be stored directly in PDF, the image is stored after being transformed into the bit map format which is compatible with PDF. The compression method of the data stored in a PDF file is then specified by one of the following values.
  • auto
  • zlib
  • jpeg
  • jpeg2000
  • keeplzw
  • auto2k V6.3
  • keeplzw2k V6.3
When auto is selected, the process is automatically done and creates the image data according to the setting of color-jpeg-quality. When keeplzw is specified, if the original image is LZW compressed, it becomes the LZW compression. If not, it becomes the same as auto. Whichever has the smaller compressed size, JPEG or ZLIB, is selected. auto2k and keeplzw2k are equivalent to auto and keeplzw each, except that compression will be done with JPEG2000 instead of JPEG. However, they are same as auto and keeplzw in case of PDF1.4 or earlier.
See also Image Output to learn about the file formats which can be stored directly in PDF. This is the setting for the color image. Specifies grayscale-compression for the grayscale image, and monochrome-compression for the monochrome image. In GUI, it can be specified by selecting the Compression option. JPEG2000 is effective only for PDF1.5 or later.
color-compression-default auto Specifies the value of the compression method of the color image when pressing the "Reset Default Settings" button or the "High Compression Settings" button in the Compression page in the PDF Option Setting Dialog in GUI. V6.3 no-LT
color-compression-minimum auto2k
color-downsampling none Specifies the method to downsample the raster color image that is put into PDF.
  • none
  • average
  • bicubic
  • subsampling
When a value other than none is specified, the image that has resolution greater than the one specified by color-downsampling-above-dpi will be downsampled to the resolution specified by color-downsampling-target-dpi. This is the setting for the color image. Specifies grayscale-downsampling for the grayscale image, and monochrome-downsampling for the monochrome image. In GUI, it can be specified by selecting the Downsampling option.
color-downsampling-above-dpi 450
color-downsampling-target-dpi 300
color-downsampling-default none Specifies the value of the downsampling of the color image when pressing the "Reset Default Settings" button or the "High Compression Settings" button in the Compression page in the PDF Option Setting Dialog in GUI. V6.3 no-LT
color-downsampling-above-dpi-default 450
color-downsampling-target-dpi-default 300
color-downsampling-minimum bicubic
color-downsampling-above-dpi-minimum 225
color-downsampling-target-dpi-minimum 150
color-jpeg-quality 80 For the color image format that cannot be stored directly in PDF, specifies the image quality by the numerical value within the range of 1-100 when jpeg is specified by color-compression. The higher the number the better the quality in proportion to the increase in the number; however the file size also becomes larger. Converts this value to the compression ratio to use in case of jpeg2000.
CAUTION: This is not for changing the quality of a JPEG format image.
This is the setting for the color image. Specifies grayscale-jpeg-quality for the grayscale image. In GUI, it can be specified by selecting the JPEG Quality option.
color-jpeg-quality-default 80 Specifies the value of the JPEG image quality of the color image when pressing the "Reset Default Settings" button or the "High Compression Settings" button in the Compression page in the PDF Option Setting Dialog in GUI. V6.3 no-LT
color-jpeg-quality-minimum 40
default-output-intent #OutputConditionIdentifier​=​CGATS TR 001 Sets the default value when the output intent is not specified in FO while outputting PDF/X. Values that can be specified are equal to the ones that can be specified to the src property for fo:color-profile. See also PDF/X
embed-all-fonts true Specifies whether to embed the all fonts in PDF or not with one of the following values, which are embeddable fonts in the formatted result.
  • false
  • true
  • base14
If the value is false, only fonts specified in <embed-font> are embedded. If the value is true, all fonts that can be embedded except Standard 14 Fonts will be embedded. If the value is base14, all fonts including Standard 14 Fonts that can be embedded will be embedded. In GUI, it can be specified by selecting the Embed All Embeddable Fonts option.
embed-font-encoding Specifies the encoding when the TrueType font is embedded. When nothing is specified, Identity-H/V is the default.
  • WinAnsiEncoding
    Specifies WinAnsiEncoding for encoding. If WinAnsiEncoding cannot be specified, Identity-H/V is considered as specified.
embed-std-output-intent false Specifies whether to embed the ICC profile specified for the standard output intent into PDF/X output. It is necessary to specify the actual file of the ICC profile when embedding it. If false is specified, it is not embedded. This setting is invalid when outputting PDF/A because the embedding of the ICC profile is indispensable with PDF/A or PDF/X-4 output. Also it's not available to specify the output intent to the PDF versions other than PDF/X, PDF/A according to the PDF specification.
embed-subset-font-percentage 100 Finds the percent of the character used in PDF against the entire characters that the font has. When the percent of characters used is greater than or equal to the specified value, embeds all font characters including characters not used. If not, embeds only characters that are actually used. In GUI, it can be specified by selecting the Subset embedded fonts when percent of character used is less than: option.
encrypt-metadata true Specifies whether to encrypt the metadata when encrypting the PDF file (Effective with PDF1.5 or later). V6.3 no-LT
encryption-level 128rc4 Specifies the key length when encrypting the PDF file.
  • 40rc4
  • 128rc4 (Effective with PDF1.4 or later)
  • 128aes (Effective with PDF1.5 or later)
  • 256aes (Effective with PDF1.7 or later)
EPS-processor none Specifies whether to output PDF after changing into PDF using an external processor when outputting EPS to PDF in the formatted result.
  • none
  • distiller
  • ghostscript
These have the following meanings.
  • none : Use nothing. The same way in the past.
  • distiller : Use Adobe Distiller in the environment where Adobe Distiller is installed. acrodist.exe is used. Effective only with the Windows version. EPS support at this time has a little restrictions.
    • PS-Adobe-2.0 or later required.
    • %%BeginProlog and %%EndProlog should be included.
    joboptions
  • ghostscript : Use Ghostscript in the environment where Ghostscript is installed. Use gswin32c.exe with the Windows version (use gswin64c.exe with Windows 64-bit) and use gs with non-Windows. Since the program is invoked by fork() etc. and used, there is no problem with GPL license.
    ghostscript
Invalid in the environment where each processor is not installed. Moreover, it's necessary to set the PATH etc. of the program to use. The value is case-insensitive.
error-on-embed-fault false When an error occurs while embedding fonts, specifies whether to stop the job as an error or to continue embedding by replacing the character with a white space using the value of true or false. If the value is true, stops executing as an error. If the value is false, continues executing and outputs PDF by replacing the character with a white space. In GUI, it can be specified by selecting the When Embedding Fails option.
error-on-missing-glyph false When the corresponding glyph for the specified character does not exist in the specified font, specifies whether to break off the processing as an error or to continue the processing by using true or false. When true is specified, the processing will end as an error. When false is specified, although PDF is outputted, the character will be displayed as a white space or a small box in PDF for missing glyph. In GUI, it can be specified by selecting the Error on Missing Glyph option.
error-on-pdfx-fault true Specifies whether to stop formatting as an error or ignore the unsuitable content and continue formatting when a content which is unsuitable for PDF/X or PDF/A is detected while creating PDF/X or PDF/A, such like PDF/X or PDF/A that contains non-embeddable fonts. If false is specified, the processing is continued, a generated PDF may be incongruent as PDF/X or PDF/A. If true is specified, PDF will not be generated as an error. When the unsuitable content is avoidable, the formatting continues. For example, annotations in PDF/X are thrown away. In GUI, it can be specified by selecting the Error on PDF/X or PDF/A fault option. no-LT
ghostscript When converting EPS into PDF using Ghostscript, the full path to Ghostscript can be specified. For example, specify as follows; ghostscript="/usr/local/bin/gs". Thereby, Ghostscript can be invoked even if the PATH does not set to Ghostscript. Specify gswin32c.exe in Windows version (specify gswin64c.exe with Windows 64-bit).
grayscale-compression auto When the grayscale image format cannot be stored directly in PDF, the image is stored after being transformed into the bit map format which is compatible with PDF. The compression method of the data stored in a PDF file is then specified by one of the following values.
  • auto
  • zlib
  • jpeg
  • jpeg2000
  • keeplzw
  • auto2k V6.3
  • keeplzw2k V6.3
When auto is selected, the process is automatically done and creates the image data according to the setting of grayscale-jpeg-quality. When keeplzw is specified, if the original image is LZW compressed, it becomes the LZW compression. If not, it becomes the same as auto. Whichever has the smaller compressed size, JPEG or ZLIB, is selected. auto2k and keeplzw2k are equivalent to auto and keeplzw each, except that compression will be done with JPEG2000 instead of JPEG. However, they are same as auto and keeplzw in case of PDF1.4 or earlier.
See also Image Output to learn about the file formats which can be stored directly in PDF. This is the setting for the grayscale image. Specifies color-compression for the color image, and monochrome-compression for the monochrome image. In GUI, it can be specified by selecting the Compression option. JPEG2000 is effective only for PDF1.5 or later.
grayscale-compression-default auto Specifies the value of the compression method of the grayscale image when pressing the "Reset Default Settings" button or the "High Compression Settings" button in the Compression page in the PDF Option Setting Dialog in GUI. V6.3 no-LT
grayscale-compression-minimum auto2k
grayscale-downsampling none Specifies the method to downsample the raster grayscale image that is put into PDF. The options are:
  • none
  • average
  • bicubic
  • subsampling
When a value other than none is specified, the image that has resolution greater than the one specified by grayscale-downsampling-above-dpi will be downsampled to the resolution specified by grayscale-downsampling-target-dpi. This is the setting for the grayscale image. Specifies color-downsampling for the color image, and monochrome-downsampling for the monochrome image. In GUI, it can be specified by selecting the Downsampling option.
grayscale-downsampling-above-dpi 450
grayscale-downsampling-target-dpi 300
grayscale-downsampling-default none Specifies the value of the JPEG image quality of the grayscale image when pressing the "Reset Default Settings" button or the "High Compression Settings" button in the Compression page in the PDF Option Setting Dialog in GUI. V6.3 no-LT
grayscale-downsampling-above-dpi-default 450
grayscale-downsampling-target-dpi-default 300
grayscale-downsampling-minimum bicubic
grayscale-downsampling-above-dpi-minimum 225
grayscale-downsampling-target-dpi-minimum 150
grayscale-jpeg-quality 80 For the grayscale image format that cannot be stored directly in PDF, specifies the image quality by a numerical value within the range of 1-100 when jpeg is specified by grayscale-compression. The higher the number the better the quality in proportion to the increase in the number; however the file size also becomes larger. Converts this value to the compression ratio to use in case of jpeg2000.
CAUTION: It is not for changing the quality of a JPEG format image.
This is the setting for the grayscale image. Specifies color-jpeg-quality for the color image. In GUI, it can be specified by selecting the JPEG Quality option.
grayscale-jpeg-quality-default 80 Specifies the value of the JPEG image quality of the color image when pressing the "Reset Default Settings" button or the "High Compression Settings" button in the Compression page in the PDF Option Setting Dialog in GUI. V6.3 no-LT
grayscale-jpeg-quality-minimum 40
gs-add-options When converting EPS into PDF using Ghostscript, AH Formatter V6.3 specifies the following parameters and starts Ghostscript.
-dPDFSETTINGS=/printer
-dNOPAUSE
-dBATCH
-dSAFER
-sDEVICE=pdfwrite
-dDEVICEWIDTHPOINTS=Width
-dDEVICEHEIGHTPOINTS=Height
-dEPSFitPage
-q
-sOutputFile=Temporary Output File
-c
.setpdfwrite
-f Input EPS
An additional parameter can be specified as gs-add-options. The parameters specified here will be added before -q stated above. Two or more parameters can be specified by being separated with U+000A. The operation with an inaccurately specified parameter is not guaranteed.
image-color-profile true Specifies whether to embed in the PDF the ICC profile of the color image that will be embedded. If the value is true it is embedded. If the value is false it is not embedded. In GUI, it can be specified by selecting the Output ICC Profile in Images option.
import-annotation-types Annotations contained in the embedded PDF is embeddable directly in PDF. Specify the following character strings separated by white spaces. Case insensitive.
  • All
  • Text
  • Link
  • FreeText
  • Line
  • Square
  • Circle
  • Polygon
  • PolyLine
  • Highlight
  • Underline
  • Squiggly
  • StrikeOut
  • Stamp
  • Caret
  • Ink
  • Popup
  • FileAttachment
  • Sound
  • Movie
  • Screen
  • 3D
  • Other
Specify Other when you embed annotations with no type written. When All is specified, all the annotations are embedded. In GUI, it can be specified by selecting the Import All Annotations option. See also PDF Embedding for more details.
import-tagged-pdf false Specifies whether to permit embedding tagged PDF in tagged PDF. If true is specified, the tagged PDF is embedded as is without producing an error. In GUI, you can change the setting at Allow Importing Tagged PDF. See also PDF Embedding for more details. This setting is not available with AH Formatter V6.3 Lite. V6.2MR2 no-LT
joboptions Specifies Adobe PDF Settings File which is passed to Distiller when converting EPS into PDF using Distiller. Only a local file can be specified. When specifying the relative path, the target EPS file is being considered a relative. However, when EPS itself is a relative path, the operation is instable. Please specify the joboptions with absolute path preferably. Please refer to the manual of Acrobat etc. for Adobe PDF Settings File. The operation when specifying an inaccurate file etc. will not be guaranteed. When this file is not specified, the following contents which are not almost specified at all will be assumed.
<<
  /CompatibilityLevel 1.3
  /AutoRotatePages /None
>> setdistillerparams
<<
>> setpagedevice
Effective only with the Windows version.
linearized false Specifies whether to create linearized PDF. If the value is true, creates linearized PDF that is optimized for Web display. If the value is false, creates normal PDF. In GUI, it can be specified by selecting the Fast Web View option. no-LT
monochrome-compression ccitt4 When the monochrome image format cannot be stored directly in PDF, the image is stored after being transformed into the bit map format which is compatible with PDF. The compression method of the data stored in a PDF file is then specified by one of the following values.
  • ccitt4
  • ccitt3
  • runlength
  • zlib
  • none
Refer to the Image Output for the image format that can be stored directly in PDF. This is the setting for monochrome images. Specifies color-compression for the color image, and grayscale-compression for the grayscale image. In GUI, it can be specified by selecting the Compression option.
monochrome-compression-default ccitt4 Specifies the value of the compression method of the monochrome image when pressing the "Reset Default Settings" button or the "High Compression Settings" button in the Compression page in the PDF Option Setting Dialog in GUI. V6.3 no-LT
monochrome-compression-minimum zlib
monochrome-downsampling none Specifies the method to downsample the raster monochrome image that is put into PDF.
  • none
  • average
  • bicubic
  • subsampling
When a value other than none is specified, an image that has resolution greater than the one specified by monochrome-downsampling-above-dpi will be downsampled to the resolution specified by monochrome-downsampling-target-dpi. This is the setting for the monochrome image. Specifies color-downsampling for the color image, and grayscale-downsampling for the grayscale image. In GUI, it can be specified by selecting the Downsampling option.
monochrome-downsampling-above-dpi 1800
monochrome-downsampling-target-dpi 1200
monochrome-downsampling-default none Specifies the value of the downsampling of the monochrome image when pressing the "Reset Default Settings" button or the "High Compression Settings" button in the Compression page in the PDF Option Setting Dialog in GUI. V6.3 no-LT
monochrome-downsampling-above-dpi-default 1800
monochrome-downsampling-target-dpi-default 1200
monochrome-downsampling-minimum bicubic
monochrome-downsampling-above-dpi-minimum 450
monochrome-downsampling-target-dpi-minimum 300
multimedia-treatment embed Specifies whether to embed multimedia in PDF in case of axf:multimedia-treatment="auto", with one of the following values:
  • embed
  • absolute-link
  • relative-link
V6.3MR1 no-LT
no-accessibility false Specifies whether to permit text access for screen reader devices of PDF files with the value of true or false. If false is specified, it is permitted. If true is specified, it is not permitted. This attribute is effective only when you specify PDF1.4 or later. owner-password is required for the permission settings of text access for screen reader devices to be effective.
no-adding-or-changing-comments false Specifies whether to permit adding or changing comments and form fields in the PDF or not with the value of true or false. If the value is false, permits adding or changing. If the value is true, permits no changes or additions are allowed. owner-password is required for the permission settings of adding or changing comments and form fields to be effective.
no-assemble-doc false Specifies whether to permit inserting, deleting and rotating of PDF pages with the value of true or false. If false is specified, it is permitted. If true is specified, it is not permitted. This attribute is effective only when you specify PDF1.4 or later. owner-password is required for the permission settings of inserting, deleting and rotating of PDF pages to be effective.
no-changing false Specifies whether or not to permit making form field and making other changes in the PDF file or not with the value of true or false. If the value is false, changes are permitted. If the value is true, no changes are permitted. owner-password is required for the permission settings of making form field and making other changes to be effective.
no-content-copying false Specifies whether to permit copying the text and the graphics in PDF or not with the value of true or false. If the value is false, permits copying. If the value is true, permits no copying. owner-password is required for the permission settings of copying the text and the graphics to be effective.
no-fill-form false Specifies whether to permit filling in of form fields and signing of the PDF file with the value of true or false. If false is specified, it is permitted. If true is specified, it is not permitted. This attribute is effective only when you specify PDF1.4 or later. owner-password is required for the permission settings of filling in of form fields and signing to be effective.
object-compression true Compresses the object in PDF. It is effective with PDF1.5 or later and text-and-lineart-compression="true" is specified. If true is specified, the object will be compressed, if false is specified, it will not be compressed. In GUI, it can be specified by selecting the Object Compression option.
object-compression-default true Specifies the value of the Object Compression when pressing the "Reset Default Settings" button or the "High Compression Settings" button in the Compression page in the PDF Option Setting Dialog in GUI. V6.3 no-LT
object-compression-minimum true
overprint Specifies the overprint. Any values of axf:overprint other than auto can be specified. V6.2MR2 no-LT
owner-password Sets the strings specified as a master password. Specify the strings up to 32bytes. The characters with the code in the range of 0x20 to 0x7E, 0xA1 to 0xDF are effective. If the characters other than the above are included, it becomes invalid and no password is set. The default value is no-password.
CAUTION: The password is described in plaintext in the file. Please use care in managing the file.
page-labels true Specifies whether to apply the page labels to the page numbers with the value of true or false. If true is specified the page labels are applied, if false is specified, they are not applied. In GUI, it can be specified by selecting the Output Page Labels option.
pass-through all Embeds an image in a PDF file as it is if available. This is called pass-through. If both pass-through and downsampling are specified, downsampling will precede pass-through. The image format you want to pass through can be specified by using the pass-through. However, the pass-through is not done in case of unavoidable circumstances even if pass-through is specified. The following strings can be specified by enumerating them with white-space specified. Case insensitive.
  • all
  • gif
  • tiff
  • png
  • jpeg
  • jpeg2000
  • jbig2
  • none
Excludes an image type by placing a hyphen (-) before the image type. For instance, pass-through="all -gif" excludes GIF only. V6.3 no-LT
CAUTION: A gif image can be embedded in a PDF file as it is. However, when outputting the PDF file from the PostScript printer, an I/O error may occur. To avoid this error, gif must be deselected.
CAUTION: gif-pass-through (available up to AH Formatter V6.2 was abolished; pass-through must be used.
pass-through-default all Specifies the image type to be passed through when pressing the "Reset Default Settings" button or the "High Compression Settings" button in the Compression page in the PDF Option Setting Dialog in GUI. V6.3 no-LT
pass-through-minimum none
pdf-version PDF1.5 Specifies the version of the PDF to create with one of the following values.
  • PDF1.3
  • PDF1.4
  • PDF1.5
  • PDF1.6
  • PDF1.7
  • PDF/X-1a:2001 no-LT
  • PDF/X-3:2002 no-LT
  • PDF/X-1a:2003 no-LT
  • PDF/X-2:2003 no-LT
  • PDF/X-3:2003 no-LT
  • PDF/X-4:2008 no-LT
  • PDF/A-1a:2005 no-LT
  • PDF/A-1b:2005 no-LT
In GUI, it can be specified by selecting the PDF Version option. PDF/X or PDF/A cannot be selected with AH Formatter V6.3 Lite.
printing-allowed high-resolution Specifies whether to print the resulting PDF file or not. If high-resolution is specified, it allows to printing in high resolution. low-resolution is effective with PDF1.4 or later. If low-resolution is specified, it allows printing in low resolution. If the PDF version is 1.3, it is handled as hi-resolution. If none is specified, it does not allow printing. owner-password is required for the permission settings of printing the PDF file to be effective.
rasterize-resolution 108 If part of a vector image is transformed to a raster image and stored in the PDF. Specifies the value of the rasterize-resolution of the transformed raster images in the range from 70 to 500(dpi). This setting is effective only with Windows version. The vector format image which cannot be stored directly in PDF is not supported with non-Windows version. See also Image Output to learn about the file formats which can be stored directly in PDF.
real-value-limit 2 The limit value of the real value described in PDF is within ±32767 with PDF version less than or equal to 1.4, within ±3.403×1038 with PDF version greater than or equal to 1.5. However, even if the PDF version is greater than or equal to 1.5, if the value exceeds ±32767, some viewers may generate an error. Therefore the outputted real value can be checked so that it may not exceed the limit value when the PDF version is greater than or equal to 1.5. The following values can be specified. V6.2MR7
0.The limit value is not checked.
1.Checked if the value is within ±32767.
2.Checked if the value is approximately within ±2.14748×109.
3.Checked if the value is approximately within ±9.22337×1018.
If the value greater than or equal to 2 is specified, it's considered as 1 is specified with PDF version less than or equal to 1.5.
CAUTION: This setting doesn't mean to guarantee the operation of a viewer, such as Acrobat.
real-value-limit-modify false Specifies whether to modify the value when it exceeds the limit value specified by real-value-limit. If real-value-limit-modify="false" is specified, the value is only checked and it will not be modified. V6.2MR8
reverse-page false If the value is true, outputs pages in reverse order to PDF.
rgb-conversion none Specifies how to convert the RGB color space to DeviceGray.
  • none
    Does no conversion. DeviceRGB is outputted.
  • black
    Converts Black to DeviceGray, converts the others to DeviceRGB before outputting.
  • gray
    Converts Gray color (mono tone) to DeviceGray, converts the others to DeviceRGB before outputting.
  • all
    Converts the all color spaces to DeviceGray before outputting. This conversion is based on the following formula: gray = 0.3×red + 0.59×green + 0.11×blue (0.0 ≤ red,green,blue ≤ 1.0).
  • cmyk
    Converts the all color spaces to CMYK before outputting.
It's possible to change the setting by RGB Conversion in GUI. Similarly converts SVG, CGM, MathML, EMF and WMF that are drawn by the original drawing engine. The other images are converted as below:
  • Converts the color space for all and cmyk; however AH Formatter V6.3 Lite converts no colors. V6.3 no-LT
  • Converts no color space except for all and cmyk.
tagged-pdf false Specifies whether to make the Tagged PDF file or not. PDF may not be able to be tagged depending on the PDF versions. In this case this setting will be ignored. In GUI, it can be specified by selecting the Tagged PDF option. no-LT
text-and-lineart-compression true Specifies whether the text and the line art in PDF are compressed in order to make the size of PDF smaller or not. If the value is true, it is compressed. If the value is false, it is not compressed. In GUI, it can be specified by selecting the Text and Line-Art Compression option.
text-and-lineart-compression-default true Specifies the value of the Text-and-Lineart Compression when pressing the "Reset Default Settings" button or the "High Compression Settings" button in the Compression page in the PDF Option Setting Dialog in GUI. V6.3 no-LT
text-and-lineart-compression-minimum true
transparency-color-space DeviceRGB Specifies the color space when processing the transparency in PDF. Either of the following can be specified.
  • None
  • DeviceRGB
  • DeviceCMYK
transparent-image true Specifies whether to convert the transparent image to be embedded in a PDF file to opaque. When true is specified, the image is not converted. When false is specified, the image is converted to opaque. In GUI, this setting can be changed in the Convert Transparent Image to Opaque. V6.3
use-launch-for-local-file true Specifies whether the external link (external-destination property) specified by the local file is transformed into 'Open the file' or into 'World Wide Web link' in the PDF link properties with the value of true or false. If the value is true, it is transformed to 'Open the file'. If the value is false, it is transformed to 'World Wide Web link'. In GUI, it can be specified by selecting the External Destination Link with Local File option.
user-password Sets the strings specified as a user password. Specify the strings up to 32bytes. The characters with the code in the range of 0x20 to 0x7E, 0xA1 to 0xDF are effective. If the characters other than the above are included, it becomes invalid and does not count as a password setting. The default value is no-password.
CAUTION: The password is described in plaintext in the file. Please use care in managing the file.
<embed-font> child of <pdf-settings> font Specifies the fonts which are embedded in the PDF. This element can be specified without limit and is effective only when embed-all-fonts="false" is specified. When embed-all-fonts="false" is specified and this element is not specified, only the glyph of the character which is needed in the PDF output is embedded. When the element is specified and if the font indicated here is used within the formatted results, the glyph of the character currently used will be embedded. For a font which is not specified, embedding is performed only for the glyph of the character which is needed in the PDF output.

PostScript Output Settings

These settings are used for PostScript Output.

Element Location Attribute Default Description
<ps-settings> child of <formatter-config> noembed-font false Specifies whether fonts are embedded in the outputted PostScript. When true is specified, the font information is not embedded and the font must be referred to only by the PostScript name. Followings are restrictions.
  • The PostScript interpreter may not be correctly processed when the font includes a multi-byte code like Japanese, etc. With Distiller, an error like
    MS-Mincho not found and using Courier.
    may be generated.
  • Character-codes greater than 255 cannot be outputted.
When using non-Type1 fonts, it's not recommended to specify noembed-font.
transparency false The processing of the transparency upon outputting pdfmark is performed when true is specified. At this time, please open joboptions in your text editor and then modify "/AllowTransparency false" to "/AllowTransparency true". The directory of joboptions varies depending on the setting; either the preset or the custom setting. See also the help page of Adobe Acrobat for details. This specification is valid when printing to Distiller too. V6.3 no-LT
use-launch-for-local-file Specifies whether the external link (external-destination property) specified by the local file is transformed into 'Open the file' or into 'World Wide Web link' in the PDF link properties with the value of true or false. If the value is true, it is transformed to 'Open the file'. If the value is false, it is transformed to 'World Wide Web link'. When nothing is specified, follows the specification of use-launch-for-local-file in PDF Output Settings.

SVG Output Settings

These settings are used for SVG Output.

Element Location Attribute Default Description
<svg-settings> child of <formatter-config> copy-image-path Specifies the destination directory to copy images to as specified by "copy-all" or "copy" by image-processing.
copy-image-prefix When images are copied to the directory specified by copy-image-path and processed, specifies the prefix of the file name. The file name will be prefix with sequence numbers. Default is empty character string with only sequential numbers.
embed-all-fonts false By using true or false, specifies whether to embed in the SVG all the outline data of TrueType and Type1 fonts which are not limited to embed among fonts used in the formatted result. If the value is false, only the font specified by <embed-font> is embedded. If the value is true, all fonts that can be embedded are embedded.
error-on-embed-fault true When an error occurs while embedding fonts, specifies whether to stop the job as an error or to continue embedding by replacing the character with a white space using the value of true or false. If the value is true, stops executing as an error. If the value is false, continues executing and outputs SVG by replacing the character with a white space.
format 1 When the formatted result is output to multiple SVG files specified by "false" in singlefile, specifies the format of the additional character string to output to the file name. This character string adopts the character string same as the format property of FO. Each file name is automatically determined based on the output file name. The character string as formatted by the value specified by format will be inserted just before the extension of the output file. For example, if the file name is document.svg, and format="-1" is specified, the file become document-1.svg and document-2.svg and so on.
gzip-compression false If the value is true, creates SVG compressed in gzip format. If the value is false, it is not compressed.
image-conversion auto When the image format to be embedded is a raster image other than JPEG or PNG, it is converted into JPEG or PNG and embedded. The following either can be specified.
  • auto
  • jpeg
  • png
When auto is selected, images of monochrome, grayscale or 256-or-less-color are converted into PNG, and the rest are converted into JPEG.
image-processing embed-all Specifies how to treat the referred image.
  • embed-all
    Embeds all images in the SVG.
  • link
    Links images that have been linked, and embeds the embedded image. Raster images other than JPEG and PNG are always embedded.
  • copy-all
    Copies all image files to the destination that is specified by copy-image-path, and then links.
  • copy
    Copies images that have been linked to the destination that is specified by copy-image-path, and links. The embedded image are embedded.
Refer to Image Output in SVG Output for details of operation.
jpeg-quality 80 For images that cannot be embedded directly in SVG, specifies the image quality by the numerical value within the range of 1-100 when "jpeg" or "auto" is specified by image-conversion. The higher the number the better the quality in proportion to the increase in the number; however the file size also becomes larger.
CAUTION: It is not for changing the quality of a JPEG format image.
rename-copy-image false When images are copied to the directory specified by copy-image-path etc. and processed, specifies whether to rename all file name to prefix specified by copy-image-prefix, or use original name. When the file name overlaps, sequential number is added. When true is specified, all files are renamed.
singlefile false Specifies whether the formatted result composed of multiple pages is output as a single SVG file or as multiple SVG files.
If the value is true, outputs as a single SVG file. If the value is false, outputs as multiple SVG files. When multiple files are output, the file is named by the format specified by format.
Effective only when outputting to a file. It is invalid in the output without the file name like the stream etc.
singlefile-number true When singlefile="false" is specified, specifies whether to add sequential number to the output SVG even if it has only one-page. It is not added in case of false.
rasterize-resolution 108 If part of a vector image is transformed to a raster image and stored in the SVG. Specifies the value of the rasterized-resolution of the transformed raster images in the range from 70 to 500(dpi). SVG, EMF and WMF are drawn in SVG as vectors without being transformed to raster images. This setting is effective only with Windows version. The vector format image which cannot be stored directly in SVG is not supported with non-Windows version.
svg-version 1.1 Specifies the version of the SVG to create with one of the following values.
  • 1.1
  • Basic
  • Tiny
<embed-font> child of <svg-settings> font Specifies the fonts which are embedded in the SVG. This element can be specified without limit and is effective only when embed-all-fonts="false" is specified. When embed-all-fonts="false" is specified and this element is not specified, only the outline of the glyph of the character which is needed in the SVG output is embedded. When the element is specified and if the font indicated here is used within the formatted results, the outline of the glyph of the character currently used will be embedded. For a font which is not specified, embedding is performed only for the glyph of the character which is needed in the SVG output.

INX Output Settings

These settings are used for INX Output.

Element Location Attribute Default Description
<inx-settings> child of <formatter-config> output-mode text Specify how to generate the text frame of InDesign® from text.
  • text
    Text frame is generated from each text area. This mode can convert most closely to the formatting result. It is sometimes difficult to edit the result using InDesign®.
  • line
    Text frame is generated from each line area.
  • block
    Text frame is generated from each block area. It is easy to edit the result using InDesign®. Instead the conversion precision is lost at expense.

MIF Output Settings

These settings are used for MIF Output.

Element Location Attribute Default Description
<mif-settings> child of <formatter-config> output-mode text Specify how to generate the ParaLine of FrameMaker® from text.
  • text
    ParaLine is generated from each text area. This mode can convert most closely to the formatting result. It is sometimes difficult to edit the result using FrameMaker®.
  • line
    ParaLine is generated from each line area.
  • block
    ParaLine is generated from each block area. It is easy to edit the result using FrameMaker®. Instead the conversion precision is lost at expense.
image-processing embed Specifies how to treat the referred image.
  • embed
    Embeds all images in the MIF.
  • link
    Links images as external files.
char-units pt Specifies a value of CharUnits used as a unit of fontsize etc.
  • pt
  • q
units in Specifies a value of Units used as a unit of display.
  • in
  • cm
  • mm
  • pt
  • pc
  • dd
  • cc

TEXT Output Settings

These settings are used for TEXT Output. These settings are not effective with AH Formatter V6.3 Lite. no-LT

Element Location Attribute Default Description
<text-settings> child of <formatter-config> encoding UTF-8 Specifies the encoding of the output text. The following encodings are available. They are not case sensitive.
  • UTF-8
  • UTF-16
  • UTF-16BE
  • UTF-16LE
  • UTF-32
  • UTF-32BE
  • UTF-32LE
  • ISO-10646-UCS-2
  • ISO-10646-UCS-4
  • ANSI_X3.4
  • ISO_646.irv
  • ISO646-US
  • US-ASCII
  • ISO_8859-1
  • latin1
  • Windows-31J
  • Shift_JIS
  • EUC-JP
  • ISO-2022-JP
Endian of UTF-16, UTF-32 etc. depends on the processor in the operating system.
eol-marker CRLF or LF Specifies the linefeed code of the output text. The followings can be specified. They are not case sensitive.
  • CRLF
  • LF
  • CR
The default value is CRLF in Windows, LF in others.

MathML Settings

These settings are used for MathML.

CAUTION: The default value shows the equivalent value. Note that the setting cannot be described as thinSpace="2/10" in fact. Please describe it as thinSpace="0.2" in a file.
Element Location Attribute Default Description
<mathml-settings> child of <formatter-config> scriptsizemultiplier 0.71 In the MathML specification, although the default value of scriptsizemultiplier is defined, the value can be changed by specifying the unitless numerical value (>0).
scriptminsize * 8pt In the MathML specification, although the default value of scriptminsize is defined, the value can be changed by specifying the absolute value with units (≥0).
scriptmaxsize * 0pt In the MathML specification, although there is no definition of the limit value of scriptmaxsize, the value can be set by specifying the absolute value with units (≥0). If less than or equal to scriptminsize is specified, it is considered as unlimited.
largeopmultiplier 1.414 Specifies the multiplier of largeop by the unitless numerical value (>0).
largeopmultiplierInt 2.0 Specifies the multiplier of largeop against the integral by the unitless numerical value (>0). The integral consists of nine characters of U+222B to U+2233.
mathsizeSmall 0.83 Specifies the multiplier against mathsize="small" by the unitless numerical value (>0).
mathsizeBig 1.17 Specifies the multiplier against mathsize="big" by the unitless numerical value (>0).
enQuad 1/2 Specifies the space for EN QUAD U+2000 by the unitless numerical value (>0) or the named length. The numerical value is in unit of em.
emQuad 1 Specifies the space for EM QUAD U+2001 by the unitless numerical value (>0) or the named length. The numerical value is in unit of em.
enSpace 1/2 Specifies the space for EN SPACE U+2002 by the unitless numerical value (>0) or the named length. The numerical value is in unit of em.
emSpace 1 Specifies the space for EM SPACE U+2003 by the unitless numerical value (>0) or the named length. The numerical value is in unit of em.
thinSpace 2/10 Specifies the space for THIN SPACE U+2009 by the unitless numerical value (>0) or the named length. The numerical value is in unit of em.
hairSpace 1/10 Specifies the space for HAIR SPACE U+200A by the unitless numerical value (>0) or the named length. The numerical value is in unit of em.
veryverythinmathspace 1/18 Specifies the space for veryverythinmathspace by the unitless numerical value (>0). The numerical value is in unit of em.
verythinmathspace 2/18 Specifies the space for verythinmathspace by the unitless numerical value (>0). The numerical value is in unit of em.
thinmathspace 3/18 Specifies the space for thinmathspace by the unitless numerical value (>0). The numerical value is in unit of em.
mediummathspace 4/18 Specifies the space for mediummathspace by the unitless numerical value (>0). The numerical value is in unit of em.
thickmathspace 5/18 Specifies the space for thickmathspace by the unitless numerical value (>0). The numerical value is in unit of em.
verythickmathspace 6/18 Specifies the space for verythickmathspace by the unitless numerical value (>0). The numerical value is in unit of em.
veryverythickmathspace 7/18 Specifies the space for veryverythickmathspace by the unitless numerical value (>0). The numerical value is in unit of em.
accentOffset 0.15 Specifies the space between the accent character and the base character by the numerical value with no units or the named length. The numerical value is the em value.
defaultLSpace thickmathspace Specifies the lspace value of the operator which is not registered in the operator dictionary by the unitless numerical value (≥0) or the named length. The numerical value is in unit of em. However, it is always 0 when the operator is empty or the operator has a blank fixed width.
defaultRSpace thickmathspace Specifies the rspace value of the operator which is not registered in the operator dictionary by the unitless numerical value (≥0) or the named length. The numerical value is in unit of em. However, it is always 0 when the operator is empty or the operator has a blank fixed width.
defaultMinsize ** 100% In the MathML specification, although the default value of <mo minsize> is defined as 100%, the value can be changed by specifying the numerical value with units (≥0).
defaultLineleading ** 0pt Specifies the default value of <mo lineleading> with the numerical value with units (≥0). The value indicates the space between lines.
indentingnewline ** 0pt The value of <mspace linebreak="indentingnewline"> was abolished with MathML 3.0. However the amount of space you want to indent can be specified by the numerical value with units (≥0).
applyFunctionSpace thinmathspace Specifies the space for FUNCTION APPLICATION U+2061 when the space is required, by the unitless numerical value (≥0) or the named length. The numerical value is in unit of em.
invisibleTimesSpace thinmathspace Specifies the space for INVISIBLE TIMES U+2062 when the space is required, by the unitless numerical value (≥0) or the named length. The numerical value is in unit of em.
integralSubscriptShift -0.25 Specifies the shift amount of the lower right script (<msub>) of the integral of the largeop by the unitless numerical value or the named length. As for the upper left, it shifts only the amount of -integralSubscriptShift. The setting is invalid when display="inline" or displaystyle="false" is specified. The numerical value is in unit of em.
integralSuperscriptShift 0.05 Specifies the shift amount of the upper right script (<msup>) of the integral of the largeop by the unitless numerical value or the named length. As for the lower left, it shifts only the amount of -integralSuperscriptShift. The setting is invalid when display="inline" or displaystyle="false" is specified. The numerical value is in unit of em.
thinLine 0.5/18 Specifies the thickness of linethickness="thin", mslinethickness="thin" by the unitless numerical value (>0) or the named length. The numerical value is in unit of em.
mediumLine 1/18 Specifies the thickness of linethickness="medium", mslinethickness="medium" by the unitless numerical value (>0) or the named length. The numerical value is in unit of em.
thickLine 2/18 Specifies the thickness of linethickness="thick", mslinethickness="thick" by the unitless numerical value (>0) or the named length. The numerical value is in unit of em.
fracLineExtend 1/18 Specifies the extended amount of a fraction line to the right and left with <mfrac> by the unitless numerical value (≥0) or the named length. The numerical value is in unit of em.
fracLineSpace 1/18 Specifies the right and left spaces of a fraction line with <mfrac> by the unitless numerical value (≥0) or the named length. The numerical value is in unit of em.
overLineOffset 1/18 Specifies the overline offset of a fraction line with <mfrac> by the unitless numerical value (≥0) or the named length. The numerical value is in unit of em.
underLineOffset 1/18 Specifies the underline offset of a fraction line with <mfrac> by the unitless numerical value (≥0) or the named length. The numerical value is in unit of em.
bevelledAngle 70 Specifies the angle of a bevelled fraction line by the unitless numerical value (≥10, <90). The value is in unit of degree. It would be better not to specify too small value.
bevelledHeight 1.5 Specifies the height of a bevelled fraction line by the unitless numerical value (>0). The value is the multiplier against the higher one of a numerator or a denominator.
rootPosition1x -0.6 Specifies the shape of a root symbol by the unitless numerical value. The numerical value is in unit of em.
rootPosition1y 0.4
rootPosition2x -0.5
rootPosition2y 0.5
rootPosition3x -0.3
rootPosition3y 0.05
rootPosition4x 0
rootPosition4y 20/18
rootThickness1 0.5/18
rootThickness2 1.5/18
rootThickness3 1/18
rootThickness4 1/18
encloseLineThickness 1/18 Specifies the thickness of the line drawn by <menclose> by the unitless numerical value (>0) or the named length. The numerical value is in unit of em.
encloseCircle inscribed Specifies whether a circle drawn with <menclose notation="circle"> is circumscribed or inscribed against the boundary rectangle. When inscribed is specified, the circle is inscribed. When circumscribed is specified, the circle is circumscribed. The circumscribed circle is a similar figure to the inscribed circle. V6.3
roundedboxRadius 0.25 Specifies the rounded box radius when <menclose notation="roundedbox"> is specified, by the unitless numerical value (>0) or the named length. The numerical value is in unit of em.
columnspacing 0.4em In the MathML specification, the default value of columnspacing is predefined, but it can be specified and changed with a numeric value with a unit. Please note that only a numeric value can be specified. (Note: The default value predefined in the MathML specification is 0.8em but the default value of AH Formatter has been changed.) V6.3MR1
rowspacing 1.0ex In the MathML specification, the default value of rowspacing is predefined, but it can be specified and changed with a numeric value with a unit. Please note that only a numeric value can be specified. V6.3MR1
framespacing 0.2em 0.5ex 0em In the MathML specification, the default value of framespacing is predefined, but it can be specified and changed with a numeric value with a unit. The first two values are predefined in the MathML specification, showing the spacing of left/right and top/bottom where frame="none" is not specified. The third value is the extension, showing the spacing of left/right where frame="none" is specified. (Note: The default values predefined in the MathML specification are 0.4em 0.5ex, but the default values of AH Formatter have been changed.) V6.3MR1
columnlineThickness 1/18 Specifies the thickness of the ruled line of a column with <mtable> by the unitless numerical value (>0) or the named length. The numerical value is in unit of em.
rowlineThickness 1/18 Specifies the thickness of the ruled line of a row with <mtable> by the unitless numerical value (>0) or the named length. The numerical value is in unit of em.
framelineThickness 1/18 Specifies the thickness of the ruled line of a frame with <mtable> by the unitless numerical value (>0) or the named length. The numerical value is in unit of em.
charspacingTight 0 Specifies the space when <mstack charspacing="tight"> is specified, by the unitless numerical value (≥0) or the named length. The numerical value is in unit of em.
charspacingMedium 0.2 Specifies the space when <mstack charspacing="medium"> is specified, by the unitless numerical value (≥0) or the named length. The numerical value is in unit of em.
charspacingLoose 0.4 Specifies the space when <mstack charspacing="loose"> is specified, by the unitless numerical value (≥0) or the named length. The numerical value is in unit of em.
crossoutThickness 1/18 Specifies the line thickness of <mscarry crossout> by the unitless numerical value (≥0) or the named length. The numerical value is in unit of em.
errorColor red Specifies the color with <merror>.
errorBackground transparent Specifies the background color with <merror>.
escapingMs \ Specifies the escape character with <ms>. If empty is specified, the escape processing will not be performed.
italicizeMi U+0041-005A,
U+0061-007A,
U+00C0-01BF,
U+01C4-02AF,
U+0386-0481,
U+048A-052F,
U+1E00-1FBC,
U+1FC2-1FCC,
U+1FD0-1FDC,
U+1FE0-1FEC,
U+1FF0-1FFC,
U+2C60-2C7F
Specifies the range of Unicode of the character which is made italic with <mi>. See also font-config to learn more about the format. In MathML specifications, it is written only that single character is made italic with <mi>. However neither numbers nor ∞ are made italic by lots of implementations. The default value contains only the character of Latn, Grek, and Cyrl.
substKeyboardCharacters true Specifies whether to enable the character substitutions defined in 7.7.1 Keyboard Characters in the MathML specification. See also Character Substitutions. V6.3
pseudoScripts true Specifies whether to make MathML specifications 7.7.2 Pseudo-scripts processing effective. If true is specified, when all the character strings of superscripts, such as <msup> etc., are seudo superscripts, a script level will not be changed and a baseline will not be changed, either. The same is applied to subscripts, such as <msub>, etc. V6.2MR4
<variant-font> child of <mathml-settings> Specifies the font corresponding to mathvariant. Any number of this element can be specified. ☞ See also Fonts for Math Expression.
mathvariant Either of the following can be specified. Specifying empty string would be the standard font used by MathML.
  • empty string
  • normal
  • bold
  • italic
  • bold-italic
  • double-struck
  • bold-fraktur
  • script
  • bold-script
  • fraktur
  • sans-serif
  • bold-sans-serif
  • sans-serif-italic
  • sans-serif-bold-italic
  • monospace
fontfamily Specifies the font to be used. The default value of mathvariant="" is "STIX, STIXGeneral, 'Cambria Math'" in Windows version, "STIX, STIXGeneral" in non-Windows versions. In any cases other than mathvariant="", mathvariant="" font is the default value.
center-shift 0 The center position of a character can be adjusted. When the minus etc. are remarkably shifted from the center, the position can be specified by the unitless numerical value. The numerical value is in unit of em. ☞ See also Fonts for Math Expression.
<font-entry> child of <variant-font> Specifies the font that corresponds to the script or Unicoderange. This setting can change a part of fonts specified by <variant-font fontfamily>. Any number of this element can be specified. The following shows the example.
<variant-font mathvariant="normal" fontfamily="Cambria Math">
 <font-entry script="Latn" fontfamily="Times New Roman"/>
</variant-font>
Either script or unicode-range needs to be specified. The effect is not guaranteed when both are specified.
fontfamily Specifies the font to use.
script Specifies the scripts, such as Latn or Grek. The available scripts conforms to ISO 15924.
unicode-range Specifies the range of Unicode to apply. See also font-config to learn more about the format.
mathvariant Some fonts behave as regular fonts even if they are designed as italic. In such fonts, if mathvariant="italic" is specified, they will be slanted doubly. To avoid this, specify mathvariant="normal". ☞ See also Fonts for Math Expression.
center-shift The center position of a character can be adjusted. When the minus etc. are remarkably shifted from the center, the position can be specified by the unitless numerical value. The numerical value is in unit of em. ☞ See also Fonts for Math Expression.
<operator-dictionary> child of <mathml-settings> <operator-dictionary> is specified in order to change the contents of the default operator dictionary. Any number of this element can be specified and is evaluated in order. See also MathML Conformance to learn more about the operator dictionary.
src URI of the operator dictionary can be specified as src. If you setup a relative path, this setting file is being considered as the relative. The content is XML of the same content as this element whose root is <operator-dictionary>. However, src cannot be specified.
<entry> child of <operator-dictionary> Any number of this element can be specified and is evaluated in order. If the setting is the same, latter one will take precedence. The default value is the one when the new unregistered operator is specified. When the operator is already registered, omitted attribute values will not be changed. <entry> is disregarded when <operator-dictionary src> is specified.
operator Specifies the operator. This setting is indispensable.
form Specifies either of the following: This setting is indispensable.
  • prefix
  • infix
  • postfix
priority 0 Specifies the integer value.
lspace 5 Specifies the value from 0 to 7. Values have the following meanings.
0.Adds no spaces.
1.Adds the space of veryverythinmathspace.
2.Adds the space of verythinmathspace.
3.Adds the space of thinmathspace.
4.Adds the space of mediummathspace.
5.Adds the space of thickmathspace.
6.Adds the space of verythickmathspace.
7.Adds the space of veryverythickmathspace.
rspace 5
minsize Specifies the relative value with units or the absolute value, such as em. The relative value is changed into the absolute value when it is used. When there is no settings, it depends on the setting of <mo>.
maxsize
accent false Specifies either true or false.
fence false Specifies either true or false.
separator false Specifies either true or false.
stretchy false Specifies either true or false.
symmetric false Specifies either true or false.
largeop false Specifies either true or false.
movablelimits false Specifies either true or false.
linebreakstyle before Specifies either of the following:
  • before
  • after
  • duplicate

The named length is either of the following. negative* is a negative length. negative* cannot be used in the scene where a positive value is calculated.

Fonts for Math Expression

In order to format the math expression finely, it is necessary to prepare the font for math expression. Some fonts for math expression are introduced here.

STIX Fonts

AH Formatter V6.3 assumes the STIX fonts are used by default. STIX fonts are downloadable from the following:

When using STIX fonts, it is not necessary to specify something to the Option Setting File in particular. However when using other fonts, it is necessary to do a proper setting with <variant-font>.

Cambria Math Fonts

Fonts for Math expression called Cambria Math are enclosed in Windows. In AH Formatter V6.3 Windows version, when STIX fonts are not installed, these fonts are the default. In order to invalidate STIX fonts and always use these fonts, specify as follows;

<variant-font fontfamily="Cambria Math"/>

BaKoMa Fonts

BaKoMa fonts are often used with TeX. BaKoMa fonts are downloadable from the following: It is recommended to use ttf or otf from here.

Since these fonts are old, there is no relevance as the font family respectively. If you use all of them, a lot of settings would be required. The following shows an example of changing x y z in STIX fonts in italic into the round shape letter peculiar to the math expression.

<variant-font mathvariant="italic">
 <font-entry unicode-range="U+0061-007A" fontfamily="cmmi10" mathvariant="normal"/>
</variant-font>
<variant-font mathvariant="bold-italic">
 <font-entry unicode-range="U+0061-007A" fontfamily="cmmib10" mathvariant="normal"/>
</variant-font>

Even if BaKoMa fonts are designed to be italic, the information which shows it does not exist in the font. Therefore, the setting of mathvariant="normal" is needed so that the text is not slanted doubly. The same applies to bold.

MathType Fonts

MathType fonts have the family name of Euclid. MathType fonts are downloadable from the following:

MathType fonts also have x y z with round shape letter. These fonts are old and designed to be lowered totally. Therefore, the center position is not equal to the position of a minus symbol. When using these fonts, it is necessary to adjust it. In addition, it is necessary to replace symbols, such as minus, with other fonts called Euclid Symbol. The following shows a recommended example:

<variant-font fontfamily="Euclid, Euclid Symbol" center-shift="0.1">
 <font-entry unicode-range="U+0028-002F,U+003A-003F,U+005F,U+2212" fontfamily="Euclid Symbol"/>
</variant-font>
<variant-font mathvariant="script" center-shift="0.1">
 <font-entry unicode-range="U+0030-0039,U+0041-005A" fontfamily="Euclid Math One"/>
</variant-font>
<variant-font mathvariant="double-struck" center-shift="0.1">
 <font-entry unicode-range="U+0041-005A,U+006B" fontfamily="Euclid Math Two"/>
</variant-font>
<variant-font mathvariant="fraktur" fontfamily="Euclid Fraktur" center-shift="0.1"/>

XSLT Settings

These settings are used for XSLT Processor.

Element Location Attribute Default Description
<xslt-settings> child of <formatter-config> msxml true Specifies whether to use MSXML or not. If true is specified, MSXML is used as an XSLT Processor. Specification of command is disregarded at this time. If false is specified, the external XSLT Processor specified from command will be used, but when nothing is specified from command, it is considered that true is specified and MSXML is used. The version of MSXML actually used can be checked on the XSLT page of the Format Option Setting Dialog. This setting is ignored in non-Windows environment.
msxmlver 0 Specifies the maximum version of MSXML used internally when msxml="true" is specified. Any version from 6 to 3 can be specified. For example, when 5 is specified, AH Formatter searches MSXML in order of MSXML5 → MSXML4 → MSXML3 and adopts the first found MSXML. If nothing is specified or the specified value is incorrect (such as 0), the version will be regarded as 6. This setting is effective only with Windows version. V6.3
command The command line of the External XSLT Processor is specified here. The command line strings must include at least three identifiers, %1, %2 and %3.
  • %1 : XML document
  • %2 : XSL stylesheet
  • %3 : XSLT Output File
  • %param : Parameter of xsl:param
If nothing is specified, or "@MSXML" is specified, the external processor is not used but the internal processor, MSXML is used. This setting is effective only with Windows version. It's an initial setting of XSLT Processor with all kinds of interfaces. If nothing is specified in non-Windows environment, XSLT transformation is not performed.
param-option Specifies the parameter type of xsl:param given to the external XSLT Processor. The strings must include at least two identifiers, %p and %v. These values are as follows:
  • %p : Value of <param name>
  • %v : Value of <param value>
These values affect the part of %param in the command line strings. When two or more <param>s are specified, they are divided by the white space and repeated.
<param> child of <xslt-settings> name Specifies the parameter name of xsl:param for XSLT Processor.
value Specifies the parameter value of xsl:param for XSLT Processor. When the value includes a white space, please explicitly enclose in quotation marks.
<stylesheet> child of <xslt-settings> ns Possible to specify the stylesheet applied to a specific XML document. Specifies the name space of the XML document by ns, and specifies the URI of the stylesheet by href. The following shows the example of XHTML and WordML.
<stylesheet ns="http://www.w3.org/1999/xhtml" href="xhtml2fo.xsl"/>
<stylesheet ns="http://schemas.microsoft.com/office/word/2003/wordml" href="[WordMLToFO install directory]/WordMLToFO.xsl"/>
If the XML document has the name space specified here, it can be formatted by itself, without specifying the stylesheet. If the stylesheet is specified when formatting or the stylesheet is specified in the XML document, these are adopted and the setting here will be ignored.
href
<msxml> child of <xslt-settings> name Specifies the property of MSXML when msxml="true" is specified. The property name is specified by name and the value is specified by value. For the moment, only true or false can be specified as value. That is, the property which needs the other value cannot be specified. There are two types of properties available.
  • Properties specified by the setProperty() method like, setProperty("AllowXsltScript", true);.
  • Properties specified by the value directly like, resolveExternals = true;.
name interpreted as the latter one are as follows;
  • preserveWhiteSpace
  • validateOnParse
  • resolveExternals
In any case other than these, the value is set via the setProperty() method. The character string of name is not checked. It is considered that the following are set as default.
<msxml name="preserveWhiteSpace" value="true"/>
<msxml name="validateOnParse" value="false"/>
<msxml name="resolveExternals" value="true"/>
<msxml name="ServerHTTPRequest" value="true"/>
<msxml name="ProhibitDTD" value="false"/>
<msxml name="AllowDocumentFunction" value="true"/>
<msxml name="AllowXsltScript" value="false"/>
See also MSXML Security Overview. The settings are ignored with non-Windows versions.
value

Suppose XSLT setting is as follows:

<xslt-settings command="xslt -o &#34;%3&#34; &#34;%1&#34; &#34;%2&#34; %param" param-option="%p=%v">
  <param name="foo" value="123"/>
  <param name="bar" value="&#34;Hello, World&#34;"/>
</xslt-settings>

XSLT Processor executes as follows in order to transform file.xml and file.xsl into file.fo.

xslt -o "file.fo" "file.xml" "file.xsl" foo=123 bar="Hello, World"

As described in the example here, the actual file name given to %1 or %2 includes white space, it's necessary to enclose the file name with quotation mark, &#34;.

Example for Option Setting File

<?xml version="1.0"?>
<formatter-config>
  <formatter-settings
      default-page-width="210mm"
      default-page-height="297mm"
      default-font-size="10pt"
      normal-line-height="1.2"
      default-color="#000000"
      border-thin-width="1pt"
      border-medium-width="3pt"
      border-thick-width="5pt"
      pxpi="96"
      default-lang=""
      default-CJK="ja"
      punctuation-trim="true"
      text-autospace="true"
      vertical-underline-side="auto"
      punctuation-spacing="0.5"
      text-autospace-width="0.25"/>
  <pdf-settings
      embed-all-fonts="false"
      error-on-embed-fault="false"
      user-password=""
      master-password=""
      no-printing="false"
      no-changing="false"
      no-content-copying="false"
      no-adding-or-changing-comments="false"
      color-compression="auto"
      color-jpeg-quality="80"
      text-and-lineart-compression="true"
      use-launch-for-local-file="true"
      rasterize-resolution="108">
    <embed-font font="Arial"/>
    <embed-font font="Courier New"/>
  </pdf-settings>
  <font-settings default-font-family="serif">
    <script-font
      serif="Times New Roman"
      sans-serif="Arial"
      monospace="Courier New"
      cursive="Times New Roman"
      fantasy="Times New Roman"/>
    <script-font
      script="Jpan"
      serif="IPAMincho"
      sans-serif="IPAGothic"
      monospace="IPAMincho"/>
    <script-font
      script="Hang"
      serif="Batang"
      sans-serif="Gulim"
      monospace="BatangChe"/>
    <script-font
      script="Hans"
      serif="SimSun"
      sans-serif="SimHei"
      monospace="SimSun"/>
    <script-font
      script="Hant"
      serif="MingLiU"
      sans-serif="MingLiU"
      monospace="MingLiU"/>
    <font-alias src="MS Mincho" dst="IPAMincho"/>
    <font-alias src="MS Gothic" dst="IPAGothic"/>
  </font-settings>
  <xslt-settings command="xslt -o &#34;%3&#34; &#34;%1&#34; &#34;%2&#34; %param"
                 param-option="%p=%v">
    <param name="foo" value="123"/>
    <param name="bar" value="XYZ"/>
  </xslt-settings>
</formatter-config>