Graphical User Interface

AH Formatter V6.3 Windows version has a Graphical User Interface (GUI). By using the GUI, you can easily initiate formatting and then view the formatted results in the WYSIWYG window prior to outputting to PDF or printing. You also have control over a number of formatting options, can set the options for PDF output and can direct files to any connected printer.

For developers, the GUI provides quick visual feedback of formatting results and has the added ability to save Area and FO Trees to aid in the development processes. In a large multi-page document, the pages can be browsed as they are formatted. If errors are detected, formatting can be stopped prior to completion, thus saving considerable time on very large runs.

The GUI also lets you save the XSL-FO file resulting from an XSLT transformation. This is very useful when you want to transmit a file for formatting, but not the XML or XSL files.

Main Window

The application window of AH Formatter V6.3 consists of following elements.

GUI Window

  1. Title Bar

    The title bar shows the name of the source file being formatted. It may also show: the stylesheet (XSL file) if formatting an XML file; and if a <title> of HTML or FO file <fo:title> or <axf:document-info> extension property is present, its content will also be shown (HTML's <title> or <fo:title> takes priority).

    Title Bar

  2. Tool Bar

    The most commonly used menu functions are available as buttons on the Tool Bar. You can easily execute these functions by one click of the mouse. [View]-[Tool Bar]

  3. Status Bar

    The Status Bar displays the following information. [View]-[Status Bar]

    • Current status of Formatter or the tool bar button function as you pass over the button with the pointer.
    • Current page number/total number of pages (based on physical page count).
    • The physical page size of the displayed page.
    • Zoom ratio.

    Status Bar

  4. WYSIWYG (What You See Is What You Get)

    The WYSIWYG displays the formatted results. When the scroll bar is displayed on the WYSIWYG window, you can press and hold the left mouse button to use the hand tool as the mouse pointer to move the page around so that you can view all the areas. Note that the hand tool is not available when [Text Select] mode is selected in the Edit menu.

    You can format files of various types by dropping them on the WYSIWYG window. (See Drag-and-drop Formatting).

    CAUTION: Although some unsupported drawing elements may not be displayed in the GUI, there may be no problem with the output to other devices, such as PDF.

  5. Log Window

    The log window shows a running status as the document is formatted. Minor warnings are shown here. Serious warnings are shown in a popup dialog box. The log window can hold a significant amount of status information. Older information is discarded if the information becomes too much. The last line of the log output is the time it took to format the document. The log window has its own scroll bar for viewing the log output.

    Example for Log Window

    The content in the log window can now automatically be saved to a file by click the Others tab in the Other Settings Dialog and then checking the [Output Log File] check box.

When exiting AH Formatter V6.3, the position and the size of the GUI are stored. Formatter restarts at that same position and size.

Tooltip

When the pointer is over an area on the WYSIWYG window, such as over a character string or an image, the information about the area is displayed as a Tooltip. Font name, size, format and size of an image that are actually used can be checked.

Tool Tip

Multiple font names may be displayed in order to show the difference between the specified font and the font actually used:

font-family
The font-family specified by FO.
font-name
The font name actually selected. If this is the same as font-family, it is not displayed.
display-name
The font name that Windows selected to display the character on the screen. If this is the same as font-name, it is not displayed.

Also refer to [Display Glyph] in the menu.

Drag-and-drop Formatting

You can format files of various types by dropping them on the WYSIWYG window. The type of the file is detected automatically as you drop it. (See Detection of Formatting Type to learn about automatic detection.) If you'd like to specify the file type, please instead open the file using the Document/Stylesheet Dialog. The dropped file is added to the <Recent File> list in the File menu and its file type is also memorized. Therefore, when you drop a file that is also on the Recent File list, the same file type will be used again automatically. Formatting actions for each file type are as follows:

FO file
Formatting starts immediately.
Stylesheet (XSL or CSS)
When you drop the stylesheet on a formatted XML/HTML document, AH Formatter V6.3 starts formatting the current document using the dropped stylesheet. When you drop the stylesheet and there is no current XML/HTML document, if you then drop a XML/HTML document, AH Formatter V6.3 starts formatting the new document using the stylesheet.
HTML file (without XSL/CSS specification in HTML)
Formats the document using a default stylesheet.
XML/HTML file (with XSL/CSS specification in XML/HTML)
Formats the document using the stylesheet specified in the XML/HTML.
XML/HTML file (without XSL/CSS specification in XML/HTML) + Stylesheet (XSL/CSS)
Formats the document using the dropped stylesheet.
XML/HTML file (with XSL/CSS specification in XML/HTML) + Stylesheet (XSL/CSS)
Formats the document using the dropped stylesheet.
Graphics file
Renders graphics files in formats supported by AH Formatter V6.3 .

If another stylesheet is dropped when formatting a file, except for a FO or graphics file, the file can be again formatted using the stylesheet. Moreover, if a Internet shortcut (.url) file, URL character string or Shortcut link (.lnk) to a file is dropped, the target file referred to by the URL can be opened.

  1. File
    Menu Shortcut Description

  2. Edit
    Menu Shortcut Description

  3. Move
    Menu Shortcut Description

  4. View
    Menu Shortcut Description
    Show Border Ctrl+ B Specifies whether to display borders of areas. The displayed borders are used to confirm how the formatted result is divided in areas. The borders do not appear in any output file or when printing. This setting can also be specified in Other Settings Dialog.
    Display Glyph Specifies whether the characters are selected by Windows or are based on glyph outlines. When Windows can select the font to display, a font may be replaced and there is no guarantee that the font that is displayed is the actual specified font. See Tooltip.
    Tool Bar Specifies whether to show or hide the Tool Bar.
    Status Bar Specifies whether to show or hide the Status Bar.

  5. Format
    Menu Shortcut Description

  6. Help
    Menu Shortcut Description

The following popup menu/boxes are displayed in the GUI.

Menu Description
Copy Copies text selected.
Format Formats the current document (FO or XML+XSL etc.).
Stop Format Stops formatting.
Open Opens the the link under the pointer and formats the destination file in the current window.
Open New Window Opens and formats either the link under the pointer or the current document in a new window.
Shell Open Opens either the link under the pointer or the current document with the Windows application for its file type.

The content in the Log Window depends on which function Formatter is performing.

The following popup menu/boxes are displayed on the Ruler.

Menu Description
cm Sets the units of the ruler to cm.
mm Sets the units of the ruler to mm.
in Sets the units of the ruler to in.
pt Sets the units of the ruler to pt.
pc Sets the units of the ruler to pc.
px Sets the units of the ruler to px.
q Sets the units of the ruler to q.
Reset Resets the position of the ruler to its default.
Hide Hides the ruler.

Document/Stylesheet Dialog

The Document/Stylesheet Dialog is used when opening a document or document plus stylesheet to be formatted.

Document/Stylesheet Dialog

The directory or base URL displayed under the each edit box indicates the base directory that will be used with a relative path in the edit box.

Click [OK] to start formatting.

AH Formatter V6.3 determines the file type based on its content. If a stylesheet is called from within an document, then it is not necessary to separately specify the stylesheet. The specified stylesheet is used automatically.

Save AreaTree Dialog no-LT

The AreaTree is an XML representation of the formatted result of FO or HTML that includes almost all the page geometry and layout information. Since all formatting information and all information necessary for formatting is included in the area tree it is a very useful tool for stylesheet developers. Press the [Save] button to save the area tree. An area tree XML file can be opened using the current browser. It's possible to format an area tree by specifying it in the document combo box of the Document/Stylesheet Dialog.

CAUTION: Area trees can be very large. The formatted results cannot be guaranteed.

Saving and loading the area tree is not available with AH Formatter V6.3 Lite.

Save FOTree Dialog

In processing an FO or XML and XSL file Formatter first complete the FO file by adding properties, adding the elements omitted in the loaded FO or the resulting FO of the XSLT transformation and removing unused elements. The area tree is generated by evaluating this completed FO. Press the [Save] button to save the FO that was made at this time. When you format a document from the area tree or when you format with CSS, this menu cannot be selected.

Save FO Dialog

This menu item lets you save an FO file that is the result of the XSLT transformation of the XML and XSL files that is being formatted. This menu is only available for files formatted from XML and XSL files.

The Print Dialog lets you output the formatted result to any printer installed or accessible from your Windows system.

Print Dialog

You can select to print all pages, a range of pages, or selected pages. If formatting is not yet completed in the GUI, Formatter reformats the document from the beginning before output to the printer. For this reason it may take more time to output to a printer than the GUI. The border used to confirm how the formatted result is divided in areas does not appear in Print Output.

See also Restrictions regarding print.

PDF Output Dialog

The PDF Output Dialog enables outputting the formatted results to PDF by using the PDF output engine developed by Antenna House.

PDF Output Dialog

You can select to output the entire document or select a range of pages. yet completed in the GUI, Formatter reformats the document from the beginning , it may take more time to output to a PDF file than the GUI. The border used to confirm how the formatted result is divided in areas does not appear in PDF Output.

Changes made in PDF Output Dialog are temporary and do not affect the much more comprehensive PDF Option Setting File under the Format Menu. Please specify the detailed settings regarding PDF output in the PDF Option Setting Dialog.

Please refer to PDF output to learn more about the outputted PDF.

SVG Output Dialog

SVG Output Dialog

The SVG Output Menu enables outputting the formatted results to SVG by using the SVG output engine developed by Antenna House. Through the menu a user can select to output the entire document or selected range of pages. If formatting is not completed in the GUI then Formatter reformats the document from the beginning for output to SVG. For this reason it may take more time to output to a SVG file than the GUI. The border used to confirm how the formatted result is divided in areas does not affect SVG Output.

Changes in SVG Output Dialog are temporary and are not reflected to the Option Setting File. See also SVG Option in the Other Settings Dialog.

Please refer to SVG output to learn more about the outputted SVG.

PostScript Output Dialog

PostScript Output Dialog

The PostScript Output Menu enables outputting the formatted results to PostScript by using the PostScript output engine developed by Antenna House. Through the menu a user can select to output the entire document or selected range of pages. If formatting is not completed in the GUI then Formatter reformats the document from the beginning for output to PostScript. For this reason it may take more time to output to a PostScript file than the GUI. The border used to confirm how the formatted result is divided in areas does not affect PostScript Output.

Please refer to PostScript Output to learn more about the outputted PostScript.

XPS Output Dialog

XPS Output Dialog

The XPS Output Menu enables outputting the formatted results to XPS (XML Paper Specification) file by using the XPS output engine developed by Antenna House. Through the menu a user can select to output the entire document or selected range of pages. If formatting is not completed in the GUI then Formatter reformats the document from the beginning for output to XPS. For this reason it may take more time to output to a XPS file than the GUI. The border used to confirm how the formatted result is divided in areas does not affect XPS Output.

Please refer to XPS Output to learn more about the outputted XPS.

INX Output Dialog

INX Output Dialog

The INX Output Menu enables outputting the formatted results to INX (InDesign Interchange File) by using the INX output engine developed by Antenna House. Through the menu a user can select to output the entire document or selected range of pages. If formatting is not completed in the GUI then Formatter reformats the document from the beginning for output to INX. For this reason it may take more time to output to a INX file than the GUI. The border used to confirm how the formatted result is divided in areas does not affect INX Output.

Please refer to INX Output to learn more about the outputted INX.

MIF Output Dialog

MIF Output Dialog

The MIF Output Menu enables outputting the formatted results to MIF (Maker Interchange Format) by using the MIF output engine developed by Antenna House. Through the menu a user can select to output the entire document or selected range of pages. If formatting is not completed in the GUI then Formatter reformats the document from the beginning for output to MIF. For this reason it may take more time to output to a MIF file than the GUI. The border used to confirm how the formatted result is divided in areas does not affect MIF Output.

Please refer to MIF Output to learn more about the outputted MIF.

Text Output Dialog

Text Output Dialog

The TEXT Output Menu enables outputting the formatted results to plain text format. no-LT

Please refer to TEXT Output to learn more about the outputted TEXT. Text output cannot be performed with AH Formatter V6.3 Lite.

Document Information Dialog

Document Information Dialog

The information of axf:document-info in FO is displayed. The content can be changed here, and it can be reflected to the output PDF. The content of the change is not reflected in former FO. Refer to axf:document-info for details.

Search String Dialog

Search String Dialog

Specify a sequence of characters to search. This dialog continues being displayed until it closes. When some characters have found in the last searching, It start searching from the following character. For example, when ABCDE is searched and is found, the next searching starts from B. When having found nothing, the searching begins from the first or the last page. In order to cancel the highlight of a searching result, please click anywhere on the GUI screen.

This search function has the following restrictions.

Search Property Dialog

Search Property Dialog

Specify a property to search. This dialog continues being displayed until it closes.

Go To Page Dialog

Go To Page Dialog

Used to specify the page number to go to and can be from 1 to the total number of formatted pages displayed in the Status Bar.

Zoom Dialog

Zoom Dialog

Specifies the zoom ratio. Can be set from 5% to 2000%.

Format Option Setting Dialog

By default if the AHFSettings.xml (AHFSettings(x64).xml for Windows x64 version) file exists in the application data directory this file is automatically loaded at startup as the Options Setting File. The application data directory is indicated by the environment variable, APPDATA. [APPDATA]\AntennaHouse\AHFormatter\6.3\ If you want to load the other setting file, click Import Setting Files on the Format menu. Through the Format Option Setting Dialog, formatting items in the Option Setting File can be modified. Once changes are made through the Format Option Setting Dialog, click [OK] to write the changed items to the AHFSettings.xml (AHFSettings(x64).xml for Windows x64 version) file that exists in the application data directory.

Font

Font Setting

The font installed in Windows and the font specified in the Font Configration File are displayed in the drop down list for the font selection. * is added to the font name specified in the Font Configdration File. V6.2MR7

  • Default Font Family

    Specifies the generic font family to use automatically when there is no setting of the font family in the FO or CSS. If a generic font family is specified in the FO or CSS, this setting is ignored. The following five generic font families can be defined:

    • serif
    • sans-serif
    • cursive
    • fantasy
    • monospace

    Please refer to the following [Generic Font] for more detail.

  • Generic Font

    Maps actual fonts to each generic font family. Generic font families specified in the FO replace those specified here. These settings are adopted for those generic font families not specified in the FO or CSS.

    <fo:block font-family="serif">
    

    Generic font families are symbolic names defined in CSS2 Specification. XSL Specification derives the generic font family from the CSS2 Specification.

    Serif font families are fonts which have a slight projection at the end of a letters/glyphs such as Mincho (Japanese) and Times New Roman. Sans-serif font families have plain stroke endings for their letters/glyphs and corresponds to fonts such as Gothic (Japanese), Helvetica and Arial. Cursives are font families that have connected strokes and Italic typefaces for its glyphs such as Soushotai (Japanese). Fantasy fonts are primarily decorative. Monospace is a font family that its font pitch is fixed, such as Courier.

  • Script

    The Script setting lets you set the generic font families to be used for 10 different writing systems. This includes Japanese, Chinese Simplified, Chinese Traditional, Korean, Latin, Cyrillic, Greek, Arabic, Hebrew and Thai. Each of the 10 writing systems can have its own set of generic font families defined.

  • Generic Font for Script

    Fonts specified in the FO or CSS supersede the Generic font settings. When fonts are not defined in the FO or CSS then these settings are adopted.

    The following examples illustrate which fonts would be used if serif was specified as the generic Font, the font-family and script properties are not specified in FO or CSS, and the script for the text is unclear.

    1. <fo:block>TEXT...

      The font specified in the serif combo box in Generic Font is used for the TEXT.

    2. <fo:block font-family="sans-serif">TEXT...

      The font specified in the sans-serif combo box in Generic Font is used for the TEXT.

    3. <fo:block script="ja">TEXT...

      The font specified in the serif combo box in Generic Font for Serif for Japanese is used. If it is not specified, the font specified in the serif combo box in Generic Font is then used.

    4. <fo:block script="ja" font-family="sans-serif">TEXT...

      The font specified in the sans-serif combo box in Generic Font for sans-serif for Japanese is used. If it is not specified, the font specified in the sans-serif combo box in Generic Font is then used.

    Please refer to Font Selection to learn how to select fonts for more details.

  • Use Same Font

    Specifies whether to use the same font to the generic font for script. If the same font is used, the font that was specified for serif will also be used for the other scripts. V6.3

  • Reset Font Settings

    Check Reset Font Settings to reset all font settings to the default.

Format

Format Setting

  • Default CJK Language

    When the script is not explicitly specified, there may be cases where it is hard to distinguish CJK (Chinese/Japanese/Korean) in Kanji. In such cases, the setting here is adopted. Select the appropriate CJK language from the followings.

    • jpn Japanese
    • kor Korean
    • zho-CN Chinese Simplified
    • zho-TW Chinese Traditional

  • Full width Punctuation Trimming

    Specifies whether to trim the full-width punctuation in Japanese. This setting affects the value of the extension properties, axf:punctuation-trim="auto" and axf:text-justify-trim="auto".

  • Ideograph-alphanumeric Spacing

    Specifies whether to add space between Japanese text and Western text. This setting affects the value of the extension properties axf:text-autospace="auto". When checked this, it is equivalent to axf:text-autospace="ideograph-numeric ideograph-alpha".

  • Pair Kerning

    Specifies whether to process pair kerning. This setup affects the value of the axf:kerning-mode="auto" extension property.

  • Latin Ligature

    Specifies whether to process ligatures for European languages. This setup affects the value of the axf:ligature-mode="auto" extension property.

  • Normalize V6.3 no-LT

    Specifies whether to normalize Unicode (UAX#15: Unicode Normalization Forms) for texts in FO and XML. This setting affects the value of the extension property axf:normalize="auto.

  • Underline in Vertical Writing-mode

    Specifies whether to place the underline on the right side of the text or on the left side of the text in vertical writing-mode. When 'auto' is specified, if the language in the language property is Japanese(jpn) or Korean(kor), the underline is placed on the right side. If there is no language property specified, it depends on the standard CJK language setting. This setting affects the value of the extension property axf:vertical-underline-side="auto".

  • Default Font Size

    This setting is used to specify the font size when the font size is not specified in the FO or CSS.

  • Default Line-Height

    This setting is used to specify the line-height to be used when specified as a property in the FO or CSS. The value must be specified as a ratio against the font size in ems.

Color, Border, Unit

Color, Border, Unit

  • Default Color

    Specifies the foreground color to be used when the color property is not specified in the FO or CSS. Function values, such as rgb-icc() can be specified. For example when specifying as cmyk (0001), it'll be K100. it's possible to choose the color by a button. The indicated color sample is RGB. When specifying the color other than RGB or the color including alpha value, an approximate color will be displayed. V6.3

  • Border Width

    Specifies the actual border width of the three symbolic values; thin, medium and thick that can be written in FO or CSS.

    <fo:block border-width="thin">
    

  • px unit size

    Specifies the conversion factor for px (pixel) units written in FO or CSS as a point number per inch. This value is actually used when the formatted results are outputted to a browser or PDF. In XSL, you can specify 'pixel' as a unit of measurement. Pxpi specifies the coefficient, which converts the value of the specified pixel, as "the number of pixels per inch" when formatting. It's specified with the real-type numeric value. The initial value is 96.

Page

Page Setting

  • Default Page Size

    Specifies the page size to be used when the page-width and page-height properties are not specified in the FO or CSS. The page size selected from the combo boxes reflects the [Width] and [Height]. The page size can be changed arbitrarily. If you change the orientation of the page in the [Orientation] in this dialog, the value of the [Width] and [Height] are swapped.

  • Default Margin

    Specify the margin of a page applied to FO or CSS when there is no specification of the margin.

  • Applied to CSS

    When there is no margin specification by @page in CSS, the value specified in Default Margin is applied to CSS. The margin becomes zero when there is no check.

  • Applied to XSL

    When there is no margin specification in fo:simple-page-master in XSL, the value specified in Default Margin is applied to XSL. The margin becomes zero when there is no check.

XSLT

Specifies the settings regarding XSLT Processors. See also XSLT Settings for more details.

XSLT Setting

  • Use MSXML

    Select the [Use MSXML] check box to use MSXML as the XSLT Processor.

    CAUTION: XSLT conversion may fail with the strengthened security in MSXML6. For example, an XSLT that includes <xsl:script language="JScript"> may produce an error. Please adjust the MSXML settings in the Option Setting File.

  • Use External XSLT Processor

    Select the [Use External XSLT Processor] check box to use an external XSLT Processor. You have to specify the command-line format of the XSLT Processor to use in [Command] and specify the Parameter format of xsl:param in [%param]. If the command-line format is not specified, then MSXML will be used.

  • xsl:param

    Specifies the parameter name and the parameter value of xsl:param given to an XSLT Processor. Press [Add...] to add parameters or press [Delete] to delete a selected parameter.

Example settings for some major XSLT Processors.

  • msxsl
    command:msxsl %1 %2 -o %3 %param
    %param:%p=%v
  • Xalan
    command:java -cp xalan.jar org.apache.xalan.xslt.Process -IN %1 -XSL %2 -OUT %3 %param
    %param:-PARAM %p %v
  • Saxon
    command:java -cp saxon.jar com.icl.saxon.StyleSheet -o %3 %1 %2 %param
    %param:%p=%v
  • Saxon-HE 9.6
    command: java -cp saxon9he.jar net.sf.saxon.Transform -s:%1 -xsl:%2 -o:%3 %param
    %param: %p=%v
  • libxslt
    command:xsltproc --output %3 %param %2 %1
    %param:--param %p %v
CAUTION: The examples shown here are provided as a guide and may be inaccurate. Please refer to the official site and the documentation for your XSLT processor.

CSS

CSS Setting

Settings of CSS for HTML.

  • HTML Default Charset

    Specifies the default charset of HTML. The default value is UTF-8. Please choose one from the list or input a charset you want to specify. The character set in the Supported Encoding can be specified.

  • User Stylesheets

    Sets CSS that the user uses. The stylesheets specified here are applied in the specified order after applying the default stylesheet (html.css). Sample user stylesheets are included in [Install directory]/UserStylesheets (Windows version) or in [Install directory]/etc/UserStylesheets (non-Windows version). See also Cascading Order of CSS.

PDF Option Setting Dialog

You can use the PDF Option Setting Dialog to set items in the Option Setting File related to PDF. When you click the [OK] button, your changes made here are written out to the AHFSettings.xml (AHFSettings(x64).xml for Windows x64 version) in the application data directory.

Version

PDF Version

  • PDF Version

    Selects the PDF version to output from the following:

    PDF Version Based on
    PDF1.3 Acrobat 4.0
    PDF1.4 Acrobat 5.0
    PDF1.5 Acrobat 6.0
    PDF1.6 Acrobat 7.0
    PDF1.7 Acrobat 8.0
    PDF/X-1a:2001 no-LT ISO 15930-1:2001 (based on PDF1.3)
    PDF/X-3:2002 no-LT ISO 15930-3:2002 (based on PDF1.3)
    PDF/X-1a:2003 no-LT ISO 15930-4:2003 (based on PDF1.4)
    PDF/X-2:2003 no-LT ISO 15930-5:2003 (based on PDF1.4)
    PDF/X-3:2003 no-LT ISO 15930-6:2003 (based on PDF1.4)
    PDF/X-4:2008 no-LT ISO 15930-7:2008 (based on PDF1.6)
    PDF/A-1a no-LT ISO 19005-1:2005 (based on PDF1.4)
    PDF/A-1b no-LT ISO 19005-1:2005 (based on PDF1.4)

    In the Option Setting File, this can be specified by setting the value of the pdf-version.

    PDF/X and PDF/A cannot be selected with AH Formatter V6.3 Lite.

  • Fast Web View no-LT

    Specifies whether to generate Linearized PDF. Linearized PDF enables PDF files to be viewed much faster over the Web by enabling viewing of the PDF as soon as the first page is downloaded rather than requiring that the entire PDF file be downloaded before it can be viewed. To linearize a PDF file is a two-step process: first, a standard PDF file is produced; second, the standard PDF file is linearized. This can also be specified in the Option Setting File by setting the value of linearized.

  • Tagged PDF no-LT

    Specifies whether to create Tagged PDF. Also in the Option Setting File, it can be specified by setting the value of tagged-pdf. This setting is not available when the PDF version is PDF1.3, or with AH Formatter V6.3 Lite.

  • Allow Importing Tagged PDF no-LT

    Specifies whether to allow tagged PDF to be embedded within tagged PDF. Also in the Option Setting File, it can be specified by setting the value of import-tagged-pdf. See also PDF Embedding for more details. This setting is not available with AH Formatter V6.3 Lite. V6.2MR2

  • Error on PDF/X or PDF/A fault no-LT

    Specifies whether to proceed with formatting if the incompatible content cannot be avoided, for example, a non-embeddable font or any incompatible image is specified when creating PDF/X or PDF/A.

    • If the check box is cleared, the formatting continues, but the generated PDF may be incompatible with PDF/X or PDF/A. For example, if an image is incompatible, it will be embedded as is, or otherwise, the image, format or color space will be converted according to transparent-image, etc. In this case, please note that the color of the image may differ from the original.
    • If the check box is checked, an error will be detected and a PDF file will not be generated. If the incompatible content can be avoided, it will be avoided and the formatting will be continued. For example, annotations in PDF/X will be thrown away.

    Also in the Option Setting File, it can be specified by setting the value of error-on-pdfx-fault.

Font

You can use this tab to determine which fonts can be embedded in PDF output.

Font

Select the target fonts you want to embed in PDF from the [Fonts List]. Press the [>>] button to move the selected fonts to [Always Embed]. If you want to delete fonts from [Always Embed], select the fonts then press the [<<] button.

Font names that appear dimmed are not available to embed. For example, if you previously added a font to the font list in the Option Setting File and that font cannot be embedded, the font name will appear dimmed in the Fonts List.

Fonts denoted with * mean that they are fonts which are not installed in the Windows font folder. Fonts denoted with ** mean that they are fonts which are not external characters provided according to the registry information. Please also see windows-registry for details.

When the PDF version is PDF/X or PDF/A, none of the items in this tab are available.

  • When Embedding Fails

    This option lets you select what you want the system to do if embedding of a font fails.

    Select either:

    [Replace White Space] to continue embedding font. The font is replaced with white space and will be embedded.

    [Stop the Job] to stop embedding. An error will be reported and the PDF generation will be stopped. Also in the Option Setting File, it can be specified by setting the value of the error-on-embed-fault.

  • Embed All Embeddable Fonts

    Check [Embed All Embeddable Fonts] to embed all embeddable fonts in PDF. If this option is selected, the fonts in the [Font List] and [Always Embed] appear dimmed. Also in the Option Setting File, it can be specified by setting embed-all-fonts.

  • Embed Standard 14 Fonts

    Usually, the Standard 14 Fonts are not embedded even when the [Embed All Embeddable Fonts] check box is selected. However, by also selecting the [Embed Standard 14 Fonts] check box, the Standard 14 Fonts can be embedded.

  • Error on Missing Glyph

    Specifies whether to break off the processing and report an error when the specified font does not include a glyph corresponding to a character to be displayed. Even if PDF is generated without checking this item, the character will be displayed as either a white space or a small box in PDF for missing glyph. Also the glyph might actually not exist in the specified font even when AH Formatter GUI. Also in the Option Setting File, it can be specified by setting the value of error-on-missing-glyph.

  • Subset embedded fonts when percent of character used is less than:

    Specifies the percent of characters used in a font above which the entire font is embedded. When the percentage of characters used is less than the specified value, AH Formatter V6.3 instead embeds a subset of the font that is the characters that are actually used. Also in the Option Setting File, it can be specified by setting the value of the embed-subset-font-percentage.

Security

Security

When the PDF output format is PDF/X or PDF/A, many items in this page are not available.

  • Require a password to open the document

    Specifies whether a password is required to open a PDF output document.

  • Document Open Password

    Specifies the password to open the PDF document. The contents of this setting is not written to the Option Setting File.

  • Restrict editing and printing of the document. A password will be required in order to change these permission settings

    Specifies whether a password is required to change the restrictions on printing or editing PDF output documents. When this is not selected, there are no restrictions.

  • Change Permissions Password

    Specifies the password for changing the restrictions on printing or editing PDF documents. The contents of this setting is not written to the Option Setting File.

  • Printing Allowed

    Specifies what printing of the PDF output documents is allowed. The available options depend on the PDF output version. Select from the following for PDF 1.3:

    • None
    • High Resolution

    Select from the following for PDF 1.4 or later:

    • None
    • Low Resolution (150 dpi)
    • High Resolution

  • Changes Allowed

    Specifies what changes to PDF documents are allowed. The available options depend on the PDF output version. Select from the following for PDF 1.3:

    • None
    • Commenting, filling in form fields, and signing signature fields
    • Page layout, filling in form fields, and signing signature fields
    • Any except extracting of pages

    Select from the following for PDF 1.4 or later:

    • None
    • Inserting, deleting and rotating pages
    • Filling in form fields, and signing signature fields
    • Commenting, filling in form fields, and signing signature fields
    • Any except extracting of pages

  • Enable copying of text, images and other content

    Specifies whether to allow copying of text, images and other content from PDF output documents to the clipboard. Note that the check box label changes when the PDF output version is PDF 1.3.

  • Enable text access for screen reader devices for the visually impaired

    Specifies whether to allow text access for screen reader devices in the PDF document. This setting is effective with PDF 1.4 or later.

  • Encrypt Metadata

    Specifies whether to also encrypt metadata when encrypting data with a password. This setting is valid only when [Require a password to open the document] or [A password will be required in order to change these permission settings] is checked in PDF1.5 or later. V6.3 no-LT

Compression

Compression

  • Color Images, Grayscale Images, Monochrome Images

    These groups apply to raster images only. They specify the downsampling and compression method to apply to color images, grayscale images and monochrome images.

  • Downsampling

    Selects the method of a downsampling from the following:

    • None
    • Average
    • Bicubic
    • Subsampling

    For values other than None, this specifies that an image with a dpi greater than the second dpi value is downsampled to the first dpi value. Also in the Option Setting File, downsampling of Color Images can be specified by setting color-downsampling; of Grayscale Images by setting grayscale-downsampling; and of Monochrome Images by setting monochrome-downsampling.

  • Compression

    For color images and grayscale images, the available compression methods are:

    • Automatic (JPEG)
    • ZLIB
    • JPEG
    • JPEG2000
    • KeepLZW (JPEG)
    • Automatic (JPEG200) V6.3
    • KeepLZW (JPEG2000) V6.3

    Select Automatic (JPEG) to compress the image using either JPEG or ZLIB compression, depending on which produces the smaller image data size. When KeepLZW (JPEG) is selected, if the original image is LZW compressed, then LZW compression is used; if not, it behaves the same as Automatic. JPEG2000 compression is not used with the Automatic option.

    JPEG compression is available when the following criteria are met; if not, ZLIB compression is used.

    • BitsPerComponent is 8
    • The color space is any of CMYK, RGB, grayscale or CIE L*a*b*.

    JPEG2000 compression is available when the following criteria are met; if not, JPEG compression is used.

    • PDF version is PDF1.5 or later
    • BitsPerComponent is 8
    • The color space is any of RGB, grayscale or CIE L*a*b*.

    Automatic (JPEG2000) and KeepLZW (JPEG2000) are equivalent to Automatic (JPEG) and KeepLZW (JPEG) each, except that compression will be done with JPEG2000 instead of JPEG. Please note that compression will be done with JPEG if JPEG2000 is not available.

    For monochrome images, the available compression methods are:

    • CCITT Group 4
    • CCITT Group 3
    • Run Length
    • ZLIB
    • None

    Compression will not be performed if the image data size would increase by applying compression.

    In the Option Setting File, Color Images can be specified by setting color-compression; Grayscale Images by setting grayscale-compression; and Monochrome Images by setting monochrome-compression.

  • JPEG Quality

    Specifies image quality of the color image and the grayscale image from 1 to 100 when JPEG compression is used. This value is converted to the compression ratio to use for JPEG2000 compression.

    The numerical value indicates the value that corresponds to -pjq of the command-line interface, etc. Also in the Option Setting File, Color Images can be specified by setting the value of the color-jpeg-quality, Grayscale Images can be specified by setting the value of the grayscale-jpeg-quality.

  • Pass Through

    Specifies whether to embed the image in PDF as is (pass-through) or set image settings such as compression and JPEG quality upon processing it. If both pass-through and downsampling are specified, downsampling will precede pass-through. In the Option Setting File, the values can be specified by using pass-through, pass-through-default and pass-through-minimum. V6.3 no-LT

    In the Option Setting File, when the image type to be passed through (other than all and none) is specified by using either pass-through, pass-through-default or pass-through-minimum, you can put one of the three types of checkmarks (bold, gray and no checkmarks) in the Pass Through checkbox. When the bold checkmark is given, all is specified. When the box is unchecked, none is specified. And then when the gray checkmark is given, a value other than all or none is given. This value will appear next to the Pass Through checkbox.

  • Text and Line-Art Compression

    Specifies whether to compress the text and the line art in the PDF to make the PDF size smaller or not. Also in the Option Setting File, it can be specified by setting the value of the text-and-lineart-compression.

  • Object Compression

    Specifies whether to compress the object other than text and the line art in the PDF to make the PDF size smaller or not. It's effective only when the version of PDF to output is 1.5 or more and Text and Line Art Compression in the PDF Option Setting is checked. Also in the Option Setting File, it can be specified by setting the value of the object-compression.

  • Reset Default Settings

    Returns all the compression settings to the default values. In the Option Setting File, the values can be specified by using color-compression-default , grayscale-compression-default and monochrome-compression-default, etc. V6.3 no-LT

  • High Compression Settings

    Sets the compression settings to high. When applied, the PDF file size will get smaller but the image quality will get lower accordingly. In the Option Setting File, the values can be specified by using color-compression-minimum , grayscale-compression-minimum and monochrome-compression-minimum , etc. V6.3 no-LT

    For details about the settings, please also refer to Miscellaneous in PDF Output.

Others

Others

  • External Destination Link with Local File

    Specifies the way to transform the external destination links with local file to the PDF link property. Select from one of the following: Also in the Option Setting File, it can be specified by setting the value of the use-launch-for-local-file.

    • Open File
    • World Wide Web Link

  • RGB Conversion

    Specifies how to convert the RGB color space to DeviceGray or CMYK.

    • No Conversion

      Does no conversion. DeviceRGB is outputted.

    • Black to DeviceGray

      Converts Black to DeviceGray, converts the others to DeviceRGB before outputting.

    • Gray to DeviceGray

      Converts Gray color (mono tone) to DeviceGray, converts the others to DeviceRGB before outputting.

    • All RGB to DeviceGray

      Converts the RGB colors to DeviceGray before outputting. This conversion is based on the following formula: gray = 0.3×red + 0.59×green + 0.11×blue (0.0 ≤ red,green,blue ≤ 1.0).

    • All RGB to CMYK

      Converts the all RGB colors to CMYK before outputting.

    In the Option Setting File, it can be specified by setting the value of the rgb-conversion. SVG, CGM, MathML, EMF and WMF that are drawn using their own drawing engine will be converted similarly. The other image types will be processed in the following ways:

    • When "All RGB to DeviceGray" or "All RGB to CMYK" is selected, conversion will be made to them. Please note that conversion will not be made with AH Formatter V6.3 Lite. V6.3 no-LT
    • When other than "All RGB to DeviceGray" or "All RGB to CMYK" is selected, no conversion will be made to them.

    When PDF/X-1a is specified to create, it is considered that all are converted to CMYK. At that time the combo box is displayed in gray color. See also PDF/X for the handling of RGB in PDF/X.

  • Convert Transparent Image to Opaque V6.3

    Specifies whether to convert the transparent images that will be embedded in PDF to opaque. In the Option Setting File, this setting can be specified with transparent-image.

  • Output ICC Profile in Images

    Specifies whether to output a ICC profile of images contained in an original image also to PDF. Also in the Option Setting File, it can be specified by setting the value of the image-color-profile.

  • Output Page Labels

    When FO with plural fo:page-sequence is outputted to PDF and displayed with Adobe Acrobat or Reader, the page number in the lower part of the window is shown like 1 (1/9). This is a function of the page label. If this check is turned OFF, the page label is not displayed but only the page number can be displayed. Also in the Option Setting File, it can be specified by setting the value of the page-labels.

  • PDF Embedding V6.2MR1

    Specifies the embedded PDF.

  • Import All Annotations V6.2MR1

    Imports all embeddable annotations contains in the embedded PDF. When specifying the embedded annotations individually, select them from the following: Specify Other when the embedded annotation is not included in the selections.

    • Text
    • Link
    • FreeText
    • Line
    • Square
    • Circle
    • Polygon
    • PolyLine
    • Highlight
    • Underline
    • Squiggly
    • StrikeOut
    • Stamp
    • Caret
    • Ink
    • Popup
    • FileAttachment
    • Sound
    • Movie
    • Screen
    • 3D
    • Other

    In the Option Setting File, it can be specified by setting the value of the import-annotation-types.See also PDF Embedding for more details.

Other Settings Dialog

SVG Option

SVG Output

In SVG Option in the Other Setting Dialog, the item concerning SVG set in the Option Setting File is adjusted. The contents changed here are written out to AHFSettings.xml (AHFSettings(x64).xml for Windows x64 version) which exists in the application data directory by clicking the [OK] button.

  • SVG Version

    Selects the version of SVG to output from the followings:

    • SVG 1.1
    • SVG Basic
    • SVG Tiny

  • Image Processing

    Specifies whether to embed or link images to SVG.

    • Embed
    • Copy and Link All Images
    • Link External Images
    • Copy and Link External Images

    Please refer to Image Output in SVG Output for details.

  • GZIP Compression

    Outputs GZIP compressed svgz. The extension is set to .svgz.

  • Embed Fonts

    Embeds fonts in SVG. Certain fonts might not be able to be embedded correctly.

  • Output to Single File

    Specifies whether pages are outputted as one SVG file, or each page is outputted as an individual file when outputting two or more pages. When outputting two or more SVG, page numbers are placed before the extension of the output file name. For example, if the specified file name is document.svg, page numbers are put as document1.svg, document2.svg,... The number format can be set in Option Setting File, etc.

  • Numbering to One Page File

    When Output to Single File is not specified, specifies whether the number is placed to the output file name even if SVG has only one page.

Editors

Editors

Edits the target document or stylesheet using the editor specified here. This setting can be used from [Edit Document] on the Edit menu or [Edit StyleSheet] on the Edit menu.

Window

Window

  • Starting Window Position

    Specifies the position of Window in GUI when starting up. Select the [Fixed Position], click the [Current Position] button to input the current information.

  • No Gutter Between Two Facing Pages

    Specifies whether to apply the gutter between the facing pages or not.

  • Show Border

    Used to confirm how the formatted result is divided in areas. The border does not affect PDF Output or Print, etc. This is the same as the [Show Border] in the menu. In case of MathML, the border will be shown for each element. V6.3

  • Border Color

    Displays the Color Dialog. Possible to specify the border color. V6.3

  • with Baseline

    Specifies whether to display the text baseline in addition to the borders of areas. The border does not affect PDF Output and Print, etc. In case of MathML, either the baseline or the centerline will be shown. V6.3 V6.3MR1 no-LT

  • Specify Baseline Color

    Specifies the color of the baseline. If not specified, the color will be calculated from the color of the characters. V6.3 no-LT

  • Baseline Color

    Displays the Color Dialog. Possible to specify the baseline color. V6.3 no-LT

Others

Others

  • Keep Output Directory

    Specifies whether to remember the previous position of the directory used as the standard of a file name in the PDF Output Dialog, etc. If it's not checked, the same directory as the formatted document is assumed.

  • Output Log File

    The information shown in the log window is saved as AHFormatter.log in the application data directory. The information in this file will be deleted when AHFormatter.exe is invoked.

  • Display ToolTip on Area

    Specifies whether to display the information about the area as a ToolTip when a mouse is pointed on an area on the screen such as a character string or an image. A ToolTip automatically disappears by moving a mouse or reaching the specified display time.

  • Page Limit

    This is used to control the maximum number of formatted pages for a very large document that a user wants to make available for display in the GUI. A large amount of memory is necessary to display a large number of pages. By specifying an appropriate value it is possible to improve the efficient working of the system. See also Restrictions for more detail. But, there is no such a restriction with other interfaces, such as Command-line Interface, etc.

  • Unit

    The unit shown in GUI can be selected from the following. The ruler can be displayed from the view menu.

    • cm
    • mm
    • in
    • pt
    • pc
    • px
    • q

  • Smoothing

    Specifies whether to process the anti-aliasing in the printing or GUI. This can be specified for the following.

    • Text
    • Line-Art
    • Image

  • Language

    Selects the language displayed on GUI. Changes are reflected when restarting the application.

    • English
    • Japanese
    • System Language

    CAUTION: It does not influence neither the [Cancel] button nor standard dialogs displayed by Windows.

Import Option Setting Dialog

This enables you to load an Options Setting File with previously saved main preferences from the Option Setting Dialog. By default if the AHFSettings.xml (AHFSettings(x64).xml for Windows x64 version) file exists in the application data directory this file is automatically loaded at startup as the option setting file. The application data directory is indicated by the environment variable, APPDATA. [APPDATA]\AntennaHouse\AHFormatter\6.3\

Export Option Setting Dialog

Writes the current setting to the Option Setting File. Main setting contents can be referred to in the Option Setting Dialog.

About Dialog

Displays the version of AH Formatter V6.3 and the license information. If you are using an evaluation license the evaluation period remaining can be confirmed here.

Run with Parameters

You can use the parameters shown below when you start the AHFormatter.exe GUI program.

Parameter Default Functions
-s If AH Formatter V6.3 has already been invoked, the formatting will be executed with the already running AH Formatter V6.3. If this parameter is not specified, another AH Formatter V6.3 will run.
-d Document Specifies the URI of the source XML/FO/HTML document. The GUI window is displayed.
-t Stylesheet Specifies the URI of the XSL/CSS stylesheet that is used for formatting. Must be used in combination with the -d, -p or -pt parameter.
-p Document AH Formatter V6.3 prints the document by displaying the Print Dialog without also displaying the GUI window. Cannot be used in combination with the -s parameter.
-pt Document Printer-Name AH Formatter V6.3 prints the document without displaying either the GUI screen or the Print Dialog. If Printer-Name is omitted, the default printer is used. Cannot be used in combination with the -s parameter.
-pts Document Printer-Name Same as the -pt parameter, but prints the document without displaying the stop dialog box while printing. If Printer-Name is omitted, the default printer is used. Cannot be used in combination with the -s parameter.
-ps Printer-Setting-File Specifies the path name of the Printer Setting file. Please refer to "How to create a Printer Setting file". When the XML document is specified by -d, please print the document by displaying the Print Dialog.
-c Copies 1 Specifies the number of copies to print. Must be used in combination with the -pt or -pts parameter. If it's omitted, the value is counted as 1.
-pdf Document PDF-File AH Formatter V6.3 outputs the formatted document to PDF by displaying the PDF Output Dialog without displaying the GUI window. PDF-File can be omitted. Cannot be used in combination with the -s parameter.
-pdft Document PDF-File AH Formatter V6.3 outputs the formatted document to PDF in the specified file without displaying either the GUI window or the PDF Output Dialog. Cannot be used in combination with the -s parameter.
-pdfts Document PDF-File Same as the -pdft parameter, but outputs the formatted document to PDF without displaying the stop dialog box while outputting PDF. Cannot be used in combination with the -s parameter.
-param name=value Specifies the name and value of a single xsl:param. If the value contains white space, please specify as "name=value". -param can be specified multiple times.

Restrictions

The GUI has certain formatting restrictions that do not apply when using the other interfaces.