Dead
[official-gcc.git] / gomp-20050608-branch / libjava / classpath / java / awt / image / ColorConvertOp.java
blob18609e0c4b091468d7c862ac983afdfff06c70a5
1 /* ColorModel.java --
2 Copyright (C) 2004 Free Software Foundation
4 This file is part of GNU Classpath.
6 GNU Classpath is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 2, or (at your option)
9 any later version.
11 GNU Classpath is distributed in the hope that it will be useful, but
12 WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with GNU Classpath; see the file COPYING. If not, write to the
18 Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
19 02110-1301 USA.
21 Linking this library statically or dynamically with other modules is
22 making a combined work based on this library. Thus, the terms and
23 conditions of the GNU General Public License cover the whole
24 combination.
26 As a special exception, the copyright holders of this library give you
27 permission to link this library with independent modules to produce an
28 executable, regardless of the license terms of these independent
29 modules, and to copy and distribute the resulting executable under
30 terms of your choice, provided that you also meet, for each linked
31 independent module, the terms and conditions of the license of that
32 module. An independent module is a module which is not derived from
33 or based on this library. If you modify this library, you may extend
34 this exception to your version of the library, but you are not
35 obligated to do so. If you do not wish to do so, delete this
36 exception statement from your version. */
39 package java.awt.image;
41 import java.awt.Graphics2D;
42 import java.awt.RenderingHints;
43 import java.awt.color.ColorSpace;
44 import java.awt.color.ICC_ColorSpace;
45 import java.awt.color.ICC_Profile;
46 import java.awt.geom.Point2D;
47 import java.awt.geom.Rectangle2D;
49 /**
50 * ColorConvertOp is a filter for converting an image from one colorspace to
51 * another colorspace. The filter can convert the image through a sequence
52 * of colorspaces or just from source to destination.
54 * Color conversion is done on the color components without alpha. Thus
55 * if a BufferedImage has alpha premultiplied, this is divided out before
56 * color conversion, and premultiplication applied if the destination
57 * requires it.
59 * Color rendering and dithering hints may be applied if specified. This is
60 * likely platform-dependent.
62 * @author jlquinn@optonline.net
64 public class ColorConvertOp implements BufferedImageOp, RasterOp
66 private ColorSpace srccs;
67 private ColorSpace dstcs;
68 private RenderingHints hints;
69 private ICC_Profile[] profiles;
70 private ColorSpace[] spaces;
71 private boolean rasterValid;
74 /**
75 * Convert BufferedImage through a ColorSpace.
77 * This filter version is only valid for BufferedImages. The source image
78 * is converted to cspace. If the destination is not null, it is then
79 * converted to the destination colorspace. Normally this filter will only
80 * be used with a null destination.
82 * @param cspace The target color space.
83 * @param hints Rendering hints to use in conversion, or null.
85 public ColorConvertOp(ColorSpace cspace, RenderingHints hints)
87 if (cspace == null)
88 throw new NullPointerException();
89 spaces = new ColorSpace[]{cspace};
90 this.hints = hints;
91 rasterValid = false;
94 public ColorConvertOp(ColorSpace srcCspace, ColorSpace dstCspace,
95 RenderingHints hints)
97 if (srcCspace == null || dstCspace == null)
98 throw new NullPointerException();
99 spaces = new ColorSpace[]{srcCspace, dstCspace};
100 this.hints = hints;
104 * Convert from a source image destination image color space.
106 * This constructor builds a ColorConvertOp from an array of ICC_Profiles.
107 * The source image will be converted through the sequence of color spaces
108 * defined by the profiles. If the sequence of profiles doesn't give a
109 * well-defined conversion, throws IllegalArgumentException.
111 * NOTE: Sun's docs don't clearly define what a well-defined conversion is
112 * - or perhaps someone smarter can come along and sort it out.
114 * For BufferedImages, when the first and last profiles match the
115 * requirements of the source and destination color space respectively, the
116 * corresponding conversion is unnecessary. TODO: code this up. I don't
117 * yet understand how you determine this.
119 * For Rasters, the first and last profiles must have the same number of
120 * bands as the source and destination Rasters, respectively. If this is
121 * not the case, or there fewer than 2 profiles, an IllegalArgumentException
122 * will be thrown.
124 * @param profiles
125 * @param hints
127 public ColorConvertOp(ICC_Profile[] profiles, RenderingHints hints)
129 if (profiles == null)
130 throw new NullPointerException();
131 this.hints = hints;
132 this.profiles = profiles;
133 // TODO: Determine if this is well-defined.
134 // Create colorspace array with space for src and dest colorspace
135 spaces = new ColorSpace[profiles.length];
136 for (int i = 0; i < profiles.length; i++)
137 spaces[i] = new ICC_ColorSpace(profiles[i]);
140 /** Convert from source image color space to destination image color space.
142 * Only valid for BufferedImage objects, this Op converts from the source
143 * color space to the destination color space. The destination can't be
144 * null for this operation.
146 * @param hints Rendering hints to use during conversion, or null.
148 public ColorConvertOp(RenderingHints hints)
150 this.hints = hints;
151 srccs = null;
152 dstcs = null;
153 rasterValid = false;
156 /* (non-Javadoc)
157 * @see java.awt.image.BufferedImageOp#filter(java.awt.image.BufferedImage,
158 java.awt.image.BufferedImage)
160 public final BufferedImage filter(BufferedImage src, BufferedImage dst)
162 // TODO: The plan is to create a scanline buffer for intermediate buffers.
163 // For now we just suck it up and create intermediate buffers.
165 if (dst == null && spaces.length == 0)
166 throw new IllegalArgumentException();
168 // Make sure input isn't premultiplied by alpha
169 if (src.isAlphaPremultiplied())
171 BufferedImage tmp = createCompatibleDestImage(src, src.getColorModel());
172 copyimage(src, tmp);
173 tmp.coerceData(false);
174 src = tmp;
177 ColorModel scm = src.getColorModel();
178 for (int i = 0; i < spaces.length; i++)
180 ColorModel cm = scm.cloneColorModel(spaces[i]);
181 BufferedImage tmp = createCompatibleDestImage(src, cm);
182 copyimage(src, tmp);
183 src = tmp;
186 // Intermediate conversions leave result in src
187 if (dst == null)
188 return src;
190 // Apply final conversion
191 copyimage(src, dst);
192 return dst;
195 /* (non-Javadoc)
196 * @see java.awt.image.BufferedImageOp#createCompatibleDestImage(java.awt.image.BufferedImage, java.awt.image.ColorModel)
198 public BufferedImage createCompatibleDestImage(BufferedImage src,
199 ColorModel dstCM)
201 // FIXME: set properties to those in src
202 return new BufferedImage(dstCM,
203 src.getRaster().createCompatibleWritableRaster(),
204 src.isPremultiplied,
205 null);
208 public final ICC_Profile[] getICC_Profiles()
210 return profiles;
213 /** Return the rendering hints for this op. */
214 public final RenderingHints getRenderingHints()
216 return hints;
219 /* (non-Javadoc)
220 * @see java.awt.image.RasterOp#filter(java.awt.image.Raster, java.awt.image.WritableRaster)
222 public final WritableRaster filter(Raster src, WritableRaster dest)
224 if (!rasterValid)
225 throw new IllegalArgumentException();
227 // Need to iterate through each color space - there must be at least 2
228 for (int i = 1; i < spaces.length - 1; i++)
230 // FIXME: this is wrong. tmp needs to have the same number of bands as
231 // spaces[i] has.
232 WritableRaster tmp = createCompatibleDestRaster(src);
233 copyraster(src, spaces[i - 1], tmp, spaces[i]);
234 src = tmp;
237 // FIXME: this is wrong. dst needs to have the same number of bands as
238 // spaces[i] has.
239 if (dest == null)
240 dest = createCompatibleDestRaster(src);
241 copyraster(src, spaces[spaces.length - 2],
242 dest, spaces[spaces.length - 1]);
244 return dest;
247 /* (non-Javadoc)
248 * @see java.awt.image.RasterOp#createCompatibleDestRaster(java.awt.image.Raster)
250 public WritableRaster createCompatibleDestRaster(Raster src)
252 return src.createCompatibleWritableRaster();
255 /** Return corresponding destination point for source point.
257 * LookupOp will return the value of src unchanged.
258 * @param src The source point.
259 * @param dst The destination point.
260 * @see java.awt.image.RasterOp#getPoint2D(java.awt.geom.Point2D, java.awt.geom.Point2D)
262 public final Point2D getPoint2D(Point2D src, Point2D dst)
264 if (dst == null) return (Point2D)src.clone();
265 dst.setLocation(src);
266 return dst;
269 /* (non-Javadoc)
270 * @see java.awt.image.BufferedImageOp#getBounds2D(java.awt.image.BufferedImage)
272 public final Rectangle2D getBounds2D(BufferedImage src)
274 return src.getRaster().getBounds();
277 /* (non-Javadoc)
278 * @see java.awt.image.RasterOp#getBounds2D(java.awt.image.Raster)
280 public final Rectangle2D getBounds2D(Raster src)
282 return src.getBounds();
285 // According to Sven de Marothy, we need to copy the src into the dest
286 // using Graphics2D, in order to use the rendering hints.
287 private void copyimage(BufferedImage src, BufferedImage dst)
289 Graphics2D gg = dst.createGraphics();
290 gg.setRenderingHints(hints);
291 gg.drawImage(src, 0, 0, null);
292 gg.dispose();
295 private void copyraster(Raster src, ColorSpace scs, WritableRaster dst,
296 ColorSpace dcs)
298 float[] sbuf = new float[src.getNumBands()];
300 if (hints.get(RenderingHints.KEY_COLOR_RENDERING) ==
301 RenderingHints.VALUE_COLOR_RENDER_QUALITY)
303 // use cie for accuracy
304 for (int y = src.getMinY(); y < src.getHeight() + src.getMinY(); y++)
305 for (int x = src.getMinX(); x < src.getWidth() + src.getMinX(); x++)
306 dst.setPixel(x, y,
307 dcs.fromCIEXYZ(scs.toCIEXYZ(src.getPixel(x, y, sbuf))));
309 else
311 // use rgb - it's probably faster
312 for (int y = src.getMinY(); y < src.getHeight() + src.getMinY(); y++)
313 for (int x = src.getMinX(); x < src.getWidth() + src.getMinX(); x++)
314 dst.setPixel(x, y,
315 dcs.fromRGB(scs.toRGB(src.getPixel(x, y, sbuf))));