Graphic Support

Any graphics as the external files can be specified to src property of <fo:external-graphic> or axf:background-image property of <fo:simple-page-master>. AH Formatter V5.3 detects the graphics format automatically. When the value of the content-type property is specified, it is assumed, then detected whether it conflicts or not. As the result if the specified value conflicts, then additional auto-detect will be done. In case of the image via HTTP, the content-type is given from the HTTP header. At that time it's assumed in preference to the value of the property.

In addition, the data scheme (RFC2397) can be specified to src property of <fo:external-graphic> or axf:background-image property of <fo:simple-page-master>. In other words, the content of the graphics can be specified in FO directly without preparing the external file.

<fo:external-graphic
src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAMAAABEpIrGAAAAB
3RJTUUH1AIFCDIuN9BfzQAAAAlw ... ="/>

It's not necessary to specify the media type in the data scheme, if specified, it is assumed.

The jar scheme defined in JarURLConnection can be specified. This is effective to JAR or ZIP and possible to specify the entry in it.

jar:http://www.foo.com/bar/baz.jar!/COM/foo/Quux.png

What is specified from after the first delimiter !/ is considered as the entry specification. The nest of JAR or ZIP is not supported.

AH Formatter V5.3 supports the following types of graphics. Unless otherwise noted they are supported across all platforms: Windows, Solaris/Linux/Macintosh/HP-UX/AIX.

When the specified image cannot be acquired because the image is not existent, etc., a dummy image will be displayed instead. However the image is specified to the background-image, a dummy image will not be displayed.

Supports Windows Bitmap. The content-type is "image/bmp".

Supports JFIF (JPEG File Interchange Format). The content-type is "image/jpeg".

Supports JPEG2000 of the following format.

• JP2 (The content-type is "image/jp2")

On GUI, the dummy image is displayed.

Supports Portable Network Graphics Format with the following restrictions:

• Alpha channel information is effective with PDF1.4 or later.
• 16 bit color depth image will be truncated to 8 bit depth.

The content-type is "image/png".

Supports the TIFF files of TIFF Revision 6.0 specification.

• No Compression
• PackBits Compression
• Modified Huffman
• CCITT Group3 1D
• CCITT Group3 2D
• CCITT Group4
• JPEG Compression
• LZW Compression
• ZIP Compression

Supports the following color expression.

• Grayscale
• RGB
• CMYK
• YCbCr
• CIE L*a*b*

Restrictions:

• Following formats are not supported.
  • Tiled Image
  • Planar Configuration=2(Planar format)
• A YCbCr image is transformed into an RGB image when outputting to PDF.
• Alpha channel information is effective with PDF1.4 or later.
• 16 bit color depth image will be truncated to 8 bit depth.
• Multi page TIFF images are not supported. Only the first image in the TIFF file will be processed.
• Some parts of the TIFF extensions cannot be loaded properly.

The content-type is "image/tiff".

Supports Graphics Interchange Format with some restrictions.

• In the case of Animation GIFs containing multiple pages, only the first page is displayed.

The content-type is "image/gif".

Supports Windows Metafile. The image quality is maintained by embedding the vector image in the PDF, SVG. The following restrictions currently exist:

• Only the horizontal value for the pen width can be used. If the value is 0.0, the drawing is not processed.
• The Bitmap specified for the brush is disregarded.
• The calculation of physical size may not correct.
• Clipping of Multiple rectangles is not supported.
• The raster operation is not supported. The original copied data is drawn as is.
• The function of clipping the characters is not supported.
• The background of the character is always transparent.
• The function of rotating the character from the baseline is not supported.

WMF in gzip file format is also supported. The content-type is "image/wmf".

Supports Enhanced Metafile. The image quality is maintained by embedding the vector image in the PDF, SVG. The following restrictions currently exist:

• Only the horizontal value for the pen width can be used. If the value is 0.0, the drawing is not processed.
• The Bitmap specified for the brush is disregarded.
• The calculation of physical size may not be correct.
• The raster operation is not supported. The original copied data is drawn as is.
• The function of clipping the characters is not supported.
• The background of the character is always transparent.
• The function of rotating the character from the baseline is not supported.
• The function of clipping the bottom drawing is not supported.

EMF in gzip file format is also supported. The content-type is "image/emf".

Supports Encapsulated PostScript. When there is a preview image in EPS, the image can be outputted. When there is no image, a dummy image will be reflected in the GUI. When generating PDF using Adobe Distiller or outputting to a PS printer, a PostScript code in EPS is outputted instead of a preview image.

In the environment where Adobe Distiller and Ghostscript are installed, you can utilize them when outputting EPS to PDF. At that time EPS can be embeded to PDF as EPS. Please refer to the Online manual to set EPS-processor in the option setting file.

It is possible to embed EPS code directly in FO. Therefore it is possible to embed EPS code in PDF with Adobe Distiller, etc. The following is a sample using <fo:instream-foreign-object>.

<fo:instream-foreign-object><![CDATA[%!PS-Adobe-3.0 EPSF-3.0
%%BoundingBox: 0 0 84 43
%%Pages: 0
%%Creator: Antenna House
%%Title: Green Rounded Box
%%CreationDate: 10 Feb 2003
%%LanguageLevel: 2
%%EndComments
%%BeginProlog
%%EndProlog
%%BeginSetup
%%EndSetup
%%Page: 1 1
%%BeginPageSetup
%%EndPageSetup
0 128 0 setrgbcolor
0.1 setlinewidth
newpath
0 5 moveto
0 43 84 43 5 arct
84 43 84 0 5 arct
84 0 0 0 5 arct
0 0 0 43 5 arct
closepath
gsave
stroke
grestore
fill
%%PageTrailer
%%Trailer
%%EOF
]]>
</fo:instream-foreign-object>

It is not necessary to have the CDATA section set, but appropriate character references are required.

EPS can be created by various kinds of software. For this reason, some of the EPS files may not generate the desired results when processed by AH Formatter V5.3. EPS without a preview image is not supported with the Solaris/Linux/Macintosh/HP-UX/AIX versions.

The content-type is "application/postscript".

Supports Scalable Vector Graphics (SVG) 1.1. AH Formatter V5.3 greatly enhances the display quality of SVG in PDF through a newly developed SVG native output engine. Please refer to "SVG Conformance" for more details. SVG in gzip file format is also supported.

It is also possible to describe SVG code directly in FO. The following sample uses <fo:instream-foreign-object>.

<fo:instream-foreign-object
    width="100mm" height="100mm"
    content-width="96mm" content-height="72mm"
    display-align="center" text-align="center">
<svg version="1.1" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 480 360">
 <circle cx="100" cy="100" r="50" fill="none" stroke="black" />
 <circle cx="220" cy="100" r="35" fill="red" stroke="black" />
 <circle cx="340" cy="100" r="20" fill="black" stroke="lime" stroke-width="4" />
 <circle cx="100" cy="260" r="20" stroke="lime" fill="yellow" stroke-width="4" />
 <circle cx="220" cy="260" r="35" stroke="none" fill="blue" />
 <circle cx="340" cy="260" r="50" stroke="red" fill="none" stroke-width="10" />
</svg>
</fo:instream-foreign-object>

If the correct xmlns is described in the svg tag, it's counted as SVG. If not, it's not counted as SVG.

If you want to include the DOCTYPE declaration in FO, please enclose it with the CDATA sections as follows. (Example of SVG1.1)

<fo:instream-foreign-object>
<![CDATA[
<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN"
  "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
<svg version="1.1" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 480 360">
  ...
</svg>
]]>
</fo:instream-foreign-object>

The typical content-type is "image/svg+xml".

Supports Mathematical Markup Language (MathML) 2.0. When AH Formatter MathML Option is installed, it's possible to draw high resolution image in PDF because of the direct creation engine. Please refer to "MathML Conformance" for more details.

It is also possible to describe MathML code directly in FO. The following sample uses <fo:instream-foreign-object>.

<fo:instream-foreign-object>
<math xmlns="http://www.w3.org/1998/Math/MathML">
<mrow>
 <mi>y</mi><mo>=</mo><mi>x</mi><mo>&#x2212;</mo><mn>1</mn>
</mrow>
</math>
</fo:instream-foreign-object>

If the correct xmlns is described in the math tag, it's counted as MathML. If not, it's not counted as MathML.

If you want to include the DOCTYPE declaration in FO, please enclose it with the CDATA sections as follows.

<fo:instream-foreign-object>
<![CDATA[
<!DOCTYPE math PUBLIC "-//W3C//DTD MathML 2.0//EN"
  "http://www.w3.org/Math/DTD/mathml2/mathml2.dtd">
<math xmlns="http://www.w3.org/1998/Math/MathML">
<mrow>
 <mi>y</mi><mo>=</mo><mi>x</mi><mo>&minus;</mo><mn>1</mn>
</mrow>
</math>
]]>
</fo:instream-foreign-object>

Even though AH Formatter MathML Support is not included in Lite version, the drawing of MathPlayer can be outputted as a raster image in the Windows version where MathPlayer plug-in is installed. We recommend having Internet Explorer 6 or later installed on your system when using the MathPlayer plug-in. Some of the MathML images may not be displayed correctly with an earlier version than IE 6. The method for using MathPlayer plug-in is not supported with the Solaris/Linux/Macintosh/HP-UX/AIX versions.

The typical content-type is "application/mathml+xml".

Supports Computer Graphics Metafiles as defined in ISO8632. In the Windows version, when either of the following plug-in is installed, CGM can be displayed. CGM is not supported with the Solaris/Linux/Macintosh/HP-UX/AIX versions. CGM images are converted to raster images when outputting to PDF.

• ActiveCGM (http://www.corel.com/)
• IsoView / IsoView WebCGM (http://www.isodraw.com/)
• Larson VizEx CGM Viewer (https://www.cgmlarson.com/)

The content-type is "image/cgm".

Although it is not an image, AH Formatter V5.3 can treat PDF like an image. See also PDF Embedding in PDF Output.

The content-type is "application/pdf".