< 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 >