XSL Formatter V3.4

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>. XSL Formatter V3.4 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 word, the content of the graphics can be specified in do 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.

XSL Formatter V3.4 supports the following types of graphics. Unless otherwise noted they are supported across all platforms; Windows, Solaris/Linux/Macintosh/HP-UX/AIX.

☞	See also Image Output in the PDF Output section for the images supported to hundle in PDF.

☞	See also Image Output in the SVG Output section for the images supported to hundle in SVG.

BMP

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

JPEG

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

JPEG2000

Supports JPEG2000 of the following format.

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

On GUI, the dummy image is displayed.

PNG

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

TIFF

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

GIF

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

WMF

Supports Windows Metafile. The image quality is maintained by embedding the vector image in the PDF, SVG. The followings 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".

EMF

Supports Enhanced Metafile. The image quality is maintained by embedding the vector image in the PDF, SVG. The followings 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".

EPS

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.

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 XSL Formatter V3.4. EPS without a preview image is not supported with the Solaris/Linux/Macintosh/HP-UX/AIX versions.

The content-type is "application/postscript".

SVG

Supports Scalable Vector Graphics (SVG) 1.1. XSL Formatter V3.4 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".

MathML

Supports Mathematical Markup Language (MathML) 2.0. When XSL 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 XSL Formatter MathML Option is not installed, 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".

CGM

Supports Computer Graphics Metafiles as defined in ISO8632. In the Windows version, when the ActiveCGM 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.

The content-type is "image/cgm".

PDF

Although it is not an image, XSL Formatter V3.4 can treat PDF like a image. See also PDF Embedding in PDF Output. The content-type is "application/pdf".