Edit online

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