ColorConvertOp JDK 1.6)

Constructors

public ColorConvertOp (ColorSpace srcCspace, ColorSpace dstCspace, RenderingHints hints)

Constructs a new ColorConvertOp from two ColorSpace objects.

Constructs a new ColorConvertOp from two ColorSpace objects.
The RenderingHints argument may be null.
This Op is primarily useful for calling the filter method on
Rasters, in which case the two ColorSpaces define the operation
to be performed on the Rasters. In that case, the number of bands
in the source Raster must match the number of components in
srcCspace, and the number of bands in the destination Raster
must match the number of components in dstCspace. For BufferedImages,
the two ColorSpaces define intermediate spaces through which the
source is converted before being converted to the destination space.
Parameters:
- srcCspace - the source ColorSpace
- dstCspace - the destination ColorSpace
- hints - the RenderingHints object used to control the color conversion, or null
Throws:
- NullPointerException - if either srcCspace or dstCspace is null

public ColorConvertOp (ColorSpace cspace, RenderingHints hints)

Constructs a new ColorConvertOp from a ColorSpace object.

Constructs a new ColorConvertOp from a ColorSpace object.
The RenderingHints argument may be null. This
Op can be used only with BufferedImages, and is primarily useful
when the filter
method is invoked with a destination argument of null.
In that case, the ColorSpace defines the destination color space
for the destination created by the filter method. Otherwise, the
ColorSpace defines an intermediate space to which the source is
converted before being converted to the destination space.
Parameters:
- cspace - defines the destination ColorSpace or an intermediate ColorSpace
- hints - the RenderingHints object used to control the color conversion, or null
Throws:
- NullPointerException - if cspace is null

public ColorConvertOp (ICC_Profile profiles, RenderingHints hints)

Constructs a new ColorConvertOp from an array of ICC_Profiles.

public ColorConvertOp (RenderingHints hints)

Constructs a new ColorConvertOp which will convert from a source color space to a destination color space.

Constructs a new ColorConvertOp which will convert
from a source color space to a destination color space.
The RenderingHints argument may be null.
This Op can be used only with BufferedImages, and will convert
directly from the ColorSpace of the source image to that of the
destination. The destination argument of the filter method
cannot be specified as null.
Parameters:
- hints - the RenderingHints object used to control the color conversion, or null

Methods

Hide/Show inherited methods

public BufferedImage createCompatibleDestImage (BufferedImage src, ColorModel destCM) [Specified in BufferedImageOp]

Creates a zeroed destination image with the correct size and number of bands, given this source.

Creates a zeroed destination image with the correct size and number of
bands, given this source.
Returns: a BufferedImage with the correct size and number of bands from the specified src.
Parameters:
- src - Source image for the filter operation.
- destCM - ColorModel of the destination. If null, an appropriate ColorModel will be used.
Throws:
- IllegalArgumentException - if destCM is null and this ColorConvertOp was created without any ICC_Profile or ColorSpace defined for the destination

public WritableRaster createCompatibleDestRaster (Raster src) [Specified in RasterOp]

Creates a zeroed destination Raster with the correct size and number of bands, given this source.

Creates a zeroed destination Raster with the correct size and number of
bands, given this source.
Returns: a WritableRaster with the correct size and number of bands from the specified src
Parameters:
- src - the specified Raster
Throws:
- IllegalArgumentException - if this ColorConvertOp was created without sufficient information to define the dst and src color spaces

publicfinal BufferedImage filter (BufferedImage src, BufferedImage dest) [Specified in BufferedImageOp]

ColorConverts the source BufferedImage.

ColorConverts the source BufferedImage.
If the destination image is null,
a BufferedImage will be created with an appropriate ColorModel.
Returns: dest color converted from src or a new, converted BufferedImage if dest is null
Parameters:
- src - the source BufferedImage to be converted
- dest - the destination BufferedImage, or null
Throws:
- IllegalArgumentException - if dest is null and this op was constructed using the constructor which takes only a RenderingHints argument, since the operation is ill defined.

publicfinal WritableRaster filter (Raster src, WritableRaster dest) [Specified in RasterOp]

ColorConverts the image data in the source Raster.

ColorConverts the image data in the source Raster.
If the destination Raster is null, a new Raster will be created.
The number of bands in the source and destination Rasters must
meet the requirements explained above. The constructor used to
create this ColorConvertOp must have provided enough information
to define both source and destination color spaces. See above.
Otherwise, an exception is thrown.
Returns: dest color converted from src or a new, converted WritableRaster if dest is null
Parameters:
- src - the source Raster to be converted
- dest - the destination WritableRaster, or null
Throws:
- IllegalArgumentException - if the number of source or destination bands is incorrect, the source or destination color spaces are undefined, or this op was constructed with one of the constructors that applies only to operations on BufferedImages.

publicfinal Rectangle2D getBounds2D (BufferedImage src) [Specified in BufferedImageOp]

Returns the bounding box of the destination, given this source.

Returns the bounding box of the destination, given this source.
Note that this will be the same as the the bounding box of the
source.
Returns: a Rectangle2D that is the bounding box of the destination, given the specified src
Parameters:
- src - the source BufferedImage

publicfinal Rectangle2D getBounds2D (Raster src) [Specified in RasterOp]

Returns the bounding box of the destination, given this source.

publicfinal ICC_Profile getICC_Profiles ()

Returns the array of ICC_Profiles used to construct this ColorConvertOp.

Returns the array of ICC_Profiles used to construct this ColorConvertOp.
Returns null if the ColorConvertOp was not constructed from such an
array.
Returns: the array of ICC_Profile objects of this ColorConvertOp, or null if this ColorConvertOp was not constructed with an array of ICC_Profile objects.

publicfinal Point2D getPoint2D (Point2D srcPt, Point2D dstPt) [Specified in BufferedImageOp]

Returns the location of the destination point given a point in the source.

Returns the location of the destination point given a
point in the source. If dstPt is non-null,
it will be used to hold the return value. Note that
for this class, the destination point will be the same
as the source point.
Returns: dstPt after setting its location to be the same as srcPt
Parameters:
- srcPt - the specified source Point2D
- dstPt - the destination Point2D

publicfinal RenderingHints getRenderingHints () [Specified in BufferedImageOp]

Returns the rendering hints used by this op.

Returns the rendering hints used by this op.
Returns: the RenderingHints object of this ColorConvertOp