24.08.2015 Views

Oxygen XML Author plugin 13.2.0

Oxygen XML Author plugin 13.2.0

Oxygen XML Author plugin 13.2.0

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

<strong>Author</strong>ing in the Visual Editor | 94Figure 59: DITA simple tableImage RenderingThe <strong>Author</strong> editor and the output transformation process might render differently the images referenced in the <strong>XML</strong>document, since they use different rendering engines. The following image formats are supported by default: GIF, JPEG,PNG, SVG, BMP. <strong>Oxygen</strong> <strong>XML</strong> also provides experimental support for CGM images.To allow <strong>Oxygen</strong> <strong>XML</strong> to display other formats (like TIFF, JPEG 2000 or WBMP, for example) install the Java AdvancedImaging (JAI) Image I/O Tools plug-in.When an image cannot be rendered, <strong>Oxygen</strong> <strong>XML</strong> <strong>Author</strong> <strong>plugin</strong> <strong>XML</strong> <strong>Author</strong> displays a warning message that containsthe reason why this is happening. Possible causes:• the image is very large and you need to enable Show very large images option;• the image format is not supported by default. It is recommended to install the Java Advanced Imaging(JAI) ImageI/O Tools plug-in.Scaling ImagesImage 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 controls the rendered image;• if you want to scale proportionally both the width and height of an image, use the scale attribute.Installing Java Advanced Imaging(JAI) Image I/O Tools plug-inFollow this procedure:1. Start <strong>Oxygen</strong> <strong>XML</strong> <strong>Author</strong> <strong>plugin</strong> and open the Help > About dialog. Open the Installation Details dialog,Configuration tab and look for java.runtime.name and java.home properties. Keep their values for later use.2. Download the JAI Image I/O kit corresponding to your operating system and Java distribution (found in thejava.runtime.name property).Please note that the JAI API is not the same thing as JAI Image I/O. Make sure you have installed the latter.3. Execute the installer. When the installation wizard displays the Choose Destination Location page, fill-in theDestination Folder field with the value of the java.home property. Continue with the installation procedure andfollow the on-screen instructions.Mac OS X WorkaroundThere is no native implementation of JAI Image I/O for Mac OS X 10.5 and later. However, the JAI Image I/O has aJava implementation fallback which also works on Mac OS X. Some of the image formats are not fully supported inthis fallback mode, but at least the TIFF image format is known to be supported.1. Download a Linux(tar.gz) distribution of JAI Image I/O from:http://download.java.net/media/jai-imageio/builds/release/1.1/ e.g. jai_imageio-1_1-lib-linux-amd64.tar.gz2. In the <strong>Oxygen</strong>/lib directory create a directory named endorsed e.g. <strong>Oxygen</strong>/lib/endorsed.3. Unpack the tar.gz and navigate to the lib directory from the unpacked directory. e.g. jai_imageio-1_1/lib. Copy thejar files from there(clibwrapper_jiio.jar and jai_imageio.jar) to the <strong>Oxygen</strong>/lib/endorsed directory.4. Restart the application and the JAI Image I/O support will be up and running.Customize <strong>Oxygen</strong> <strong>XML</strong> to Render CGM Images (Experimental Support)<strong>Oxygen</strong> <strong>XML</strong> provides experimental support for CGM 1.0 images.

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!