public class

WBMPImageWriter

extends ImageWriter
java.lang.Object
   ↳ javax.imageio.ImageWriter
     ↳ com.sun.imageio.plugins.wbmp.WBMPImageWriter

Class Overview

The Java Image IO plugin writer for encoding a binary RenderedImage into a WBMP format. The encoding process may clip, subsample using the parameters specified in the ImageWriteParam.

See Also
  • com.sun.media.imageio.plugins.WBMPImageWriteParam

Summary

[Expand]
Inherited Fields
From class javax.imageio.ImageWriter
Public Constructors
WBMPImageWriter(ImageWriterSpi originator)
Constructs WBMPImageWriter based on the provided ImageWriterSpi.
Public Methods
boolean canWriteRasters()
Returns true if the methods that take an IIOImage parameter are capable of dealing with a Raster (as opposed to RenderedImage) source image.
IIOMetadata convertImageMetadata(IIOMetadata metadata, ImageTypeSpecifier type, ImageWriteParam param)
Returns an IIOMetadata object that may be used for encoding and optionally modified using its document interfaces or other interfaces specific to the writer plug-in that will be used for encoding.
IIOMetadata convertStreamMetadata(IIOMetadata inData, ImageWriteParam param)
Returns an IIOMetadata object that may be used for encoding and optionally modified using its document interfaces or other interfaces specific to the writer plug-in that will be used for encoding.
IIOMetadata getDefaultImageMetadata(ImageTypeSpecifier imageType, ImageWriteParam param)
Returns an IIOMetadata object containing default values for encoding an image of the given type.
IIOMetadata getDefaultStreamMetadata(ImageWriteParam param)
Returns an IIOMetadata object containing default values for encoding a stream of images.
void reset()
Restores the ImageWriter to its initial state.
void setOutput(Object output)
Sets the destination to the given ImageOutputStream or other Object.
void write(IIOMetadata streamMetadata, IIOImage image, ImageWriteParam param)
Appends a complete image stream containing a single image and associated stream and image metadata and thumbnails to the output.
[Expand]
Inherited Methods
From class javax.imageio.ImageWriter
From class java.lang.Object
From interface javax.imageio.ImageTranscoder

Public Constructors

public WBMPImageWriter (ImageWriterSpi originator)

Constructs WBMPImageWriter based on the provided ImageWriterSpi.

Public Methods

public boolean canWriteRasters ()

Returns true if the methods that take an IIOImage parameter are capable of dealing with a Raster (as opposed to RenderedImage) source image. If this method returns false, then those methods will throw an UnsupportedOperationException if supplied with an IIOImage containing a Raster.

The default implementation returns false.

Returns
  • true if Raster sources are supported.

public IIOMetadata convertImageMetadata (IIOMetadata metadata, ImageTypeSpecifier type, ImageWriteParam param)

Returns an IIOMetadata object that may be used for encoding and optionally modified using its document interfaces or other interfaces specific to the writer plug-in that will be used for encoding.

An optional ImageWriteParam may be supplied for cases where it may affect the structure of the image metadata.

If the supplied ImageWriteParam contains optional setting values not understood by this writer or transcoder, they will be ignored.

Parameters
metadata an IIOMetadata object representing image metadata, used to initialize the state of the returned object.
type an ImageTypeSpecifier indicating the layout and color information of the image with which the metadata will be associated.
param an ImageWriteParam that will be used to encode the image, or null.
Returns
  • an IIOMetadata object, or null if the plug-in does not provide metadata encoding capabilities.

public IIOMetadata convertStreamMetadata (IIOMetadata inData, ImageWriteParam param)

Returns an IIOMetadata object that may be used for encoding and optionally modified using its document interfaces or other interfaces specific to the writer plug-in that will be used for encoding.

An optional ImageWriteParam may be supplied for cases where it may affect the structure of the stream metadata.

If the supplied ImageWriteParam contains optional setting values not understood by this writer or transcoder, they will be ignored.

Parameters
inData an IIOMetadata object representing stream metadata, used to initialize the state of the returned object.
param an ImageWriteParam that will be used to encode the image, or null.
Returns
  • an IIOMetadata object, or null if the plug-in does not provide metadata encoding capabilities.

public IIOMetadata getDefaultImageMetadata (ImageTypeSpecifier imageType, ImageWriteParam param)

Returns an IIOMetadata object containing default values for encoding an image of the given type. The contents of the object may be manipulated using either the XML tree structure returned by the IIOMetadata.getAsTree method, an IIOMetadataController object, or via plug-in specific interfaces, and the resulting data supplied to one of the write methods that take a stream metadata parameter.

An optional ImageWriteParam may be supplied for cases where it may affect the structure of the image metadata.

If the supplied ImageWriteParam contains optional setting values not supported by this writer (e.g. progressive encoding or any format-specific settings), they will be ignored.

Parameters
imageType an ImageTypeSpecifier indicating the format of the image to be written later.
param an ImageWriteParam that will be used to encode the image, or null.
Returns
  • an IIOMetadata object.

public IIOMetadata getDefaultStreamMetadata (ImageWriteParam param)

Returns an IIOMetadata object containing default values for encoding a stream of images. The contents of the object may be manipulated using either the XML tree structure returned by the IIOMetadata.getAsTree method, an IIOMetadataController object, or via plug-in specific interfaces, and the resulting data supplied to one of the write methods that take a stream metadata parameter.

An optional ImageWriteParam may be supplied for cases where it may affect the structure of the stream metadata.

If the supplied ImageWriteParam contains optional setting values not supported by this writer (e.g. progressive encoding or any format-specific settings), they will be ignored.

Writers that do not make use of stream metadata (e.g., writers for single-image formats) should return null.

Parameters
param an ImageWriteParam that will be used to encode the image, or null.
Returns
  • an IIOMetadata object.

public void reset ()

Restores the ImageWriter to its initial state.

The default implementation calls setOutput(null), setLocale(null), removeAllIIOWriteWarningListeners(), removeAllIIOWriteProgressListeners(), and clearAbortRequest.

public void setOutput (Object output)

Sets the destination to the given ImageOutputStream or other Object. The destination is assumed to be ready to accept data, and will not be closed at the end of each write. This allows distributed imaging applications to transmit a series of images over a single network connection. If output is null, any currently set output will be removed.

If output is an ImageOutputStream, calls to the write, writeToSequence, and prepareWriteEmpty/endWriteEmpty methods will preserve the existing contents of the stream. Other write methods, such as writeInsert, replaceStreamMetadata, replaceImageMetadata, replacePixels, prepareInsertEmpty/endInsertEmpty, and endWriteSequence, require the full contents of the stream to be readable and writable, and may alter any portion of the stream.

Use of a general Object other than an ImageOutputStream is intended for writers that interact directly with an output device or imaging protocol. The set of legal classes is advertised by the writer's service provider's getOutputTypes method; most writers will return a single-element array containing only ImageOutputStream.class to indicate that they accept only an ImageOutputStream.

The default implementation sets the output instance variable to the value of output after checking output against the set of classes advertised by the originating provider, if there is one.

Parameters
output the ImageOutputStream or other Object to use for future writing.

public void write (IIOMetadata streamMetadata, IIOImage image, ImageWriteParam param)

Appends a complete image stream containing a single image and associated stream and image metadata and thumbnails to the output. Any necessary header information is included. If the output is an ImageOutputStream, its existing contents prior to the current seek position are not affected, and need not be readable or writable.

The output must have been set beforehand using the setOutput method.

Stream metadata may optionally be supplied; if it is null, default stream metadata will be used.

If canWriteRasters returns true, the IIOImage may contain a Raster source. Otherwise, it must contain a RenderedImage source.

The supplied thumbnails will be resized if needed, and any thumbnails in excess of the supported number will be ignored. If the format requires additional thumbnails that are not provided, the writer should generate them internally.

An ImageWriteParam may optionally be supplied to control the writing process. If param is null, a default write param will be used.

If the supplied ImageWriteParam contains optional setting values not supported by this writer (e.g. progressive encoding or any format-specific settings), they will be ignored.

Parameters
streamMetadata an IIOMetadata object representing stream metadata, or null to use default values.
image an IIOImage object containing an image, thumbnails, and metadata to be written.
param an ImageWriteParam, or null to use a default ImageWriteParam.
Throws
IOException