Class ImageLoaderImageIO

java.lang.Object

org.apache.xmlgraphics.image.loader.impl.AbstractImageLoader

org.apache.xmlgraphics.image.loader.impl.imageio.ImageLoaderImageIO

All Implemented Interfaces:

ImageLoader

public class ImageLoaderImageIO
extends AbstractImageLoader

An ImageLoader implementation based on ImageIO for loading bitmap images.

Field Summary

Fields

Modifier and Type	Field	Description
static final String	ICC_CONVERTER
private static final String	JPEG_METADATA_NODE
protected static final org.apache.commons.logging.Log	log	logger
private static final String	PNG_METADATA_NODE
private static final Set	PROVIDERS_IGNORING_ICC
private ImageFlavor	targetFlavor

Fields inherited from interface ImageLoader

MEDIUM_LOADING_PENALTY, NO_LOADING_PENALTY

Constructor Summary

Constructors

Constructor	Description
ImageLoaderImageIO(ImageFlavor targetFlavor)	Main constructor.

Method Summary

Modifier and Type	Method	Description
private boolean	checkProviderIgnoresICC(IIOServiceProvider provider)	Checks if the provider ignores the ICC color profile.
private BufferedImage	getFallbackBufferedImage(ImageReader reader, int pageIndex, ImageReadParam param)
private ImageReadParam	getParam(ImageReader reader, Map<String,Object> hints)
ImageFlavor	getTargetFlavor()	Returns the image flavor that is returned by this ImageLoader implementation.
Image	loadImage(ImageInfo info, Map<String,Object> hints, ImageSessionContext session)	Loads and returns an image.
private BufferedImage	rgbToCmyk(BufferedImage image, ImageInfo info, ImageSessionContext session)	Convert RGB to CMYK using ICC file passed via fop.xconf
private ICC_Profile	tryToExctractICCProfile(IIOMetadata iiometa)	Extract ICC Profile from ImageIO Metadata.
private ICC_Profile	tryToExctractICCProfileFromJPEGMetadataNode(Element jpgNode)
private ICC_Profile	tryToExctractICCProfileFromPNGMetadataNode(Element pngNode)

Methods inherited from class AbstractImageLoader

getUsagePenalty, ignoreColorProfile, loadImage

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

log

protected static final org.apache.commons.logging.Log log

logger

targetFlavor

private ImageFlavor targetFlavor

PNG_METADATA_NODE

private static final String PNG_METADATA_NODE

See Also:

• Constant Field Values

JPEG_METADATA_NODE

private static final String JPEG_METADATA_NODE

See Also:

• Constant Field Values

ICC_CONVERTER

public static final String ICC_CONVERTER

See Also:

• Constant Field Values

PROVIDERS_IGNORING_ICC

private static final Set PROVIDERS_IGNORING_ICC

Constructor Details

ImageLoaderImageIO

public ImageLoaderImageIO(ImageFlavor targetFlavor)

Main constructor.

Parameters:

targetFlavor - the target flavor

Method Details

getTargetFlavor

public ImageFlavor getTargetFlavor()

Returns the image flavor that is returned by this ImageLoader implementation.

Returns:

the target image flavor

loadImage

public Image loadImage(ImageInfo info,
 Map<String,Object> hints,
 ImageSessionContext session)
                throws ImageException,
IOException

Loads and returns an image.

Parameters:

info - the image info object indicating the image

hints - a Map of hints that can be used by implementations to customize the loading process (may be null).

session - the session context

Returns:

the fully loaded image

Throws:

ImageException - if an error occurs while loading the image

IOException - if an I/O error occurs while loading the image

rgbToCmyk

private BufferedImage rgbToCmyk(BufferedImage image,
 ImageInfo info,
 ImageSessionContext session)
                         throws IOException

Convert RGB to CMYK using ICC file passed via fop.xconf

Throws:

IOException

getParam

private ImageReadParam getParam(ImageReader reader,
 Map<String,Object> hints)
                         throws IOException

Throws:

IOException

checkProviderIgnoresICC

private boolean checkProviderIgnoresICC(IIOServiceProvider provider)

Checks if the provider ignores the ICC color profile. This method will assume providers work correctly, and return false if the provider is unknown. This ensures backward-compatibility.

Parameters:

provider - the ImageIO Provider

Returns:

true if we know the provider to be broken and ignore ICC profiles.

tryToExctractICCProfile

private ICC_Profile tryToExctractICCProfile(IIOMetadata iiometa)

Extract ICC Profile from ImageIO Metadata. This method currently only supports PNG and JPEG metadata.

Parameters:

iiometa - The ImageIO Metadata

Returns:

an ICC Profile or null.

tryToExctractICCProfileFromPNGMetadataNode

private ICC_Profile tryToExctractICCProfileFromPNGMetadataNode(Element pngNode)

tryToExctractICCProfileFromJPEGMetadataNode

private ICC_Profile tryToExctractICCProfileFromJPEGMetadataNode(Element jpgNode)

getFallbackBufferedImage

private BufferedImage getFallbackBufferedImage(ImageReader reader,
 int pageIndex,
 ImageReadParam param)
                                        throws IOException

Throws:

IOException