< prev index next >
src/java.desktop/share/classes/java/awt/image/ColorConvertOp.java
Print this page
*** 90,101 ****
* 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.
! * @param hints the <code>RenderingHints</code> object used to control
! * the color conversion, or <code>null</code>
*/
public ColorConvertOp (RenderingHints hints)
{
profileList = new ICC_Profile [0]; /* 0 length list */
this.hints = hints;
--- 90,101 ----
* 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.
! * @param hints the {@code RenderingHints} object used to control
! * the color conversion, or {@code null}
*/
public ColorConvertOp (RenderingHints hints)
{
profileList = new ICC_Profile [0]; /* 0 length list */
this.hints = hints;
*** 109,122 ****
* 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.
! * @param cspace defines the destination <code>ColorSpace</code> or an
! * intermediate <code>ColorSpace</code>
! * @param hints the <code>RenderingHints</code> object used to control
! * the color conversion, or <code>null</code>
* @throws NullPointerException if cspace is null
*/
public ColorConvertOp (ColorSpace cspace, RenderingHints hints)
{
if (cspace == null) {
--- 109,122 ----
* 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.
! * @param cspace defines the destination {@code ColorSpace} or an
! * intermediate {@code ColorSpace}
! * @param hints the {@code RenderingHints} object used to control
! * the color conversion, or {@code null}
* @throws NullPointerException if cspace is null
*/
public ColorConvertOp (ColorSpace cspace, RenderingHints hints)
{
if (cspace == null) {
*** 144,157 ****
* 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.
! * @param srcCspace the source <code>ColorSpace</code>
! * @param dstCspace the destination <code>ColorSpace</code>
! * @param hints the <code>RenderingHints</code> object used to control
! * the color conversion, or <code>null</code>
* @throws NullPointerException if either srcCspace or dstCspace is null
*/
public ColorConvertOp(ColorSpace srcCspace, ColorSpace dstCspace,
RenderingHints hints)
{
--- 144,157 ----
* 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.
! * @param srcCspace the source {@code ColorSpace}
! * @param dstCspace the destination {@code ColorSpace}
! * @param hints the {@code RenderingHints} object used to control
! * the color conversion, or {@code null}
* @throws NullPointerException if either srcCspace or dstCspace is null
*/
public ColorConvertOp(ColorSpace srcCspace, ColorSpace dstCspace,
RenderingHints hints)
{
*** 194,206 ****
* the requirements of the first profile in the array, and the
* number of bands in the destination Raster must match the requirements
* of the last profile in the array. The array must have at least two
* elements or calling the filter method for Rasters will throw an
* IllegalArgumentException.
! * @param profiles the array of <code>ICC_Profile</code> objects
! * @param hints the <code>RenderingHints</code> object used to control
! * the color conversion, or <code>null</code>
* @exception IllegalArgumentException when the profile sequence does not
* specify a well-defined color conversion
* @exception NullPointerException if profiles is null
*/
public ColorConvertOp (ICC_Profile[] profiles, RenderingHints hints)
--- 194,206 ----
* the requirements of the first profile in the array, and the
* number of bands in the destination Raster must match the requirements
* of the last profile in the array. The array must have at least two
* elements or calling the filter method for Rasters will throw an
* IllegalArgumentException.
! * @param profiles the array of {@code ICC_Profile} objects
! * @param hints the {@code RenderingHints} object used to control
! * the color conversion, or {@code null}
* @exception IllegalArgumentException when the profile sequence does not
* specify a well-defined color conversion
* @exception NullPointerException if profiles is null
*/
public ColorConvertOp (ICC_Profile[] profiles, RenderingHints hints)
*** 219,232 ****
/**
* Returns the array of ICC_Profiles used to construct this ColorConvertOp.
* Returns null if the ColorConvertOp was not constructed from such an
* array.
! * @return the array of <code>ICC_Profile</code> objects of this
! * <code>ColorConvertOp</code>, or <code>null</code> if this
! * <code>ColorConvertOp</code> was not constructed with an
! * array of <code>ICC_Profile</code> objects.
*/
public final ICC_Profile[] getICC_Profiles() {
if (gotProfiles) {
ICC_Profile[] profiles = new ICC_Profile[profileList.length];
for (int i1 = 0; i1 < profileList.length; i1++) {
--- 219,232 ----
/**
* Returns the array of ICC_Profiles used to construct this ColorConvertOp.
* Returns null if the ColorConvertOp was not constructed from such an
* array.
! * @return the array of {@code ICC_Profile} objects of this
! * {@code ColorConvertOp}, or {@code null} if this
! * {@code ColorConvertOp} was not constructed with an
! * array of {@code ICC_Profile} objects.
*/
public final ICC_Profile[] getICC_Profiles() {
if (gotProfiles) {
ICC_Profile[] profiles = new ICC_Profile[profileList.length];
for (int i1 = 0; i1 < profileList.length; i1++) {
*** 239,254 ****
/**
* ColorConverts the source BufferedImage.
* If the destination image is null,
* a BufferedImage will be created with an appropriate ColorModel.
! * @param src the source <code>BufferedImage</code> to be converted
! * @param dest the destination <code>BufferedImage</code>,
! * or <code>null</code>
! * @return <code>dest</code> color converted from <code>src</code>
! * or a new, converted <code>BufferedImage</code>
! * if <code>dest</code> is <code>null</code>
* @exception 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.
*/
public final BufferedImage filter(BufferedImage src, BufferedImage dest) {
--- 239,254 ----
/**
* ColorConverts the source BufferedImage.
* If the destination image is null,
* a BufferedImage will be created with an appropriate ColorModel.
! * @param src the source {@code BufferedImage} to be converted
! * @param dest the destination {@code BufferedImage},
! * or {@code null}
! * @return {@code dest} color converted from {@code src}
! * or a new, converted {@code BufferedImage}
! * if {@code dest} is {@code null}
* @exception 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.
*/
public final BufferedImage filter(BufferedImage src, BufferedImage dest) {
*** 453,468 ****
* 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.
! * @param src the source <code>Raster</code> to be converted
! * @param dest the destination <code>WritableRaster</code>,
! * or <code>null</code>
! * @return <code>dest</code> color converted from <code>src</code>
! * or a new, converted <code>WritableRaster</code>
! * if <code>dest</code> is <code>null</code>
* @exception 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.
--- 453,468 ----
* 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.
! * @param src the source {@code Raster} to be converted
! * @param dest the destination {@code WritableRaster},
! * or {@code null}
! * @return {@code dest} color converted from {@code src}
! * or a new, converted {@code WritableRaster}
! * if {@code dest} is {@code null}
* @exception 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.
*** 577,601 ****
/**
* Returns the bounding box of the destination, given this source.
* Note that this will be the same as the bounding box of the
* source.
! * @param src the source <code>BufferedImage</code>
! * @return a <code>Rectangle2D</code> that is the bounding box
! * of the destination, given the specified <code>src</code>
*/
public final Rectangle2D getBounds2D (BufferedImage src) {
return getBounds2D(src.getRaster());
}
/**
* Returns the bounding box of the destination, given this source.
* Note that this will be the same as the bounding box of the
* source.
! * @param src the source <code>Raster</code>
! * @return a <code>Rectangle2D</code> that is the bounding box
! * of the destination, given the specified <code>src</code>
*/
public final Rectangle2D getBounds2D (Raster src) {
/* return new Rectangle (src.getXOffset(),
src.getYOffset(),
src.getWidth(), src.getHeight()); */
--- 577,601 ----
/**
* Returns the bounding box of the destination, given this source.
* Note that this will be the same as the bounding box of the
* source.
! * @param src the source {@code BufferedImage}
! * @return a {@code Rectangle2D} that is the bounding box
! * of the destination, given the specified {@code src}
*/
public final Rectangle2D getBounds2D (BufferedImage src) {
return getBounds2D(src.getRaster());
}
/**
* Returns the bounding box of the destination, given this source.
* Note that this will be the same as the bounding box of the
* source.
! * @param src the source {@code Raster}
! * @return a {@code Rectangle2D} that is the bounding box
! * of the destination, given the specified {@code src}
*/
public final Rectangle2D getBounds2D (Raster src) {
/* return new Rectangle (src.getXOffset(),
src.getYOffset(),
src.getWidth(), src.getHeight()); */
*** 606,621 ****
* Creates a zeroed destination image with the correct size and number of
* bands, given this source.
* @param src Source image for the filter operation.
* @param destCM ColorModel of the destination. If null, an
* appropriate ColorModel will be used.
! * @return a <code>BufferedImage</code> with the correct size and
! * number of bands from the specified <code>src</code>.
! * @throws IllegalArgumentException if <code>destCM</code> is
! * <code>null</code> and this <code>ColorConvertOp</code> was
! * created without any <code>ICC_Profile</code> or
! * <code>ColorSpace</code> defined for the destination
*/
public BufferedImage createCompatibleDestImage (BufferedImage src,
ColorModel destCM) {
ColorSpace cs = null;;
if (destCM == null) {
--- 606,621 ----
* Creates a zeroed destination image with the correct size and number of
* bands, given this source.
* @param src Source image for the filter operation.
* @param destCM ColorModel of the destination. If null, an
* appropriate ColorModel will be used.
! * @return a {@code BufferedImage} with the correct size and
! * number of bands from the specified {@code src}.
! * @throws IllegalArgumentException if {@code destCM} is
! * {@code null} and this {@code ColorConvertOp} was
! * created without any {@code ICC_Profile} or
! * {@code ColorSpace} defined for the destination
*/
public BufferedImage createCompatibleDestImage (BufferedImage src,
ColorModel destCM) {
ColorSpace cs = null;;
if (destCM == null) {
*** 667,682 ****
/**
* Creates a zeroed destination Raster with the correct size and number of
* bands, given this source.
! * @param src the specified <code>Raster</code>
! * @return a <code>WritableRaster</code> with the correct size and number
! * of bands from the specified <code>src</code>
! * @throws IllegalArgumentException if this <code>ColorConvertOp</code>
* was created without sufficient information to define the
! * <code>dst</code> and <code>src</code> color spaces
*/
public WritableRaster createCompatibleDestRaster (Raster src) {
int ncomponents;
if (CSList != null) {
--- 667,682 ----
/**
* Creates a zeroed destination Raster with the correct size and number of
* bands, given this source.
! * @param src the specified {@code Raster}
! * @return a {@code WritableRaster} with the correct size and number
! * of bands from the specified {@code src}
! * @throws IllegalArgumentException if this {@code ColorConvertOp}
* was created without sufficient information to define the
! * {@code dst} and {@code src} color spaces
*/
public WritableRaster createCompatibleDestRaster (Raster src) {
int ncomponents;
if (CSList != null) {
*** 705,722 ****
return dest;
}
/**
* Returns the location of the destination point given a
! * point in the source. If <code>dstPt</code> 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.
! * @param srcPt the specified source <code>Point2D</code>
! * @param dstPt the destination <code>Point2D</code>
! * @return <code>dstPt</code> after setting its location to be
! * the same as <code>srcPt</code>
*/
public final Point2D getPoint2D (Point2D srcPt, Point2D dstPt) {
if (dstPt == null) {
dstPt = new Point2D.Float();
}
--- 705,722 ----
return dest;
}
/**
* Returns the location of the destination point given a
! * point in the source. If {@code 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.
! * @param srcPt the specified source {@code Point2D}
! * @param dstPt the destination {@code Point2D}
! * @return {@code dstPt} after setting its location to be
! * the same as {@code srcPt}
*/
public final Point2D getPoint2D (Point2D srcPt, Point2D dstPt) {
if (dstPt == null) {
dstPt = new Point2D.Float();
}
*** 744,755 ****
(header[index+3] & 0xff);
}
/**
* Returns the rendering hints used by this op.
! * @return the <code>RenderingHints</code> object of this
! * <code>ColorConvertOp</code>
*/
public final RenderingHints getRenderingHints() {
return hints;
}
--- 744,755 ----
(header[index+3] & 0xff);
}
/**
* Returns the rendering hints used by this op.
! * @return the {@code RenderingHints} object of this
! * {@code ColorConvertOp}
*/
public final RenderingHints getRenderingHints() {
return hints;
}
< prev index next >