com.xmlmind.xmledit.imagetoolkit

Interface ImageToolkit

All Known Implementing Classes:

BatikImageToolkit, ExternalImageToolkit, JavaImageToolkit, JEuclidImageToolkit, JLaTeXMathImageToolkit, MathMLImageToolkit

public interface ImageToolkit

Interface implemented by image toolkit plug-ins.

The following classes are useful to implement image toolkit plug-ins: ImageToolkitUtil, ImageRendererAdapter.

Method Summary

Modifier and Type	Method and Description
String	getDescription() Returns a short description of this toolkit.
ImageConverter	getImageConverter(File inFile, File outFile) Returns an ImageConverter which can be used to convert specified files.
ImageRenderer	getImageRenderer(byte[] data) Returns an ImageRenderer which can be used to create an image representing the specified data.
ImageRenderer	getImageRenderer(Element element) Returns an ImageRenderer which can be used to create an image representing the specified XML element.
ImageRenderer	getImageRenderer(URL url) Returns an ImageRenderer which can be used to create an image representing the specified URL.
String	getName() Returns the name of this toolkit.

Method Detail

getName

String getName()

Returns the name of this toolkit.

getDescription

String getDescription()

Returns a short description of this toolkit. May be null. May contain newline characters.

getImageRenderer

ImageRenderer getImageRenderer(URL url)

Returns an ImageRenderer which can be used to create an image representing the specified URL. Returns null if this toolkit has no such renderer.

This method is invoked when the graphics file that is to be rendered on screen is referenced by the document being edited. DocBook example: <imagedata fileref="URL"/>.

This method typically checks the filename extension of the URL. If this extension denotes a format which is supported by this toolkit, the method returns a properly configured ImageRenderer. Otherwise, this method returns null.

Parameters:

url - URL of a graphics file; "data:" URLs not supported; URLs having a fragment not supported

Returns:

a properly configured ImageRenderer or null

getImageRenderer

ImageRenderer getImageRenderer(byte[] data)

Returns an ImageRenderer which can be used to create an image representing the specified data. Returns null if this toolkit has no such renderer.

This method is invoked when the graphics file that is to be rendered on screen is embedded in the document being edited. Example: <image data="au8ze...base64Binary...t514l"/>.

This method typically checks the magic string or binary signature of the data. For example: if the first bytes are 0x4949 or 0x4D4D, the format is TIFF. If this magic string denotes a format which is supported by this toolkit, the method returns a properly configured ImageRenderer. Otherwise, this method returns null.

Parameters:

data - graphics data (that is, the binary contents of a graphics file)

Returns:

a properly configured ImageRenderer or null

See Also:

ImageToolkitUtil.detectImageFormat(byte[]), ImageToolkitUtil.match(byte[], byte[])

getImageRenderer

ImageRenderer getImageRenderer(Element element)

Returns an ImageRenderer which can be used to create an image representing the specified XML element. Returns null if this toolkit has no such renderer.

This method is invoked when the graphics that is to be rendered on screen is a sub-tree of the document being edited. DocBook 5 example: <db5:imagedata><svg:svg> ... </svg:svg></db5:imagedata> (the element to be rendered is <svg:svg>, not <db5:imagedata>).

This method typically checks the namespace of the element. If this namespace denotes a format which is supported by this toolkit, the method returns a properly configured ImageRenderer. Otherwise, this method returns null.

Parameters:

element - root of the XML sub-tree

Returns:

a properly configured ImageRenderer or null

getImageConverter

ImageConverter getImageConverter(File inFile,
                                 File outFile)

Returns an ImageConverter which can be used to convert specified files. Returns null if this toolkit has no such converter.

This method is invoked when a graphics file needs to be converted from a format to another. The format conversion is specified in the <convertImage> child element of the <process> configuration element. More information in XMLmind XML Editor - Configuration and Deployment.

This method typically checks the filename extensions of both the input file and the output file. If these extensions denotes formats supported by this toolkit, the method returns a properly configured ImageConverter. Otherwise, this method returns null.

Like the getImageRenderer methods, this method is invoked several times in a row until it returns a non-null converter. This means: can you convert this TIFF image to GIF? No. OK, but can you convert this TIFF image to PNG? No. OK, but can you convert his TIFF image to JPEG? And so on. If this method returns null in all cases, then, another image toolkit, if any, is tested.

Parameters:

inFile - graphics file to be converted to another format

outFile - graphics file resulting from the conversion

Returns:

a properly configured ImageConverter or null