Image Rendering in Author Mode

The Author mode and the output transformation process might render the images referenced in an XML document differently, since they use different rendering engines.

Table 1. Supported Image Formats
Image Type	Support	Additional Information
GIF	built-in	Animations not yet supported.
JPG, JPEG	built-in	JPEG images with CMYK color profiles are properly rendered only if color profile is inside the image.
PNG	built-in
SVG, SVGZ	built-in	Rendered using the open-source Apache Batik library that supports SVG 1.1.
BMP	built-in
TIFF	built-in	Rendered using a part of the Java JAI Image library.
EPS	built-in	Renders the preview TIFF image inside the EPS.
AI	built-in	Renders the preview image inside the Adobe Illustrator file.
PDF	built-in	Rendered by using the bundled Apache PDF Box library.
JPEG 2000, WBMP	plugin	Renders by installing the Java Advanced Imaging (JAI) Image I/O Tools plug-in.

When an image cannot be rendered, Oxygen XML Author Eclipse plugin Author mode displays a warning message that contains the reason why this is happening. Possible causes include the following:

The image is too large. Select the Show very large images option.
The image format is not supported by default. It is recommended to install the Java Advanced Imaging(JAI) Image I/O Tools plug-in.

Tip:

If you are using a custom XML format and you want images to be displayed in Author mode, you could use a custom CSS to define the rendering.

For example, if your XML has something like this:

<image href="blue.png"/>

You can add a selector in your custom CSS like this:

image[href]{
    content: attr(href, url);
}

Scaling Images

Image dimension and scaling attributes are taken into account when an image is rendered. The following rules apply:

If you specify only the width attribute of an image, the height of the image is proportionally applied.
If you specify only the height attribute of an image, the width of the image is proportionally applied.
If you specify width and height attributes of an image, both of them control the rendered image.
If you want to scale both the width and height of an image proportionally, use the @scale attribute.

Note: As a Java application, Oxygen XML Author Eclipse plugin uses the Java Advanced Imaging API that provides a pluggable support for new image types. If you have an ImageIO library that supports additional image formats, just copy this library to the [OXYGEN_INSTALL_DIR]/lib directory.