Option Setting File
The Option Setting File is an XML file which describes the operating setup for Antenna House Formatter V7.4. 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(x86).xml for Windows x86 version) exists in the application-specific data directory. The application data directory is indicated by the environment variable APPDATA, it is [APPDATA]\AntennaHouse\Formatter\7.4\.
When the content of the Option Setting File is corrected with the editor, etc. while Antenna House Formatter V7.4 is running, the correction is not reflected to Antenna House Formatter V7.4. Exit Antenna House Formatter V7.4 once or load the Option Setting File from the [Format]-[Import Option Setting Dialog] menu in GUI.
The following are the elements of the Option Setting File:
Element | Location | Description |
---|---|---|
<formatter-config> | root element |
You can specify
http://www.antennahouse.com/names/XSL/Settings for the namespace. If omitted, this namespace is considered. |
<formatter-settings> | child of <formatter-config> | The element of Formatter Settings. |
<font-settings> | child of <formatter-config> | The element of Font Settings. |
<script-font> | child of <font-settings> | The element of generic font settings for each script. |
<font-alias> | child of <font-settings> | The element of font alias settings. |
<pdf-settings> | child of <formatter-config> | The element of PDF Output Settings. |
<embed-font> | child of <pdf-settings> | The element of embedding font settings. |
<ps-settings> | child of <formatter-config> | The element of PostScript Output Settings. |
<svg-render-settings> | child of <formatter-config> | The element of SVG Rendering Settings. |
<svg-settings> | child of <formatter-config> | The element of SVG Output Settings. |
<text-settings> | child of <formatter-config> | The element of TEXT Output Settings. no-LT |
<mathml-settings> | child of <formatter-config> | The element of MathML Settings. |
<cgm-settings> | child of <formatter-config> | The element of CGM Settings. |
<xslt-settings> | child of <formatter-config> | The element of XSLT Settings. |
<param> | child of <xslt-settings> | The element of xsl:param settings. |
<stylesheet> | child of <xslt-settings> | The element of default stylesheet settings. |
<analyzer-settings> | child of <formatter-config> | The element of Analyzer Settings. no-LT |
Antenna House Formatter V7.4 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. 1mm = 0.1cm |
in | inch. 1in = 2.54cm |
pt | point. 1pt = 1in/72 |
pc | pica. 1pc = 12pt |
jpt | 1jpt = 0.3514mm |
q | 1q = 0.25mm |
Formatter Settings
These settings are used for the formatting.
Element | Attribute | Default | Description | |||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
<formatter-settings> | child of <formatter-config> | |||||||||||||||||||||||||||||||||||||
abbreviation-character-count | 3 | Specify the number of characters considered 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 space characters are disregarded even though they are specified. See also axf:append-non-starter-characters in extended FO. | |||||||||||||||||||||||||||||||||||||
apply-default-html-css-to-XML | true | Specifies whether to apply the Default CSS for HTML (html.css) even for XML+CSS.
html.css is made for (X)HTML. In other words, XHTML targets elements whose namespace is http://www.w3.org/1999/xhtml, so it is not applied to any other XML. However, pseudo-elements do not belong to any namespace, so they are applied to XML other than XHTML. If false is specified, html.css will not be applied to XML other than XHTML. | ||||||||||||||||||||||||||||||||||||
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:
| ||||||||||||||||||||||||||||||||||||
avoid-orphan-single-word | pol, hun, ces | Polish, Hungarian, Czech, etc. are not allowed to have single-letter words at the end of the line. Specify such languages separated by commas. You can cancel the process by specifying an empty string or false.
| ||||||||||||||||||||||||||||||||||||
avoid-widow-words-cjk-punctuation | false | Specifies the initial value when axf:avoid-widow-words-cjk-punctuation="auto" is specified. You can specify false, true, or any string. | ||||||||||||||||||||||||||||||||||||
axf-formatter-config | true | Specifies whether the use of <axf:formatter-config> in FO is permitted by a value of true or false. When false is specified, <axf:formatter-config> will be ignored. The setting of axf-formatter-config within <axf:formatter-config> will be ignored. no-LT | ||||||||||||||||||||||||||||||||||||
baseline-mode | 6 | In Antenna House 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.
| ||||||||||||||||||||||||||||||||||||
bold-ratio | 1.0 | Specifies how thick a font should be displayed when bold is specified for fonts that do not have 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 rendered 1.5 times thicker. When 0.0 or less is specified, it is considered 1.0 thick.
This setting is effective with PDF Output and Post | ||||||||||||||||||||||||||||||||||||
border-medium-width * | 3pt | Specifies the default border width in medium style with the real type numerical value. | ||||||||||||||||||||||||||||||||||||
border-thick-width * | 5pt | Specifies the default border width in thick style with the real type numerical value. | ||||||||||||||||||||||||||||||||||||
border-thin-width * | 1pt | Specifies the default border width in thin style with the real type numerical value. | ||||||||||||||||||||||||||||||||||||
boxshadow-resolution-dpi | 108 | Specifies the resolution of the image when setting the blurring in box-shadow with the unit of dpi. Values from 70 to 1440 are effective. If it is out of range, the default value is adopted. V7.4 no-LT | ||||||||||||||||||||||||||||||||||||
bpil | Latn, Grek, Cyrl, Armn, Geor | Specifies a language or script to apply Knuth-Plass Breaking Paragraphs into Lines [BPIL] to the line breaking algorithm by separating each code with a comma. The following can be specified. When empty, it does not apply to any language.
See also Line Breaking. | ||||||||||||||||||||||||||||||||||||
bpil-limit-chars | 50000 | Specifies the maximum number of characters to which [BPIL] applies. Approximately more than this number of blocks will not apply [BPIL]. The value less than 1000 cannot be specified. | ||||||||||||||||||||||||||||||||||||
bpil-minimum-line-width | 8 | Specifies the minimum line width to apply [BPIL] in units of em. The value less than 1 is considered 1. | ||||||||||||||||||||||||||||||||||||
bpil-penalty-hyphenation | 100 | Specifies the frequency of hyphenation in [BPIL] with a value of 0 to 1000. Hyphenation is more likely to occur with smaller values. | ||||||||||||||||||||||||||||||||||||
condensed-text-align-last | justify | Specifies the initial value when axf:condensed-text-align-last="auto" is specified. You can specify false, true or justify. | ||||||||||||||||||||||||||||||||||||
css-allow-bare-expression | false | In CSS, a description like the following is a grammar violation:
| ||||||||||||||||||||||||||||||||||||
css-child-match-root | false | Up to CSS3, pseudo-classes, such as :first-child or :only-of-type will not match the root element, but in CSS4, it will. If true is specified, it will match the root element. | ||||||||||||||||||||||||||||||||||||
css-debug | false | Specify true to enable the CSS debugging feature in GUI. ☞ CSS Debug Tree V7.4 no-LT | ||||||||||||||||||||||||||||||||||||
css-float-in-float | true | fo:float inside fo:float is prohibited in FO, but there is no such restriction in CSS. If false is specified, nested float properties in CSS will be ignored. | ||||||||||||||||||||||||||||||||||||
css-media-type | Antenna House Formatter V7.4 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". all or ah-formatter @media values are always evaluated regardless of this setting. Otherwise, only the specified ones will 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 considered when the operating environment is other than CJK. In GUI, the setting can be changed by Default CJK Language. | |||||||||||||||||||||||||||||||||||||
default-color | #000000 | Specifies the default color of text with the format of #RRGGBB. You can also specify the color name, rgb() or rgb-icc(). However, RGB cannot be omitted with rgb-icc(). ☞ Default Color | ||||||||||||||||||||||||||||||||||||
default-font-size * | 10pt | Specifies the default font size with the real type numerical value. | ||||||||||||||||||||||||||||||||||||
default-from-page-master-region | false |
In XSL 1.1, there is no compatibility with XSL 1.0 in the method of evaluating writing-mode or reference-orientation. If true is specified, it becomes the same operation as the following are specified for fo:page-sequence.
| ||||||||||||||||||||||||||||||||||||
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 encoding of <text-settings>. 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 numerical value. | ||||||||||||||||||||||||||||||||||||
default-page-margin-bottom * | 10% | Specifies a default page margin with the real type numerical value. A percent value is considered 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 numerical value. | ||||||||||||||||||||||||||||||||||||
descendant-or-self-files | false | When true is specified, the location of the external files that can be read is restricted to be within the same directory as the FO or HTML, or within a subdirectory of it. It isn't restricted by http: or https:. If disable-network is specified, all network access such as http: or https: are also restricted in addition to it. no-LT | ||||||||||||||||||||||||||||||||||||
display-alttext | false | Specifies whether to display an alternate text by axf:alttext or the alt attribute when there is no image in <fo:external-graphic> or HTML <img>. When true is specified, an alternate text is displayed. When false is specified and the src attribute is specified, an alternate image is displayed. no-LT | ||||||||||||||||||||||||||||||||||||
double-hyphen-translineation | por | In Portuguese hyphenation, a hyphen is also placed at the start of the line when a line break occurs at a hyphen. With double-hyphen-translineation, specify comma-separated languages for such hyphenation. If you specify empty or false, you can cancel the process of placing a hyphen at the start of the line as well. it is invalid when hyphenate="false" is specified. ☞ axf:double-hyphen-translineation V7.4 | ||||||||||||||||||||||||||||||||||||
error-if-overflow | false | Specifies whether to perform the same check as error-if-overflow and report an overflow error when overflow="auto" is specified. no-LT | ||||||||||||||||||||||||||||||||||||
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. | |||||||||||||||||||||||||||||||||||||
external-entity | true | Specifies whether the external reference is allowed or not with <!ENTITY> of XML (FO, XHTML, SVG, MathML etc.) to be formatted. Note that it does not work on external XSLT processor called from Antenna House Formatter V7.4. See also XSLT Settings. | ||||||||||||||||||||||||||||||||||||
family-name-syntax | auto | Specify whether to strictly check the syntax of the value of font-family. When strict is specified, it is evaluated exactly as Font family: the font-family property. Until Antenna House Formatter V6.5, only a pretty loose check has been done, so even it is strictly an error, it does not become an error. For example, the following setting is strictly an error:
| ||||||||||||||||||||||||||||||||||||
fix-css-img-percentage | true | Specifies how to handle the reference standard when width and height for images in CSS is specified by %. true interprets according to the specification. For details, see Changes from Antenna House Formatter V7.0. | ||||||||||||||||||||||||||||||||||||
fixed-width-space-treatment | true |
Fonts seldom contain glyphs for characters, such as EM SPACE (U+2003) etc., that represent white space with fixed width. At that time, a substitution glyph is displayed and the white space is not shown correctly. fixed-width-space-treatment specifies the treatment of a fixed white space.
| ||||||||||||||||||||||||||||||||||||
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. | ||||||||||||||||||||||||||||||||||||
href-page-link | false | Unlike FO, HTML has id value that is not NCName, so id like "123" is allowed. Therefore, when <a href="#123"> is specified, the id "123" is the target. When href-page-link="true" is specified, it will be considered a page number and easily move to the specified page in HTML. | ||||||||||||||||||||||||||||||||||||
hyphen-min | false | Specifies whether to enable <hyphen-min> in the Hyphenation Exception Dictionary.
| ||||||||||||||||||||||||||||||||||||
hyphenation-keep-mode | word | Specifies the processing method when the word at the end of the page (column) is hyphenated by hyphenation-keep="page", etc. word pushes out the word to the next page (column). line pushes out that line to the next page (column). You need to be careful when you use word. See Hyphenation. However, in <fo:float> where the value of axf:float-x is other than none and the value of axf:float-y is none, it is always considered line. | ||||||||||||||||||||||||||||||||||||
hyphenation-TeX | When HyphenationOption="true" is specified, enumerates a comma-delimited list of languages that you want to hyphenate using a Te | |||||||||||||||||||||||||||||||||||||
Hyphenation | true |
Specifies whether to hyphenate words by using the custom processing that supports over 40 languages or to use Te | ||||||||||||||||||||||||||||||||||||
ignore-certificate-error | false | Ignores incorrect certificate errors, such as self-signed certificate, in https:. For safety, it is not recommended to set it to true. | ||||||||||||||||||||||||||||||||||||
intrusion-displace-mode | 6 | In Antenna House Formatter V6, there are some changes from Antenna House Formatter V5 in the behavior of the intrusion-displace property. Specify when you want to make it the same as 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. | ||||||||||||||||||||||||||||||||||||
jamo-ligature | true | Specifies whether to process the ligature of Hangul Jamo (U+1100 to U+11FF) with the value of true or false. If true is specified, processes the ligature of Hangul Jamo. If false, does nothing. This setting affects the value of the extension property axf:ligature-mode="auto". This ligature uses jamo of GSUB feature in the OpenType font. no-LT | ||||||||||||||||||||||||||||||||||||
justify-leader | false | Although the leader functions in the justified line, the leader itself is not justified. leader-alignment="none" specifies whether the leader 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. | ||||||||||||||||||||||||||||||||||||
justify-rowspan-height | false | When there is a cell with rowspan and the height of the cell is high, specifies whether the height of each row occupied by the cell should be as even as possible. When there is a row or cell with height specified, or when there is a cell whose text direction is rotating, it is processed so that only the height of the row after that row is even. no-LT | ||||||||||||||||||||||||||||||||||||
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 Changes from Antenna House Formatter V6.2. | ||||||||||||||||||||||||||||||||||||
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". | ||||||||||||||||||||||||||||||||||||
no-disp-warnings | Suppress Error Messages that are output on GUI or Command-line. Specifies by enumerating the error code in decimal or hexadecimal as no-disp-warnings="10754 0x320D". No error message corresponding to the specified error code is output. Also, if specified as no-disp-warnings="*1", all error messages with error level 1 will not be output. V7.4MR8 It is invalid for errors where the processing is interrupted. no-LT | |||||||||||||||||||||||||||||||||||||
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. | ||||||||||||||||||||||||||||||||||||
normal-line-height | 1.2 | Specifies the default line height with the real type numerical 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 (case insensitive) can be specified:
no-LT
| ||||||||||||||||||||||||||||||||||||
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 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 with the following outputs: | ||||||||||||||||||||||||||||||||||||
osdc-cmd | When OSDC is specified for axf:image-preproc, you can specify the Command-line to be adopted with the full path. For example, specify osdc-cmd="/usr/OfficeServerDocumentConverterV90/bin/SBCCmd". This makes it possible to run Office Server Document Converter even if PATH is not added to Office Server Document Converter. Specify SBCCmd.exe for Windows versions. V7.4 | |||||||||||||||||||||||||||||||||||||
osdc-param |
When OSDC is specified for axf:image-preproc,
you can specify parameters when running the Command-line of Office Server Document Converter. Enter a space character between the parameter name and its value. If parameters with the same name are specified, the one specified later is valid. The combination of parameter name and value is equivalent to OSDC[params] of axf:image-preproc. Also, if there are parameters with the same name specified by axf:image-preproc="OSDC [params]", the parameters specified by axf:image-preproc will take precedence. An example of setting is as follows:
| |||||||||||||||||||||||||||||||||||||
overflow-limit-block ** | 0pt | Specifies the default value of axf:overflow-limit-block. | ||||||||||||||||||||||||||||||||||||
overflow-limit-inline ** | 0pt | Specifies the default value of axf:overflow-limit-inline. | ||||||||||||||||||||||||||||||||||||
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 | ||||||||||||||||||||||||||||||||||||
Printer | 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):
| ||||||||||||||||||||||||||||||||||||
Pscript | 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 versions. | ||||||||||||||||||||||||||||||||||||
pair-kerning | true | Specifies whether to process the pair kerning 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: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 (punctuation marks and brackets) are used in succession or come at the start of the 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 numerical value. | ||||||||||||||||||||||||||||||||||||
ruby-align | Specifies the arrangement when axf:ruby-align="auto" is specified. When nothing or auto is specified, it is considered space-around center. | |||||||||||||||||||||||||||||||||||||
Separate | true | Specifies whether to separate the print job when there is a switch between Duplex Printing / Simplex Printing by axf:printer-duplex. When true is specified, the job is output separately. When false is specified, it is output as one job. | ||||||||||||||||||||||||||||||||||||
small-caps-emulation-always | false | Specifies whether to always emulate small-caps. When true is specified, it always emulates and does not use the font information. | ||||||||||||||||||||||||||||||||||||
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. | ||||||||||||||||||||||||||||||||||||
small-caps-emulation-x-height | true | If the font has x-height and cap-height, the emulation magnification of small-caps is x-height/cap-height. If the font does not have them, it will be small-caps-emulation-size. | ||||||||||||||||||||||||||||||||||||
splitting-blocks-space | false | In CSS, when breaking a block with the height of auto, specifies whether to adjust the height of the block in the previous page (column) to the height of the page (column), or leave it as blank. When true is specified, it's left as blank, which is contrary to the CSS specification. See also Splitting blocks. | ||||||||||||||||||||||||||||||||||||
tab-overlap-treatment | ignore-tab | Specifies a behavior when tab alignment makes letters overlapped, by selecting from either ignore-tab or next-tab. See axf:tab-overlap-treatment. 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. For more details, see Table Auto Layout. | ||||||||||||||||||||||||||||||||||||
table-is-reference-area | false | In XSL 1.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 XSL 1.0. For more details, see Incompatibility of fo:table. | ||||||||||||||||||||||||||||||||||||
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-mode | 7 |
When the setting of axf:text-autospace is different before and after <fo:inline> as follows:
| ||||||||||||||||||||||||||||||||||||
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.
| ||||||||||||||||||||||||||||||||||||
text-justify-mode | 5 | In Antenna House Formatter V5 or later, there are some changes from XSL Formatter V4 in trimming a line. 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:
| ||||||||||||||||||||||||||||||||||||
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 UAX#50: Unicode Vertical Text Layout is taken into consideration by the value of axf:text-orientation when rendering alphanumeric characters, etc. to be upright in vertical writing mode with the following values:
no-LT
| ||||||||||||||||||||||||||||||||||||
text-replace-Dutch-IJ | true | Replaces the following text in Dutch:
| ||||||||||||||||||||||||||||||||||||
textshadow-resolution-minimum-dpi | 108 | Specifies the minimum value of the resolution of the image when setting the blur in text-shadow with the unit of dpi. Integer values from 70 to 1440 are effective. If it is out of range, the default value is adopted. | ||||||||||||||||||||||||||||||||||||
textshadow-resolution-pixel-per-em | 100 | Specifies the resolution of the image when setting the blur in text-shadow. If the back-calculated dpi is smaller than textshadow-resolution-minimum-dpi, the value of textshadow-resolution-minimum-dpi is adopted. If it is larger than 1440, 1440 is adopted. | ||||||||||||||||||||||||||||||||||||
textshadow-blur-cannot-embed-font | false | Selects whether to set the blur against fonts that are not allowed to be embedded with the value of true or false in text-shadow. If true is specified, sets the blur. | ||||||||||||||||||||||||||||||||||||
text-underline-mode | 6 | Some improved changes have been added for the position of underline and overline with Antenna House Formatter V6. Specify when you want to make it the same as 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. | ||||||||||||||||||||||||||||||||||||
unicode-bidi-rev | Specifies the revision of UAX#9: Unicode Bidirectional Algorithm that Antenna House Formatter V7.4 conforms to. A value greater than or equal to 37 is considered 41. If the value is less than 37, it follows the algorithm compatible with V6.6 (about revision 27). At that time, the following control characters cannot be handled correctly.
U+2066 is considered U+202D, U+2067 is considered U+202E and U+2069 is considered U+202C for each. If no value is set, the latest revision supported by Antenna House Formatter V7.4 is used. See also BIDI Algorithm Implementation Restrictions for implementation restrictions when not V6.6 compatible.
| |||||||||||||||||||||||||||||||||||||
unresolved-internal-destination | 1 |
Specifies the error level for unresolved internal-destination.
| ||||||||||||||||||||||||||||||||||||
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 Antenna House Formatter V6. Specify when you want to make it the same as 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 (jpn) or Korean (kor). If there is no language properties specified, it depends on the default-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.
| ||||||||||||||||||||||||||||||||||||
watermark-fill-color | rgb-icc(#Registration,0.02) | Specifies the fill color of the string specified by watermark-text. This attribute is invalid with the evaluation version. no-LT | ||||||||||||||||||||||||||||||||||||
watermark-font-family | sans-serif | Specifies the font family to the character string which you set to watermark-text. This attribute is invalid with the evaluation version. no-LT | ||||||||||||||||||||||||||||||||||||
watermark-font-style | normal | Specifies the font style to the character string which you set to watermark-text. Possible to specify normal or italic. This attribute is invalid with the evaluation version. no-LT | ||||||||||||||||||||||||||||||||||||
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 1 to 1000. This attribute is invalid with the evaluation version. no-LT | ||||||||||||||||||||||||||||||||||||
watermark-opacity | 0 | Specifies the opacity of the string specified by watermark-text. This attribute is invalid with the evaluation version. no-LT | ||||||||||||||||||||||||||||||||||||
watermark-stroke-color | rgb-icc(#Registration,0.04) | Specifies the stroke color of the string specified by watermark-text. This attribute is invalid with the evaluation version. no-LT | ||||||||||||||||||||||||||||||||||||
watermark-stroke-width | 0.0125 | Specifies the width of the stroke of the string specified by watermark-text. The value is a percentage for the font size. Values greater than 0 and less than or equal to 1 are effective. If you specify a value less than or equal to 0 or more than 1, the stroke will not be rendered. This attribute is invalid with the evaluation version. no-LT | ||||||||||||||||||||||||||||||||||||
watermark-rotate | Specifies the angle of rotation of the string specified by watermark-text in degrees. The font size will be adjusted to fit on the page after rotation. If not specified, proper rotation will occur. This attribute is invalid with the evaluation version. no-LT | |||||||||||||||||||||||||||||||||||||
watermark-scale | 1 | Specifies the display magnification of the string specified by watermark-text. This is the variable magnification for the font size adjusted by watermark-rotate. This attribute is invalid with the evaluation version. no-LT | ||||||||||||||||||||||||||||||||||||
watermark-text | Displays the specified watermark text on each page. Possible to make it multiple lines by delimiting with the line feed “ ”. This setting is invalid with the evaluation version. With Antenna House Formatter V7.4 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. 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. no-LT | |||||||||||||||||||||||||||||||||||||
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. This attribute is invalid with the evaluation version. no-LT | |||||||||||||||||||||||||||||||||||||
watermark2-font-style | normal | Specifies the font style to the character string which you set to watermark2-text. Possible to specify normal or italic. This attribute is invalid with the evaluation version. no-LT | ||||||||||||||||||||||||||||||||||||
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 1 to 1000. This attribute is invalid with the evaluation version. no-LT | ||||||||||||||||||||||||||||||||||||
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. 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. no-LT | |||||||||||||||||||||||||||||||||||||
white-space-collapse-mode | 7 |
The operation of white-space-collapse was corrected with Antenna House Formatter V7. Specify as follows when you want the same operation as V6.
| ||||||||||||||||||||||||||||||||||||
xml-catalog |
Specifies the XML Catalog files. This will convert the URI for the external references in the document. However, it only supports the following URI entries:
The XML Catalogs namespace is
urn:oasis:names:tc:entity:xmlns:xml:catalog.
By specifying this file like xml-catalog=".../catalog.xml", you can specify it in FO as follows:
The XML contents are checked in the order they are written and only the first match is applied.
| |||||||||||||||||||||||||||||||||||||
zwsp-mode | 6 |
The operation of ZERO WIDTH SPACE (U+200B) was corrected with Antenna House Formatter V6. It's compatible with V6 by default.
Specify as follows when you want the same operation as V5.
| ||||||||||||||||||||||||||||||||||||
<list-style-type> | child of <formatter-settings> (This element can be specified as many times as necessary) | |||||||||||||||||||||||||||||||||||||
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". | ||||||||||||||||||||||||||||||||||||
<quotationmark> | child of <formatter-settings> (This element can be specified as many times as necessary) | |||||||||||||||||||||||||||||||||||||
language | Changes the handling of Quotation Mark. Specify the language code for language, the character code of quotation marks for code, and specify one of the QU/OP/CL for quotetype. Only Western languages can be specified for the language code. CJK etc. cannot be specified. no-LT | |||||||||||||||||||||||||||||||||||||
code | ||||||||||||||||||||||||||||||||||||||
quotetype | ||||||||||||||||||||||||||||||||||||||
<script-chars> | child of <formatter-settings> (This element can be specified as many times as necessary) | |||||||||||||||||||||||||||||||||||||
script | Evaluates all characters specified to the code as scripts specified to the script. For example, by specifying as follows:
| |||||||||||||||||||||||||||||||||||||
code | ||||||||||||||||||||||||||||||||||||||
<script-language-in-CJK> | child of <formatter-setting> (This element can be specified as many times as necessary) | |||||||||||||||||||||||||||||||||||||
script | When the script specified to the script attribute appears in the sentence of CJK languages, the character string of the script is considered the language that is specified to the language attribute. For example:
| |||||||||||||||||||||||||||||||||||||
language | ||||||||||||||||||||||||||||||||||||||
<space-end-punctuation> | child of <formatter-settings> (This element can be specified as many times as necessary) | |||||||||||||||||||||||||||||||||||||
language | For the language specified to language, the space specified by space is made after the character specified to code. If code is not being specified, the specified space will be canceled for all characters specified to language. The amount of space is specified with the real type numerical value. The value means the ratio to the font size. ☞ <axf:space-end-punctuation> | |||||||||||||||||||||||||||||||||||||
code | ||||||||||||||||||||||||||||||||||||||
space | ||||||||||||||||||||||||||||||||||||||
<space-start-punctuation> | child of <formatter-settings> (This element can be specified as many times as necessary) | |||||||||||||||||||||||||||||||||||||
language | For the language specified to language, the space specified by space is made before the character specified to code. If code is not being specified, the specified space will be canceled for all characters specified to language. The amount of space is specified with the real type numerical value. The value means the ratio to the font size. ☞ <axf:space-start-punctuation> | |||||||||||||||||||||||||||||||||||||
code | ||||||||||||||||||||||||||||||||||||||
space | ||||||||||||||||||||||||||||||||||||||
<space-between-digit-and-punctuation> | child of <formatter-settings> (This element can be specified as many times as necessary) | |||||||||||||||||||||||||||||||||||||
language | For the language specified to language, the space specified by space is made between the number and the character specified to code. If code is not being specified, the specified space will be canceled for all characters specified to language. The amount of space is specified with the real type numerical value. The value means the ratio to the font size. ☞ <axf:space-between-digit-and-punctuation> | |||||||||||||||||||||||||||||||||||||
code | ||||||||||||||||||||||||||||||||||||||
space | ||||||||||||||||||||||||||||||||||||||
<space-between-punctuation-and-digit> | child of <formatter-settings> (This element can be specified as many times as necessary) | |||||||||||||||||||||||||||||||||||||
language | For the language specified to language, the space specified by space is made between the character specified to code and the number. If code is not being specified, the specified space will be canceled for all characters specified to language. The amount of space is specified with the real type numerical value. The value means the ratio to the font size. ☞ <axf:space-between-punctuation-and-digit> | |||||||||||||||||||||||||||||||||||||
code | ||||||||||||||||||||||||||||||||||||||
space | ||||||||||||||||||||||||||||||||||||||
<usercss> | child of <formatter-settings> (This element can be specified as many times as necessary) | |||||||||||||||||||||||||||||||||||||
Specifies the CSS user stylesheet you want to add by <css>. If specified by a relative path, it is considered to be relative to the target document. See also Cascading Order of CSS. | ||||||||||||||||||||||||||||||||||||||
<css> | child of <usercss> (This element can be specified as many times as necessary) | |||||||||||||||||||||||||||||||||||||
path | Specifies the path of the CSS user stylesheet. | |||||||||||||||||||||||||||||||||||||
<multimedia> | child of <formatter-settings> (This element can be specified as many times as necessary) | |||||||||||||||||||||||||||||||||||||
audio | When specifying multimedia, such as audio or video as graphics, the setting of content-type is required. Antenna House Formatter V7.4 may sometimes not automatically recognize if a content-type other than “audio/*” or “video/*” formats indicates it is multimedia. For such content-type, specify audio, video or flash explicitly as follows:
| |||||||||||||||||||||||||||||||||||||
video | ||||||||||||||||||||||||||||||||||||||
flash | ||||||||||||||||||||||||||||||||||||||
<GS1-128> | child of <formatter-settings> (This element can be specified as many times as necessary) | |||||||||||||||||||||||||||||||||||||
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:
| |||||||||||||||||||||||||||||||||||||
format | ||||||||||||||||||||||||||||||||||||||
<UAX50> | child of <formatter-settings> (This element can be specified as many times as necessary) | |||||||||||||||||||||||||||||||||||||
code | Specifies the code point to code you change. The code point can be specified as follows:
U or R or V can be specified to SVO or MVO. It means that U renders upright, R rotates 90-degree clockwise. 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. See also text-orientation-mode. no-LT | |||||||||||||||||||||||||||||||||||||
SVO | ||||||||||||||||||||||||||||||||||||||
MVO | ||||||||||||||||||||||||||||||||||||||
<unbreakable-words> | child of <formatter-settings> (This element can be specified as many times as necessary) | |||||||||||||||||||||||||||||||||||||
List the unbreakable words by the line break. The character string of each line will become unbreakable. For example, if you write as follows, two phrases will become unbreakable:
Also, as Antenna House Formatter V7.4 tries to adopt as long a phrase as possible, if
| ||||||||||||||||||||||||||||||||||||||
src | You can specify external XML for src. That XML looks the same as this element, but src cannot be specified. no-LT |
Font Settings
These settings are used for the fonts.
Element | 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. | ||||||||||||
emulated-italic | 0 | Specifies whether to report the error when italic is emulated in the selected font. Specify one of the following:
| ||||||||||||
emulated-small-caps | 0 | Specifies whether to report the error when small-caps is emulated in the selected font. Specify one of the following:
| ||||||||||||
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:
| ||||||||||||
font-selection-mode | 6 | Specifies the selection method of fonts. The following values can be specified:
| ||||||||||||
font-stretch-mode | 6 | Specifies whether the information on font-stretch is used when selecting fonts. The following values can be specified:
| ||||||||||||
missing-font | 1 | Specifies whether to warn when a font is not found from the specified font family.
The following either can be specified:
| ||||||||||||
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:
| ||||||||||||
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. Note that careless specification could cause huge amount of error. This setting is similarly applied to fallback-glyph as well. | ||||||||||||
<script-font> | child of <font-settings> (This element can be specified as many times as necessary) See also Font Selection | |||||||||||||
script | Specifies the script codes for multilingual setting. The available scripts conform to ISO 15924. However, the Antenna House Formatter V7.4 does not support all scripts. The scripts that can be specified here are scripts that are indicated in Scripts and Languages excluding Hira, Kana, and Hani or including Zsye, Zsym. 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 when specified by the script. Two or more fonts can be enumerated by comma-separated values. | |||||||||||||
<font-alias> | child of <font-settings> (This element can be specified as many times as necessary) | |||||||||||||
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:
| |||||||||||||
dst |
PDF Output Settings
These settings are used for PDF Output.
Element | Attribute | Default | Description | |||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
<pdf-settings> | child of <formatter-config> | |||||||||||
add-actualtext-to-artifact | false | When true is specified, ActualText will also be set to the string tagged in Artifact when outputting Tagged PDF. V7.4MR7 | ||||||||||
allow-deprecated-annotation | false | In PDF2.0, some annotations (Movie, Sound) are deprecated. These cannot be output. If you specify true, you will be able to output these in PDF2.0. V7.4 | ||||||||||
allow-embedding-lower-versions | false | In PDF2.0, embedding of PDF1.X is deprecated. If you specify true, you will be able to embed PDF1.X in PDF2.0. V7.4 | ||||||||||
allow-javascript | true | When false is specified, even if JavaScript is specified by openaction or axf:action-type, it will be ignored. no-LT | ||||||||||
allow-nest-alt-text | true | When outputting Tagged PDF, specify false if you do not want to set alternate text for tags descended from tags that have alternate text settings for accessibility reasons. Child tags of the tags that have alternate text settings will no longer have alternate text. In that case, you may not be able to find or copy text that does not have a one-to-one correspondence between glyphs and Unicode using complex scripts. | ||||||||||
alt-text-length-limit | 80 | Sets the upper limit length of alternative text when outputting Tagged PDF. If a negative value is set, length will be unlimited. V7.4MR8 | ||||||||||
check-tag-relationship | false | If true is specified, the validity of the parent-child relationship between tags is verified and a warning is issued for an invalid structure when outputting Tagged PDF2.0. | ||||||||||
color-compression | auto |
When the color image format cannot be stored directly in PDF, the image is stored after being transformed into a bit map format that is compatible with PDF. The compression method of the data stored in a PDF file is then specified by one of the following values:
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. JPEG 2000 is effective only with 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. no-LT | ||||||||||
color-compression-minimum | auto2k | |||||||||||
color-conversion | none | Specifies how to convert the RGB or CMYK color space to DeviceGray or DeviceCMYK.
| ||||||||||
color-conversion-k100 | false | When color-conversion="all-cmyk" is specified, depending on the ICC profile, RGB black (rgb(0,0,0)) does not necessarily become K100 (cmyk(0,0,0,1)). Specifying color-conversion-k100="true" will always convert black to K100. V7.4 | ||||||||||
color-downsampling | none |
Specifies the method to downsample the raster color image that is put into PDF.
| ||||||||||
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. 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 to 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.
| ||||||||||
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. no-LT | ||||||||||
color-jpeg-quality-minimum | 40 | |||||||||||
decimal-part-digits | 5 | Specify the number of digits after the decimal point of real numbers to be output in PDF as 1 to 6. | ||||||||||
decimal-part-digits-default | 5 | Specifies the adopted value of decimal places 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. | ||||||||||
decimal-part-digits-minimum | 3 | |||||||||||
default-output-intent | 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. If not specified, the following is considered to be specified:
| |||||||||||
embed-all-fonts | true |
Specifies whether or not to embed all fonts used in the formatted result in PDF with one of the following:
| ||||||||||
embed-font-encoding |
Specifies the encoding when the TrueType font is embedded. When nothing is specified, Identity-H/V is the default.
| |||||||||||
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 required with PDF/A or PDF/X-4 output. | ||||||||||
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.) no-LT | ||||||||||
encryption-level | 128rc4 |
Specifies the key length when encrypting the PDF file.
| ||||||||||
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.
The value is case-insensitive.
| ||||||||||
error-on-embed-fault | false | When an error occurs while embedding fonts, specifies whether to stop formatting as an error by using the value of true or false. If the value is true, stops formatting as an error. If the value is false, continues formatting without embedding fonts. 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 stop formatting as an error or to continue formatting by using the value of 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 that is unsuitable for PDF/X, PDF/A or PDF/UA is detected while creating PDF/X, PDF/A or PDF/UA, such like PDF/X, PDF/A or PDF/UA that contains non-embeddable fonts. If false is specified, the processing is continued, a generated PDF may be incongruent as PDF/X, PDF/A or PDF/UA. 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, PDF/A or PDF/UA fault option. no-LT | ||||||||||
fallback-alttext | empty string | Sets the string to fall back when the required axf:alttext is not specified. By default, a space character is set. | ||||||||||
ghostscript | When converting EPS into PDF using Ghostscript, the full path to Ghostscript can be specified. For example, specify as ghostscript="/usr/local/bin/gs". Thereby, Ghostscript can be invoked even if the PATH does not set to Ghostscript. Specify gswin64c.exe in Windows 64-bit version (specify gswin32c.exe with x86 version). | |||||||||||
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 that is compatible with PDF. The compression method of the data stored in a PDF file is then specified by one of the following values:
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. JPEG 2000 is effective only with 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. 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:
| ||||||||||
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. 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 to 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.
| ||||||||||
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. no-LT | ||||||||||
grayscale-jpeg-quality-minimum | 40 | |||||||||||
gs-options | When converting EPS into PDF using Ghostscript, Antenna House Formatter V7.4 specifies the following parameters and starts Ghostscript by default:
| |||||||||||
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. If the PDF to be output is PDF/X-1a, it is always considered false. | ||||||||||
import-annotation-types | Annotations contained in the embedded PDF is embeddable directly in PDF. Specify the following character strings (case insensitive) separated by white spaces:
| |||||||||||
import-tagged-pdf | false | Specifies whether to permit embedding Tagged PDF in Tagged PDF. If true is specified, Tagged PDF is embedded “as is” without producing an error. In GUI, you can change the setting at Allow Importing Tagged PDF. For more details, see also PDF Embedding. This setting is not available with Antenna House Formatter V7.4 Lite. no-LT | ||||||||||
joboptions | Specifies Adobe PDF Settings File that is passed to Distiller when converting EPS into PDF using Distiller. Only a local file can be specified. A relative path is resolved relative to the target EPS file.
However, when the EPS itself is a relative path, the operation will be indeterminate. Specify the joboptions with absolute path preferably.
See also 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 considered:
| |||||||||||
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 | ||||||||||
mediabox-origin-zero | false | Some PDF handling software consider that the origin of MediaBox is (0,0). According to the PDF specification, it does not matter where the origin is. Antenna House Formatter V7.4 generates PDF so that the origin of TrimBox is (0,0). If true is specified, adjusts the origin of MediaBox to (0,0). 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 that is compatible with PDF.
The compression method of the data stored in a PDF file is then specified by one of the following values:
| ||||||||||
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. no-LT | ||||||||||
monochrome-compression-minimum | zlib | |||||||||||
monochrome-downsampling | none |
Specifies the method to downsample the raster monochrome image that is put into PDF.
| ||||||||||
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. 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:
| ||||||||||
new-tagging-mode | false | If true is specified, when explicitly specifying an empty string such as axf:pdftag="''", that element does not create a tag but belongs to the tag to which the parent area belongs. In addition, the Role Map is also enabled, and maps from nonstandard tag names to standard tag names are valid. Specifying axf:pdftag="''" on the root element has no effect since the root element does not have a parent: a Document tag is always created. | ||||||||||
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 objects in PDF. It is effective with PDF1.5 or later and text-and-lineart-compression="true" is specified. If true is specified, objects will be compressed, if false is specified, they 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. no-LT | ||||||||||
object-compression-minimum | true | |||||||||||
overprint | Specifies the overprint. Any values of axf:overprint other than auto can be specified. no-LT | |||||||||||
owner-password |
Sets the strings specified as an owner password. Specify up to 32 ASCII characters for PDF1.3 to 1.7 and 127 ASCII characters for PDF2.0 or later. If the characters other than the above are included, it becomes invalid and it is considered that no password is set. The default value is no-password.
| |||||||||||
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. | ||||||||||
pages-max-kids | 10 | Specifies the maximum number of elements in the /Kids array of the PDF /Pages dictionary. Negative or 1 cannot be specified. If 0 is specified, there is no tree structure and all pages are arranged flat in the /Kids array. | ||||||||||
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 (case insensitive) can be specified by enumerating them with white-space specified:
| ||||||||||
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. no-LT | ||||||||||
pass-through-minimum | none | |||||||||||
pdf-version | PDF1.5 | Specifies the version of the PDF to create with one of the following values:
| ||||||||||
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 high-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 | A 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). If the value is out of range, the default value is adopted. This setting is effective only with Windows versions. The vector format image which cannot be stored directly in PDF is not supported with non-Windows versions. 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 PDF1.5 or later. However, even if the PDF1.5 or later, 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 PDF1.5 or later. The following values can be specified:
| ||||||||||
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. | ||||||||||
reverse-page | false | If the value is true, outputs pages in reverse order to PDF. | ||||||||||
strict-list-tag | false | When the LBODY does not exist directly under the LI in Tagged PDF, if true is specified, the LBODY will be inserted automatically. V7.4MR9 | ||||||||||
tagged-pdf | false | Specifies whether to make 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 | ||||||||||
tagging-absolute-area-as-child-of-anchor | false | If true is specified, an area placed at an absolute position is tagged as a child of the location where its anchor exists. V7.4MR10 | ||||||||||
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. no-LT | ||||||||||
text-and-lineart-compression-minimum | true | |||||||||||
transparency | true | Specifies whether to convert transparency output to PDF into opaque. If true is specified, transparency is output as is. If false is specified, it is converted into opaque. In GUI, you can change this setting in Convert Transparency to Opaque
| ||||||||||
transparency-color-space | Device |
Specifies the color space when processing the transparency and isolation in PDF. Either of the following can be specified:
| ||||||||||
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 up to 32 ASCII characters for PDF1.3 to 1.7 and 127 ASCII characters for PDF2.0 or later. If the characters other than the above are included, it becomes invalid and it is onsidered that no password is set. The default value is no-password.
| |||||||||||
xmp-padding | 2000 | Specifies the padding size to assist XMP editing in place when embedding XMP specified by <axf:document-info name="xmp"> or automatically generated XMP in PDF. When the value is 0 or less, padding is not applied. Also, padding is not applied to XMP with <?xpacket end="r"?>. | ||||||||||
<embed-font> | child of <pdf-settings> (This element can be specified as many times as necessary) | |||||||||||
font | Specifies the fonts that are embedded in the PDF. This element 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 glyphs of the characters that are needed in the PDF output are embedded. When this 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 that is not specified, embedding is performed only for the glyphs of the characters that are needed in the PDF output. | |||||||||||
<tag-role-map> | child of <pdf-settings> | |||||||||||
It is an element for putting together <tag-element>. Evaluates the child element only when new-tagging-mode="true". | ||||||||||||
<tag-element> | child of <tag-role-map> (This element can be specified as many times as necessary) | |||||||||||
tag-base-name | When Tagged PDF is output, maps the tag element name from the value of tag-derived-name to the value of tag-base-name.
| |||||||||||
tag-derived-name |
PostScript Output Settings
These settings are used for Post
Element | 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.
The following are restrictions:
| |
transparency | false | When true is specified, the transparency will be processed upon outputting pdfmark, which is a PostScript extension. At this time, 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. For more details, see also the manual of Adobe Acrobat. This specification is valid when printing to Distiller too. 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 Rendering Settings
These settings are used for SVG Rendering.
Element | Attribute | Default | Description |
---|---|---|---|
<svg-render-settings> | child of <formatter-config> | ||
current-color-eval-at-painting | true | Specifies the evaluation timing of currentColor. When the value is true, adopts the color property of the element with fill/stroke being executed. When the value is false, adopts the color property of the element with currentColor specified. | |
image-element-eval-as-svg20 | true | Specifies whether the <image> should be evaluated according to the SVG 2.0 specification. The SVG 2.0 specification enables the auto value for width/height and prohibits the reference destination from opening external files. When the value is true, evaluates it according to the SVG 2.0 specification. When the value is false, evaluates it according to the SVG 1.1 specification. | |
inherit-svg-fill-color | false | When “fill” in the root element is omitted, the value of “color” specified in the upper XML is inherited. | |
marker-evaluation-elements | line path polygon polyline | Specifies the graphic elements that render markers, separated by spaces. According to the specifications, markers are rendered for all graphic elements, but browsers often evaluate only a limited number of elements, and the default values are set accordingly. | |
outermost-svg-eval-as-isolate | true | Specifies whether to treat the outermost <svg> as an isolation element. When the value is true, the outermost <svg> descendant element is not composed with the background because it is treated as an isolation element even if isolation is not required. | |
radial-gradient-eval-as-svg20 | true | Specifies whether the <radialGradient> should be evaluated according to the SVG 2.0 specification. When the value is true, evaluates it according to the SVG 2.0 specification. When the value is false, ignores the truncated focal radius so that the focal point is within the end circle as per the SVG 1.1 specification. | |
rasterize-dpi | 108 | Specifies the dpi when rasterization is required for a filter, etc. This is a setting for the size of the SVG image itself, not the size when the SVG image is rendered on the output medium. | |
rasterize-size-lower-limit | 100 | When rasterization is required for a filter, etc., the number of vertical or horizontal pixels of the image will be limited to no less than this value. | |
rasterize-size-upper-limit | 4000 | When rasterization is required for a filter, etc., the number of vertical or horizontal pixels of the image will be limited to not exceed this value. | |
responsive-svg-size | reference | Specifies whether the size matches the viewBox setting when width/height of the root element are omitted.
The following values can be specified:
| |
use-element-eval-as-shadow-element | false | Specifies whether <use> should be evaluated according to the SVG 2.0 specification. According to the SVG 2.0 specification, the element of the reference destination is evaluated as a shadow element, and CSS selectors are evaluated as such. When the value is true, evaluates it according to the SVG 2.0 specification. When the value is false, evaluates it according to the SVG 1.1 specification. | |
width-height-as-presentation-attribute | false | Specifies whether to evaluate width/height of elements other than <svg> as presentation attributes. When the value is true, evaluates it as a presentation attribute. When the value is false, evaluates it as an attribute. |
SVG Output Settings
These settings are used for SVG Output.
Element | Attribute | Default | Description | |
---|---|---|---|---|
<svg-settings> | child of <formatter-config> | |||
copy-image-path | Specifies the destination directory where the images will be copied when image-processing is copy-all or copy. | |||
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. | |||
create-copy-image-path | false | When images are copied to the directory specified by copy-image-path and processed, if the destination directory of the specified image copy does not exist, specifies whether to create the directory by true or false. If false is specified, it will not be created and an error will occur. If true is specified, it will be created. V7.4 | ||
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 files 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:
| ||
image-processing | embed-all |
Specifies how to treat the referred image.
| ||
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 to 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.
| ||
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). This setting is effective only with Windows versions. The vector format image which cannot be stored directly in SVG is not supported with non-Windows versions. | ||
svg-version | 2.0 | Specifies the version of the SVG to create with one of the following values:
|
TEXT Output Settings no-LT
These settings are used for TEXT Output. These settings are not effective with Antenna House Formatter V7.4 Lite.
Element | Attribute | Default | Description |
---|---|---|---|
<text-settings> | child of <formatter-config> | ||
encoding | UTF-8 | Specifies the encoding of the output text. The following encodings are available (case insensitive):
| |
eol-marker | CRLF or LF | Specifies the linefeed code of the output text. The following can be specified (case insensitive):
|
MathML Settings
These settings are used for Math
CAUTION: | The default value shows the equivalent value. Note that the setting cannot be described as thinSpace="2/10" in fact. Describe it as thinSpace="0.2" in a file. |
---|
Element | Attribute | Default | Description | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
<mathml-settings> | child of <formatter-config> | |||||||||||||||||
math | inline | In the MathML specification, the default value of display in <math> is defined as inline, but it can be changed. One of the following can be specified:
| ||||||||||||||||
scriptsize | 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). ☞ OpenType MATH Feature | ||||||||||||||||
scriptsize | 0.6 | In the MathML specification, although the default value of scriptsizemultiplier of <mscarries> 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 unlimited. | ||||||||||||||||
largeop | 1.414 | Specifies the multiplier of largeop by the unitless numerical value (≥1). ☞ OpenType MATH Feature | ||||||||||||||||
largeop | 2.0 | Specifies the multiplier of largeop against the integral by the unitless numerical value (≥1). The integral consists of 27 characters of U+222B to U+2233 and U+2A0B to U+2A1C. ☞ OpenType MATH Feature | ||||||||||||||||
mathsize | 0.83 | Specifies the multiplier against mathsize="small" by the unitless numerical value (>0). | ||||||||||||||||
mathsize | 1.17 | Specifies the multiplier against mathsize="big" by the unitless numerical value (>0). | ||||||||||||||||
en | 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. | ||||||||||||||||
em | 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. | ||||||||||||||||
en | 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. | ||||||||||||||||
em | 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. | ||||||||||||||||
thin | 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. | ||||||||||||||||
hair | 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. | ||||||||||||||||
very | 1/18 | Specifies the space for veryverythinmathspace by the unitless numerical value (>0). The numerical value is in unit of em. | ||||||||||||||||
very | 2/18 | Specifies the space for verythinmathspace by the unitless numerical value (>0). The numerical value is in unit of em. | ||||||||||||||||
thin | 3/18 | Specifies the space for thinmathspace by the unitless numerical value (>0). The numerical value is in unit of em. | ||||||||||||||||
medium | 4/18 | Specifies the space for mediummathspace by the unitless numerical value (>0). The numerical value is in unit of em. | ||||||||||||||||
thick | 5/18 | Specifies the space for thickmathspace by the unitless numerical value (>0). The numerical value is in unit of em. | ||||||||||||||||
very | 6/18 | Specifies the space for verythickmathspace by the unitless numerical value (>0). The numerical value is in unit of em. | ||||||||||||||||
very | 7/18 | Specifies the space for veryverythickmathspace by the unitless numerical value (>0). The numerical value is in unit of em. | ||||||||||||||||
under | 0.15 | Specifies the space between the over/under scripts and the base character by the numerical value with no units or the named length. The numerical value is the em value. ☞ OpenType MATH Feature | ||||||||||||||||
default | thick | Specifies the lspace value of the operator that 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. | ||||||||||||||||
default | thick | Specifies the rspace value of the operator that 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. | ||||||||||||||||
default | 100% | In the MathML specification, although the default value of minsize of <mo> is defined as 100%, the value can be changed by specifying the numerical value with units (≥0). | ||||||||||||||||
default | 0pt | Specifies the default value of lineleading of <mo> with the numerical value with units (≥0). The value indicates the space between lines. | ||||||||||||||||
math | 0pt | The only way to control the space between lines when the line break occurs is to do with lineleading of <mo>. The line break can also be specified in <mspace>, but there is no way to specify the space between lines at that time. mathLeading specifies all spaces between lines by the line break with an absolute value with units (≥0). The setting of lineleading of <mo> will be added. ☞ OpenType MATH Feature | ||||||||||||||||
linebreaking | true | When the line break occurs, there is no rule on how the height of each row should be. If false is specified, the height of each row is the height of the entire row before the line break occurs. That is, each row has the same height. If true is specified, the height of each row is its height respectively. | ||||||||||||||||
indenting | 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). | ||||||||||||||||
apply | thin | 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. | ||||||||||||||||
invisible | thin | 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. | ||||||||||||||||
script | 1 | Specifies the alignment of subscript/superscript.
| ||||||||||||||||
italic | -0.04 | Specifies the shift amount of the lower-right and upper-left scripts by the unitless numeric value with <msub>, <msubsup> and <mmultiscripts> when the base character is italic. the numeric value is in unit of em. it's not applied to the integral of largeop. ☞ OpenType MATH Feature | ||||||||||||||||
integral | -0.3 -0.2 | 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 right, it shifts only the amount of -integralSubscriptShift. The 2 values can be specified, the first one indicates the value when displaystyle="true" is specified, the next one indicates the value when displaystyle="false" is specified. The numerical value is in unit of em. ☞ OpenType MATH Feature | ||||||||||||||||
integral | 0.02 0 | 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 right, it shifts only the amount of -integralSuperscriptShift. The 2 values can be specified, the first one indicates the value when displaystyle="true" is specified, the next one indicates the value when displaystyle="false" is specified. The numerical value is in unit of em. ☞ OpenType MATH Feature | ||||||||||||||||
integral | 0.2 0.12 |
Specifies the shift amount of the over/under script (<mover>, <munder> and <munderover>) of the integral of the largeop by the unitless numerical value or the named length. The 2 values can be specified, the first one indicates the value when displaystyle="true" is specified, the next one indicates the value when displaystyle="false" is specified.
The numerical value is in unit of em.
This shift is available only when align="center" is specified. Over script will shift to the right, under script will shift to the left.
In the MathML specification, the alignment of over script and under script cannot be specified independently, it is not easy to format the script shown in the folowing image.
![]() | ||||||||||||||||
thin | 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. | ||||||||||||||||
medium | 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. | ||||||||||||||||
thick | 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. | ||||||||||||||||
frac | 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. | ||||||||||||||||
frac | 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. | ||||||||||||||||
frac | 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. ☞ OpenType MATH Feature | ||||||||||||||||
frac | 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. ☞ OpenType MATH Feature | ||||||||||||||||
bevelled | 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. | ||||||||||||||||
bevelled | 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. | ||||||||||||||||
root | -0.6 | Specifies the shape of a radical symbol by the unitless numerical value or the named length.
The numerical value is in unit of em.
![]() | ||||||||||||||||
root | 0.4 | |||||||||||||||||
root | -0.5 | |||||||||||||||||
root | 0.5 | |||||||||||||||||
root | -0.3 | |||||||||||||||||
root | 0.05 | |||||||||||||||||
root | 0 | |||||||||||||||||
root | 20/18 | |||||||||||||||||
root | 0.5/18 | |||||||||||||||||
root | 1.3/18 | |||||||||||||||||
root | 1/18 | |||||||||||||||||
root | 1/18 | |||||||||||||||||
root | 1/18 | Rounds the left part of the radical symbol. Specify the rounding radius with unitless numerical values (≥0) or the named length. The numerical value is in unit of em. If it is 0, no rounding is done. | ||||||||||||||||
enclose | 1/18 | Specifies the thickness of the line rendered with <menclose> by the unitless numerical value (>0) or the named length. The numerical value is in unit of em. | ||||||||||||||||
enclose | inscribed | Specifies whether a circle rendered with <menclose notation="circle"> is inscribed or circumscribed against the boundary rectangle. inscribed or circumscribed can be specified. The circumscribed circle is a similar figure to the inscribed circle. | ||||||||||||||||
roundedbox | 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. | ||||||||||||||||
column | 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. 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 Antenna House Formatter V7.4 has been changed.) | ||||||||||||||||
row | 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. Note that only a numeric value can be specified. | ||||||||||||||||
frame | 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 Antenna House Formatter V7.4 have been changed.) | ||||||||||||||||
columnline | 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. | ||||||||||||||||
rowline | 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. | ||||||||||||||||
frameline | 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. | ||||||||||||||||
charspacing | 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. | ||||||||||||||||
charspacing | 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. | ||||||||||||||||
charspacing | 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. | ||||||||||||||||
overlap | true | Specifies whether to render <msline> over the above <msrow>. When mslinethickness is extremely thick, <msline> overlaps the characters of the above <msrow>. In such a case, specify false. | ||||||||||||||||
msline | 0 | Specifies the space above <msline> by the unitless numerical value (≥0) or the named length. The numerical value is in unit of em. It is invalid when overlapMsline="true" is specified. | ||||||||||||||||
msline | 0 | Specifies the space below <msline> by the unitless numerical value (≥0) or the named length. The numerical value is in unit of em. It is invalid when overlapMsline="true" is specified. | ||||||||||||||||
crossout | 1/18 | Specifies the line thickness of crossout of <mscarry> by the unitless numerical value (≥0) or the named length. The numerical value is in unit of em. | ||||||||||||||||
error | red | Specifies the color with <merror>. | ||||||||||||||||
error | transparent | Specifies the background color with <merror>. | ||||||||||||||||
escaping | \ | Specifies the escape character with <ms>. If empty is specified, the escape processing will not be performed. | ||||||||||||||||
italicize |
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 that is made italic with <mi>. See also Unicode Range 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. | ||||||||||||||||
stylistic | Specifies the Unicode Range to a single letter specified by <mi> to apply GSUB of ss02 in OpenType font. As for the format, see
Unicode Range. For example, in STIX Two Math, glyphs are prepared for the following 5 letters:
| |||||||||||||||||
subst | true | Specifies whether to enable the character substitutions defined in 7.7.1 Keyboard Characters in the MathML specification. See also Character Substitutions. | ||||||||||||||||
pseudo | 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 pseudo 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. | ||||||||||||||||
inherit | false | Specifies whether to inherit the default of fontweight from the upper environment by the value of true or false. | ||||||||||||||||
enable | true | Specifies whether to enable OpenType MATH feature.
If true is specified, all processing is effective. If false is specified, all processing is invalid. When you want to enable only the specific processing, specify as follows by enumerating function name keywords separated by whitespace:
| ||||||||||||||||
except | When you do not want to apply the OpenType feature to some characters with largeop | |||||||||||||||||
mathml | 7.4 | There are some contents that the default value has been changed or added in the MathML settings. If you specify a previous version, such as mathmlSettingsMode="6.3", the initial value can be changed to the one at that time. | ||||||||||||||||
<variant-font> | child of <mathml-settings> (This element can be specified as many times as necessary) | |||||||||||||||||
Specifies the font corresponding to mathvariant. See also Fonts for Math Expression. | ||||||||||||||||||
mathvariant | Either of the following can be specified:
| |||||||||||||||||
fontfamily | Specifies the font to be used. The default value of mathvariant="" in Windows versions is:
| |||||||||||||||||
mtext | false |
When true is specified, it indicates that the font to be used in <mtext> is specified.
When mathvariant="" mtext="true" is specified, the default value of fontfamily in Windows versions is:
| ||||||||||||||||
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> (This element can be specified as many times as necessary) | |||||||||||||||||
Specifies the font that corresponds to the script or Unicode Range. This setting can change a part of fonts specified by fontfamily of <variant-font>.
The following shows the example:
| ||||||||||||||||||
fontfamily | Specifies the font to use. | |||||||||||||||||
script | Specifies the scripts, such as Latn or Grek. The available scripts conform to ISO 15924. However, Zyyy, etc. cannot be specified. | |||||||||||||||||
unicode-range | Specifies the range of Unicode to apply. See also Unicode Range 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 doubly slanted. 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. The default value is the value of <variant-font>. See also Fonts for Math Expression. | |||||||||||||||||
<operator-dictionary> | child of <mathml-settings> (This element can be specified as many times as necessary) | |||||||||||||||||
<operator-dictionary> is specified in order to change the contents of the default operator dictionary. 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 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> (This element can be specified as many times as necessary) | |||||||||||||||||
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 src of <operator-dictionary> is specified. | ||||||||||||||||||
operator | Specifies the operator. This setting is required. | |||||||||||||||||
form | Specifies either of the following:
| |||||||||||||||||
priority | 0 | Specifies the integer value. | ||||||||||||||||
lspace | 5 | Specifies the value from 0 to 7. Values have the following meanings:
| ||||||||||||||||
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:
|
The named length is either of the following:
- veryverythinmathspace
- verythinmathspace
- thinmathspace
- mediummathspace
- thickmathspace
- verythickmathspace
- veryverythickmathspace
- negativeveryverythinmathspace
- negativeverythinmathspace
- negativethinmathspace
- negativemediummathspace
- negativethickmathspace
- negativeverythickmathspace
- negativeveryverythickmathspace
negative* is a negative length. negative* cannot be used in the scene where a positive value is calculated.
OpenType MATH Feature
OpenType fonts for math expressions may contain MATH features. The MATH feature contains a lot of information for the math expression layout. In Antenna House Formatter V7.4, you can use the various MATH features by setting enableOpenTypeMATH. The feature name keywords that can be specified for enableOpenTypeMATH are as follows:
- true
Enable all processing.
- false
Disable all processing.
- scriptsizemultiplier
When scriptsizemultiplier is not specified, applies
MathConstants.ScriptPercentScaleDown
to scriptlevel=1. Applies
MathConstants.ScriptScriptPercentScaleDown
to scriptlevel=2. Applies
ScriptScriptPercentScaleDown*(ScriptScriptPercentScaleDown/ScriptPercentScaleDown)L
to scriptlevel=3 or more. (L=scriptlevel-2 here)
- mathleading
Applies
MathConstants.MathLeading
to the space between lines when the line break occurs. At this time, mathLeading is ignored.
- largeopmultiplier
If MathVariants has a definition for largeop <mo>, adopts that glyph. At that time, if there is a glyph of
MathConstants.DisplayOperatorMinHeight
or more, adopts the smallest glyph within it, otherwise adopts the largest glyph. At this time, when the following values exceed 1.0, they are ignored:
- vertstretchy
If there is a definition in MathVariants for vertically stretching <mo>, that glyph is used. However, the stretching with the combination of multiple glyphs is not supported.
- italicscorrection
For characters with Italics
Correction defined, the following are ignored: Subscript is adjusted to the position considering Italics
Correction, superscript is not adjusted. (The script on the left side behaves in the opposite way.) - fractiongap
Adjusts the distance between the fraction rule and the numerator/denominator by <mfrac> using the following:
MathConstants.FractionNumeratorGapMin MathConstants.FractionNumDisplayStyleGapMin MathConstants.FractionDenominatorGapMin MathConstants.FractionDenomDisplayStyleGapMin
At this time, the following are ignored:
- fractionthickness
Sets the default thickness of the fraction rule to the value of
MathConstants.FractionRuleThickness
when linethickness in <mfrac> is not specified.
- upperlowerlimit
Adjusts the minimum distance between the over/under scripts and the base character by <munder>, <mover> and <munderover> using the following:
MathConstants.LowerLimitGapMin MathConstants.UpperLimitGapMin
- radicalgap
Adjusts the distance between the roof of the radical symbol and the math contents using the following:
MathConstants.RadicalVerticalGap MathConstants.RadicalDisplayStyleVerticalGap
At this time rootPosition4y is ignored.
- radicalthickness
Applies
MathConstants.RadicalRuleThickness
to the thickness of the radical symbol. This value will be the value of rootThickness4. The values of rootThickness1, rootThickness2 and rootThickness3 are calculated from rootThickness4 according to the ratio of the values specified in the Option Setting File.
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.
CAUTION: | Using multiple fonts with different origins in math expression makes the adjustment of positions troublesome. It is not a recommended usage. |
---|
STIX Fonts
Antenna House Formatter V7.4 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>.
CAUTION: | The supported STIX fonts versions are 2.0, 1.1.1 or 1.1.0. |
---|
Cambria Math Fonts
Fonts for Math expression called Cambria Math are enclosed in Windows. In Antenna House Formatter V7.4 Windows versions, 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 Te
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.
CGM Settings
These settings are used for CGM.
Element | Attribute | Default | Description |
---|---|---|---|
<cgm-settings> | child of <formatter-config> | ||
issue-unknown-element | 10 | Specifies whether a warning message is issued when unknown elements appear. If -1 is specified, issues a warning against all unknown elements, then ignore these elements. If greater than or equal to 1 is specified, issues a warning up to the specified number, then ignores these elements, when it reaches its number, stops evaluating CGM. | |
issue-unsupported-element | 1 | Specifies whether a warning message is issued against unsupported elements. When -1 is specified, issues a warning against all elements. if 0 is specified, a warning message is not issued. If greater than or equal to 1 is specified, issues a warning up to the specified number for each element. | |
default-line-cap | round | Specifies the default value of LINE CAP / EDGE CAP by either of the following (the number on the left can also be specified):
| |
default-edge-cap | round | ||
default-line-join | round | Specifies the default value of LINE JOIN / EDGE JOIN by either of the following (the number on the left can also be specified):
| |
default-edge-join | round | ||
default-mitre-limit | -1 | Specifies the default value of MITRE LIMIT. If a negative value is specified, the limit is not outputted. (It's environment dependent.) | |
default-restricted-text-type | boxed-cap | Specifies the default value of RESTRICTED TEXT TYPE by either of the following (the number on the left can also be specified):
| |
fallback-font | Specifies the fallback font in case the font settings in CGM is insufficient. | ||
aci | Specifies the file of Application Configurable Items. See also Application Configurable Items. |
XSLT Settings
These settings are used for XSLT Processor.
Element | 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, Antenna House Formatter V7.4 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 considered 6. This setting is effective only with Windows versions. | |
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.
| ||
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:
| ||
<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, since the quotation marks will not be processed, 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:
| ||
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.
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 "%3" "%1" "%2" %param" param-option="%p=%v">
<param name="foo" value="123"/>
<param name="bar" value=""Hello, World""/>
</xslt-settings>
XSLT Processor runs 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, “"”.
Analyzer Settings no-LT
These settings are used for automated analysis of the Area Tree. These settings are not effective with Antenna House Formatter V7.4 Lite.
Element | Attribute | Default | Description |
---|---|---|---|
<analyzer-settings> | child of <formatter-config> | ||
analyze | true |
Specifies whether to perform analysis checks. | |
end-blank-pages | true | Specifies whether to analyze the number of blank pages at the end of the document. | |
end-blank-pages-limit | 2 | Allowed number of blank pages at the end of document | |
hyphen | true | Specifies whether to analyze the number of consecutive lines that end with a hyphen. | |
hyphen-limit | 3 | Allowed number of consecutive lines that end with a hyphen. | |
line-start-end | true | Specifies whether to analyze consecutive lines that start, or that end, with the same word. | |
line-start-limit | 8 | Maximum number of characters to compare at the start of a line. | |
line-start-repeat-limit | 2 | Allowed number of lines that start with the same word. | |
line-end-limit | 8 | Maximum number of characters to compare at the end of a line. | |
line-end-repeat-limit | 2 | Allowed number of lines that end with the same word. | |
lines-after | true | Specifies whether to analyze the number of lines after a block. | |
lines-before | true | Specifies whether to analyze the number of lines before a block. | |
page-widow | true | Specifies whether to analyze pages that start with a page-level widow. | |
page-widow-limit-em | 2.5 | Minimum width, in 'em' for the current block, of a widow line at the start of a page. If the value is 0, this setting is ignored. A negative value is treated as 0. | |
page-widow-limit-percent | 15 | Minimum width, in percent of the current block width, of a widow line at the start of a page. If the value is 0, this setting is ignored. A negative value is treated as 0. | |
paragraph-widow | true | Specifies whether to analyze paragraphs that end with a paragraph-level widow. | |
paragraph-widow-limit-em | 2.5 | Minimum width, in 'em' for the current block, of a widow line at the start of a paragraph. If the value is 0, this setting is ignored. A negative value is treated as 0. | |
paragraph-widow-limit-percent | 15 | Minimum width, in percent of the current block width, of a widow line at the start of a paragraph. If the value is 0, this setting is ignored. A negative value is treated as 0. | |
river | 1em | Either the maximum allowed cumulative width, in 'em' or as an absolute length, for a river of white-space within a block or the value none to disable river analysis. | |
river-zone | 0 | Maximum allowed width between two non-overlapping spaces on consecutive lines for the spaces to be considered a part of the same river. This setting is ignored when river is none. | |
unbalanced-spread | true | Specifies whether to analyze unbalanced spreads. | |
unbalanced-spread-limit | 0 | Allowed height difference, in 'pt', for an unbalanced spread. A negative value is treated as 0. | |
white-space | 0.40em | Either the maximum width, in 'em' or as an absolute length, for white-space between consecutive words on a line or the value none to disable white-space analysis. |
Example
<?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 "%3" "%1" "%2" %param"
param-option="%p=%v">
<param name="foo" value="123"/>
<param name="bar" value="XYZ"/>
</xslt-settings>
</formatter-config>