Graphical User Interface

AH Formatter V6.2 Windows version has a Graphical User Interface (GUI). By using the GUI, you can easily initiate formatting and then view the formatted results on the browser prior to outputting to PDF or print. 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 on very large runs saving considerable time.

The GUI also lets you save the resulting XSL-FO file from XSLT. 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.2 consists of following elements.

GUI Window

  1. Title Bar

    The title bar shows the name of the original file being formatted; the stylesheet (XSL file) if formatting an XML file; and if in the <title> of HTML, FO file <fo:title> or if <axf:document-info> extension property, the 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, you can use the hand tool as the mouse pointer on the WYSIWYG window to move the page around so that you can view all the areas on it while pressing the left mouse button. In addition, it does not become a hand tool when the [Text Select] mode is selected in the Edit menu.

    You can format various files by dropping on this window. When you drop a file on this window, the type of file will be detected automatically. If you'd like to specify the file type, please open the file using the Document/Stylesheet Dialog. The dropped file will be added to the <Recent File> of a File menu and the file type will also be memorized. Therefore, when you choose the file dropped and saved in the Recent File, the file type will be detected again automatically. Formatting pattern by the file type is as follows: (See also Detection of Formatting Type to learn about the automatic detection.)

    • FO file
      Starts formatting immediately.
    • Stylesheet (XSL/CSS)
      When you drop the associated stylesheet on the formatted result, formatting starts with the dropped stylesheet. If not, it starts formatting after dropping an XML/HTML document combined with the stylesheet together.
    • 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 XML/HTML.
    • XML/HTML file (without XSL/CSS specification in XML/HTML) + Stylesheet (XSL/CSS)
      Formats the document using the stylesheet dropped together.
    • XML/HTML file (with XSL/CSS specification in XML/HTML) + Stylesheet (XSL/CSS)
      Formats the document using the stylesheet dropped together.
    • Graphics file
      The graphics file is rendered in the window when it is the Graphics supported by AH Formatter V6.2.

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

    When a mouse is pointed on an area on the screen such as 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

    As for the font name, some font names are displayed in order to show the difference between the specified font and the font actually adopted. Also refer to [Display Glyph] in the menu.

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

    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 final line of information is the time it took to format the document. The log window has its own scroll bar for viewing the information.

    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.2, the position and the size of the GUI are stored. Formatter restarts at that same position and size.

Menu

  1. File
    Menu Shortcut Description
    Open... Ctrl+ O Displays the Document/Stylesheet Dialog.
    Close Ctrl+ W Close the displaying formatted results.
    Save AreaTree... Displays the Save AreaTree Dialog. no-LT
    Save FOTree... Displays the Save FOTree Dialog.
    Save FO... Displays the Save FO Dialog.
    Print... Ctrl+ P Displays the Print Dialog.
    PDF Output Ctrl+ D Displays the PDF Output Dialog.
    SVG Output... Displays the SVG Output Dialog.
    PostScript Output... Displays the PostScript Output Dialog.
    XPS Output... Displays the XPS Output Dialog.
    INX Output... Displays the INX Output Dialog.
    MIF Output... Displays the MIF Output Dialog.
    Text Output... Displays the Text Output Dialog. no-LT
    Document Information... Display the Document Information Dialog.
    <Recent File> Displays the files that are recently formatted.
    Exit Alt+ F4 Exits AH Formatter V6.2.

  2. Edit
    Menu Shortcut Description
    Text Select Enables you to select the text on the WYSIWYG window with the mouse.
    Copy Ctrl+ C Copies the selected text to the clipboard.
    Select All Ctrl+ A Makes all the texts on the WYSIWYG window into selection mode.
    Deselect Cancels selection mode of the text.
    Edit Document Ctrl+ U Edits the target XML document or stylesheet using the editor specified in the external editor page in the Other Settings Dialog.
    Edit StyleSheet Shift+Ctrl+ U
    Search String... Ctrl+ F Displays the Search String Dialog.
    Search Property... Shift+Ctrl+ F Display the Search Property Dialog.
    Search Previous Shift+ F3 Searches previous from the position just before the search position.
    Search Next F3 Searches next from the position just before the search position.

  3. Move
    Menu Shortcut Description
    First Page Ctrl+ Home Goes to the first page.
    Previous Page Ctrl+ PageUp Goes to the previous page.
    Next Page Ctrl+ PageDown Goes to the next pate.
    Last Page Ctrl+ End Goes to the last page. When you stop formatting before finishing, the last formatted page will be displayed.
    Go To Page... Ctrl+ G Displays the Go To Page Dialog. This only functions in multi page documents. The current page position is shown in the Status Bar.
    Back Alt+ ← As you move through the pages of a document Formatter stores up to 10 moves. By using the Back and Forward you can step backwards or forwards through the pages viewed.
    Forward Alt+ →

  4. View
    Menu Shortcut Description
    Fit in Window Ctrl+ 0 Zooms the displayed size of the formatted page to automatically fit the entire page in the WYSIWYG window.
    Actual Size Ctrl+ 1 Sets the zoom ratio as 100%.
    Fit Page Width Ctrl+ 2 Automatically zooms the width of the formatted page to the width of the WYSIWYG window.
    Zoom In Ctrl+ + Changes the zoom ratio as follows:
    • 400%
    • 300%
    • 200%
    • 150%
    • 125%
    • 100%
    •  75%
    •  66.7%
    •  50%
    •  33.3%
    •  25%
    •  12.5%
    Values from 5% to 2000% can be entered in the Zoom Dialog. The current zoom ratio is shown in the Status Bar.
    Zoom Out Ctrl+ −
    Zoom... Ctrl+ M Displays the Zoom Dialog.
    Facing Page Specifies whether to display the formatted pages with Facing Pages or Single Page on the WYSIWYG window.
    Continuous Specifies whether to display the formatted pages on the WYSIWYG window continuously or not.
    Show Border Ctrl+ B Used to confirm how the formatted result is divided in areas. The border does not affect PDF Output or Print.
    Border Color... Displays the Color Dialog. Possible to specify the border color.
    Show Ruler Ctrl+ L Displays the ruler to confirm the position of the character, etc., in the document. The ruler can be moved to anywhere you like.
    Show Printer Mark Effective when formatting the document that includes printer marks. Specifies whether to display printer marks or not. no-LT
    Display Glyph Specifies whether the character is displayed dependent on Windows or displayed all with glyph outlines. In Windows, when displaying dependent on Windows, a font may be replaced and there is no guarantee that the font is displayed with the actually specified font.
    Tool Bar Specifies whether to show or hide the Tool Bar.
    Status Bar Specifies whether to show or hide the Status Bar.
    Log Window Specifies whether to show or hide the Log Window. The log window is automatically displayed when execute formatting.

  5. Format
    Menu Shortcut Description
    Format F5 Formats the current document (FO or XML+XSL etc.).
    Stop Format ESC Stops formatting. 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.
    Format Option Setting... Shift+Ctrl+ O Displays the Format Option Setting Dialog.
    PDF Option Setting... Shift+Ctrl+ P Displays the PDF Option Setting Dialog.
    Other Settings... Displays the Other Settings Dialog.
    Import Option Setting... Displays the Import Option Setting Dialog.
    Export Option Setting... Displays the Export Option Setting Dialog.
    Reset Option Setting... Resets the Option Setting File back to the default and reload the setting.
    Reloads Hyphenation Dic Reload Hyphenation Dictionary and format the document again.

  6. Help
    Menu Shortcut Description
    Online Manual F1 Displays this Online Manual.
    Q&A Displays the Q&A on the Internet.
    Mail to Support Sends mail to Antenna House Support. The necessary information such as serial number, etc., is embedded automatically. It's not available with the evaluation version and AH Formatter V6.2 Lite.
    Antenna House website Displays the Antenna House website on the Internet.
    About AH Formatter V6.2... Shift+ F1 Displays the About Dialog of AH Formatter V6.2.

Popup Menu

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 destination file in the formatted result on the current window.
Open New Window Opens a link destination in the formatted result, or current document with a new window.
Shell Open Opens a link destination in the formatted result, or current document with a shell.

The content in the Log Window depends on what 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 default.
Hide Hides the ruler.

Document/Stylesheet Dialog

Document/Stylesheet Dialog

Under the each edit box, the directory or the base URL is displayed, which indicate the base directory when the relative path is specified.

Click [OK] to start formatting.

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

Save AreaTree Dialog

The AreaTree is an XML representation of the formatted document 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.

It's not available to save and load the area tree with AH Formatter V6.2 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. If 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.

Print Dialog

Print Dialog

The print Dialog lets you output the formatted result to any printer installed or accessible from your Windows system. The user can select to print all pages, a range of pages, or selected pages. If formatting is not completed in the GUI Formatter reformats the document from the beginning for 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 affect Print Output.

See also Restrictions regarding print.

PDF Output Dialog

PDF Output Dialog

The PDF Output Menu enables outputting the formatted results to PDF by using the PDF 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 PDF. For this reason 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 affect 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.2 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 limitations.

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.2\ 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.

  • Reset Font Settings

    Check Reset Font Settings to reset all font settings to the default. Press [OK] to execute the setting.

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 for European languages. 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.

  • 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. The value must be specified in point.

  • 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. The following values can be used: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.

       Blackcolor="#000000"
       Bluecolor="#0000FF"
       Aquacolor="#00FFFF"
       Limecolor="#00FF00"
       Fuchsiacolor="#FF00FF"
       Redcolor="#FF0000"
       Yellowcolor="#FFFF00"
       Whitecolor="#FFFFFF"
       Navycolor="#000080"
       Tealcolor="#008080"
       Greencolor="#008000"
       Purplecolor="#800080"
       Marooncolor="#800000"
       Olivecolor="#808000"
       Graycolor="#808080"
       Silvercolor="#C0C0C0"

  • Border Width

    Specifies the actual border width of the three symbolic values; thin, medium and thick that can be written in FO or CSS. The value must be specified in pts (points).

    <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

XSLT Setting

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

  • Use MSXML

    Check [Use MSXML] to use MSXML as an XSLT Processor.

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

  • Use External XSLT Processor

    Check [Use External XSLT Processor] to use an external XSLT Processor. You have to specify the command-line format of a XSLT Processor to use to [Command] and specify the Parameter format of xsl:param to [%param]. It is considered that MSXML is used when the command-line is not specified.

  • xsl:param

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

Below shows examples of setting 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
  • libxslt
    command:xsltproc --output %3 %param %2 %1
    %param:--param %p %v
CAUTION: The example shown here may be inaccurate. Please refer to each site and document.

CSS

CSS Setting

Settings of CSS for HTML.

  • HTML Default Charset

    Specifies the default charset of HTML. The defaults 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

    Set CSS the user uses. The stylesheet specified here is applied by the specification order posterior to 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

In PDF Option in the Other Setting Dialog, the item concerning PDF 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.

Version

PDF Version

  • PDF Version

    Selects the PDF version to output from the followings:

    • 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 – ISO 15930-1:2001 (based on PDF1.3) no-LT
    • PDF/X-3:2002 – ISO 15930-3:2002 (based on PDF1.3) no-LT
    • PDF/X-1a:2003 – ISO 15930-4:2003 (based on PDF1.4) no-LT
    • PDF/X-2:2003 – ISO 15930-5:2003 (based on PDF1.4) no-LT
    • PDF/X-3:2003 – ISO 15930-6:2003 (based on PDF1.4) no-LT
    • PDF/X-4:2008 – ISO 15930-7:2008 (based on PDF1.6) no-LT
    • PDF/A-1a – ISO 19005-1:2005 (based on PDF1.4) no-LT
    • PDF/A-1b – ISO 19005-1:2005 (based on PDF1.4) no-LT

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

    PDF/Xor PDF/A cannot be selected with AH Formatter V6.2 Lite

  • Fast Web View

    Generates 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. generated first and then that file is linearized. Also in the Option Setting File, it can be specified by setting the value of the linearized.

  • Tagged PDF no-LT

    Creates the Tagged PDF. Also in the Option Setting File, it can be specified by setting the value of the tagged-pdf. When the created PDF is PDF1.3, or with AH Formatter V6.2 Lite Tagged PDF cannot be selected.

  • Allow Importing Tagged PDF no-LT

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

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

    Specifies whether to stop formatting as an error or ignore the unsuitable content and continue formatting when a content which is unsuitable for PDF/X or PDF/A is detected while creating PDF/X or PDF/A, such like PDF/X or PDF/A that contains non-embeddable fonts. If false is specified, the processing is continued, a generated PDF may be incongruent as PDF/X or PDF/A. If true is specified, PDF will not be generated as an error. When the unsuitable content is avoidable, the formatting continues. For example, annotations in PDF/X are thrown away. When an incongruent image is specified, the processing of an image differ by false or true. If false is specified, an image will be embedded as is, a generated PDF may be incongruent as PDF/X or PDF/A. When true is specified, the image format, the color space, etc. will be changed to make it suit. Note that the color may be changed in this case. Also in the Option Setting File, it can be specified by setting the value of the error-on-pdfx-fault.

Font

Font

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

Gray-colored fonts are not available to embed. Also there may be a case that a font that cannot be embedded is included in the Font list if you edited the font originally in the Option Setting File. Despite being in the list the font cannot be embedded

When PDF/X or PDF/A is specified to create, The items regarding embedding fonts in this page are displayed in gray color.

  • 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 checked the fonts in the [Font List] and [Always Embed] are displayed in gray color. Also in the Option Setting File, it can be specified by setting the value of the embed-all-fonts.

  • Embed Standard 14 Fonts

    Usually, Standard 14 Fonts are not embedded even if the [Embed All Embeddable Fonts] check box is checked, However, by checking the [Embed Standard 14 Fonts] check box, Standard 14 Fonts can be embedded.

  • Error on Missing Glyph

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

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

    Embeds all fonts when the percent of characters used is greater than or equal to the specified value, subsets embedded fonts when the percent of characters used is less than the specified value. Also in the Option Setting File, it can be specified by setting the value of the embed-subset-font-percentage.

Security

Security

When the outputted PDF format is PDF/X or PDF/A, many of items in this page are displayed in gray color.

  • Require a password to open the document

    Check here when specifying the password which opens a PDF document.

  • Document Open Password

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

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

    Check here when specifying the password which changes the authority regarding the restrictions on printing or editing PDF documents. When this is not checked, all the authority is given to those who open a PDF document.

  • Change Permissions Password

    Specify the password for changing the authority regarding the restrictions on printing or editing PDF documents. The contents of the setting here is not written out to the Option Setting File.

  • Printing Allowed

    Specifies whether to allow printing the PDF document or not. Select the operation form the followings in PDF 1.3.

    • None
    • High Resolution

    Select the operation form the followings in PDF 1.4 or later.

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

  • Changes Allowed

    Specifies whether to allow changing the PDF document or not. Select the operation form the followings in 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 the operation form the followings in 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 contents in the PDF document to the clipboard or not. In PDF1.3, the expression on the dialog may somewhat differ.

  • 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 or not. This setting is effective with PDF 1.4 or later.

Compression

Compression

  • Color Images, Grayscale Images, Monochrome Images

    This item applies raster image only. Specifies the downsampling and compression method of a raster image for each color images, grayscale images and monochrome images.

  • Downsampling

    Selects the method of a down sampling from the following.

    • None
    • Average
    • Bicubic
    • Subsampling

    In any case except for None, specifies an image of greater than what value of dpi is downsampled to what value of dpi. Also in the Option Setting File, Color Images can be specified by setting the value of the image-downsampling, Grayscale Images can be specified by setting the value of the grayscale-downsampling, Monochrome Images can be specified by setting the value of the monochrome-downsampling.

  • Compression

    Selects the compression method from the following for color images and grayscale images.

    • Automatic
    • JPEG
    • ZLIB
    • JPEG2000
    • KeepLZW

    Select Automatic to operate both JPEG compression and ZLIB compression, and adopt the one that produces the smaller size. When KeepLZW is selected, if the original image is LZW compressed, it becomes the LZW compression. If not, it becomes the same as Automatic. JPEG2000 compression is not taken into consideration.

    The JPEG compression is available with the following conditions. If not, it becomes the ZLIB compression.

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

    The JPEG2000 compression is available with the following conditions. If not, it becomes the JPEG compression.

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

    Selects the compression method from the following for monochrome images.

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

    When the size after processing is increased by these compressions, the compression will not be performed.

    In the Option Setting File, Color Images can be specified by setting the value of the image-compression, Grayscale Images can be specified by setting the value of the grayscale-compression, Monochrome Images can be specified by setting the value of the monochrome-compression.

  • JPEG Quality

    Selects the resolution from the following for color images and grayscale images.

    • Minimum (50)
    • Low (70)
    • Medium (80)
    • High (95)
    • Maximum (100)

    The numerical value on the right side 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 jpeg-quality, Grayscale Images can be specified by setting the value of the grayscale-jpeg-quality.

  • Rasterize Resolution

    Some vector images are converted into a raster image, and are stored in PDF. The resolution of the raster image created by the conversion is specified with the value of 70 to 500dpi. SVG, MathML, EMF, and WMF are rendered in PDF, without being converted into a raster image. Also in the Option Setting File, it can be specified by setting the value of the rasterize-resolution. However, MathML can be used only with "AH Formatter MathML Option" with AH Formatter V5.0 Lite.

  • 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.

Others

Others

  • External Destination Link with Relative Address

    Specifies the way to transform the external destination links with relative addresses 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-relative-uri.

    • 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. As for the images other than SVG, CGM, MathML, EMF or WMF, which are rendered using their own rendering engine, there is no conversion. The same is applied to the color in raster images. 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.

  • 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 Facing Pages

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

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 V6.2

    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.2\

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.2 and the license information. If you are using an evaluation license the evaluation period remaining can be confirmed here.

Run with Parameters

The GUI program AHFormatter.exe can be invoked with parameters.

Parameter Default Functions
-s If AH Formatter V6.2 has already been invoked, The formatting will be executed with the already running AH Formatter V6.2. If this parameter is not specified, another AH Formatter V6.2 will run.
-d XML-Document Specifies the URI of the target XML document. GUI screen is displayed.
-t XSL-Stylesheet Specifies the URI of the XSL stylesheet which is used for formatting. Invalid if one of the -d, -p, -pt parameters is not specified.
-p XML-Document Prints the XML document by displaying the Print Dialog, without displaying the GUI screen. The -s parameter is invalid.
-pt XML-Document Printer-Name Prints the XML document neither displaying the GUI screen nor displaying the Print Dialog. If Printer-Name is omitted, the standard printer is used. The -s parameter is invalid.
-pts XML-Document Printer-Name Same as the -pt parameter, but prints the XML document neither displaying the stop dialog box under printing. If Printer-Name is omitted, the standard printer is used. The -s parameter is invalid.
-ps Printer-Setting-File Specify 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 when printing and effective only when the -pt or -pts parameter is specified. If it's omitted, the value is counted as 1.
-pdf XML-Document PDF-File Outputs the XML document to PDF by displaying the PDF Output Dialog without displaying the GUI screen. PDF-File can be omitted. The -s parameter is invalid.
-pdft XML-Document PDF-File Outputs the XML document to PDF in the specified file neither displaying the GUI screen nor displaying the PDF Output Dialog. The -s parameter is invalid.
-pdfts XML-Document PDF-File Same as the -pdft parameter, but outputs the XML document to PDF neither displaying the stop dialog box under outputting PDF. The -s parameter is invalid.
-param name=value Specifies the parameter name and the value of xsl:param. If the value contains a white space, please specify "name=value". -param can be specified multiply.

Restrictions

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