XSL Formattter V4
Last updated: Aug 7, 2007
Home
Products Top
V4.2 Overview
How XSL Formatter Works
PDF Output
Font Support
Graphic Support
Hyphenation Support
WordMLToFO Transformation
 
XSL-FO Conformance
Extension
SVG Conformance
SVG 1.1 Test Suite
MathML Conformance
MathML Test Suite
 
PostScript ® Output Option
Chart Option
PANTONE® Option
Web Service Interface
SVG Output Option
MathML Option
Barcode Option
WordMLToFO Stylesheet
XML Viewer
 
Download Evaluation Version
XSL Formatter Q&A
Upgrade from V3.X, 4.1 to V4.2
 
See also V4.2 Lite
V4.2 Lite Overview

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>. XSL Formatter V4.2 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.

XSL Formatter V4.2 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 bundle in PDF.
☞  See also Image Output in the SVG Output section for the images supported to bundle in SVG.
☞  See also Image Output in the PostScript Output section for the images supported to bundle in PostScript.

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.

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

EMF

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

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.

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.

CAUTION: In Adobe Distiller, there may be a restriction on the PDF size that can be created. The size of EPS needs to be within the restriction that Adobe Distiller has. See also Support Knowledgebase.

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

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

PDF

Although it is not an image, XSL Formatter V4.2 can treat PDF like an image. See also PDF Embedding in PDF Output.

The content-type is "application/pdf".

Excel Chart

With the environment into which XSL Formatter Chart Option is built, the drawing of Microsoft® Excel Chart is possible. By drawing it as the vector image, the image quality is maintained without the degradation caused by scaling etc. For example, specify as follows for <fo:external-graphic>.

<fo:external-graphic src="MyBook.xls#sheet=2&amp;chart=3"/>

In this example, the third chart in the second sheet is specified. The first sheet is shown as 1, and the first chart is shown as 1. When sheet is not specified, the sheet which contains the first chart is selected. When chart is not specified, the first chart contained in the specified sheet is selected. When neither is specified, the first chart contained in that book is selected. At this time, it is possible to omit the fragment and specify it as follows.

<fo:external-graphic src="MyBook.xls"/>

It supports the following version of Excel.

  • Excel 97
  • Excel 2000
  • Excel 2002
  • Excel 2003

Restrictions:

  • Surface chart is not correctly displayed.
  • Size, position, aspect ratio and angle of the displayed chart (especially 3-D chart) might not be the same as those of the original display by Excel.
  • The display of the data table is not supported.
  • The display units of the axis scale is not supported.
  • The data labels other than value cannot be displayed. The display of multiple data labels of value in Bubble chart is also not supported.
  • The display of the legend key of the data labels is not supported.
  • Elaborate fill effects, such as Gradient or Texture, are not supported.
  • The vertical orientation of the axis label is not supported.
  • The hierarchical item labels might not be correctly displayed.
  • Maximum, minimum and major unit etc. of the axis scale might be different from Excel.
  • As for combination charts, the legend item might not be displayed in the correct order.
  • The custom (by specifying the range of cell) in the error amount is not supported.
  • The position where the data labels are displayed might be different from Excel.
  • As for the border style, those of the last 3 patterns are not supported.
  • Superscript and subscript in the font of the axis label are not supported.
  • "Round corners" in the patterns of the chart area is not supported.
  • The display of equation in the trendline is not supported.

The content-type is "application/vnd.ms-excel".


Copyright © 1996-2008 Antenna House, Inc. All rights reserved.
Antenna House is a trademark of Antenna House, Inc.