JavaTM 2 Platform
Standard Ed. 5.0

类 java.awt.image.ColorModel
的使用

使用 ColorModel 的软件包
java.awt 包含用于创建用户界面和绘制图形图像的所有类。 
java.awt.image 提供创建和修改图像的各种类。 
javax.imageio Java Image I/O API 的主要包。 
 

java.awtColorModel 的使用
 

返回 ColorModeljava.awt 中的方法
 ColorModel Component.getColorModel()
          获得用于在输出设备上显示组件的 ColorModel 实例。
abstract  ColorModel Toolkit.getColorModel()
          确定此工具包屏幕的颜色模型。
abstract  ColorModel GraphicsConfiguration.getColorModel()
          返回与此 GraphicsConfiguration 相关的 ColorModel
 ColorModel PaintContext.getColorModel()
          返回输出的 ColorModel
abstract  ColorModel GraphicsConfiguration.getColorModel(int transparency)
          返回与此 GraphicsConfiguration 相关并支持指定透明度的 ColorModel
 

参数类型为 ColorModeljava.awt 中的方法
 CompositeContext Composite.createContext(ColorModel srcColorModel, ColorModel dstColorModel, RenderingHints hints)
          创建一个上下文,其中包含用于执行复合操作的状态。
 CompositeContext AlphaComposite.createContext(ColorModel srcColorModel, ColorModel dstColorModel, RenderingHints hints)
          为合成操作创建一个上下文。
 PaintContext Paint.createContext(ColorModel cm, Rectangle deviceBounds, Rectangle2D userBounds, AffineTransform xform, RenderingHints hints)
          创建并返回用来生成颜色模式的 PaintContext
 PaintContext Color.createContext(ColorModel cm, Rectangle r, Rectangle2D r2d, AffineTransform xform, RenderingHints hints)
          创建并返回用来生成固定颜色模式的 PaintContext
 PaintContext SystemColor.createContext(ColorModel cm, Rectangle r, Rectangle2D r2d, AffineTransform xform, RenderingHints hints)
          创建并返回用来生成纯色模式的 PaintContext
 PaintContext TexturePaint.createContext(ColorModel cm, Rectangle deviceBounds, Rectangle2D userBounds, AffineTransform xform, RenderingHints hints)
          创建并返回用于生成颜色模式的上下文。
 PaintContext GradientPaint.createContext(ColorModel cm, Rectangle deviceBounds, Rectangle2D userBounds, AffineTransform xform, RenderingHints hints)
          创建并返回用来生成颜色模式的上下文。
 

java.awt.imageColorModel 的使用
 

java.awt.imageColorModel 的子类
 class ComponentColorModel
          使用像素值将颜色和 alpha 信息表示为独立样本的 ColorModel 类,该类以独立的数据元素存储每个样本。
 class DirectColorModel
          DirectColorModel 类是使用像素值的 ColorModel 类,像素值以单独样本的形式表示 RGB 颜色和 alpha 信息,并将单个像素的所有样本打包成单个 int、short 或 byte 量。
 class IndexColorModel
          IndexColorModel 类是使用由单个采样所组成的像素值的 ColorModel 类,这些像素值是默认 sRGB 颜色空间中固定 colormap 中的索引。
 class PackedColorModel
          PackedColorModel 类是一个抽象 ColorModel 类,它使用的像素值以单独采样表示颜色和 alpha 信息,并将单个像素的所有采样打包到单个 int、short 或 byte 量中。
 

声明为 ColorModeljava.awt.image 中的字段
protected  ColorModel RGBImageFilter.newmodel
          用户调用 substituteColorModel 时替换 origmodelColorModel
protected  ColorModel RGBImageFilter.origmodel
          用户调用 substituteColorModel 时将由 newmodel 替换的 ColorModel
 

返回 ColorModeljava.awt.image 中的方法
 ColorModel ColorModel.coerceData(WritableRaster raster, boolean isAlphaPremultiplied)
          强制使光栅数据与在 isAlphaPremultiplied 变量中指定的状态匹配,假定当前该数据已由此 ColorModel 正确描述。
 ColorModel DirectColorModel.coerceData(WritableRaster raster, boolean isAlphaPremultiplied)
          强制光栅数据与在 isAlphaPremultiplied 变量中指定的状态匹配,假定此 ColorModel 现在已对该数据进行正确描述。
 ColorModel ComponentColorModel.coerceData(WritableRaster raster, boolean isAlphaPremultiplied)
          强制使光栅数据与在 isAlphaPremultiplied 变量中指定的状态匹配,假定当前该数据已由此 ColorModel 正确描述。
 ColorModel RenderedImage.getColorModel()
          返回与此图像相关的 ColorModel。
 ColorModel BufferedImage.getColorModel()
          返回 ColorModel
 ColorModel PixelGrabber.getColorModel()
          获得该数组中所存储像素的 ColorModel。
static ColorModel ColorModel.getRGBdefault()
          返回描述整数 RGB 值的默认格式的 DirectColorModel,该整数 RGB 值可以在便于程序员使用的 AWT 图像接口中的许多方法中使用。
 

参数类型为 ColorModeljava.awt.image 中的方法
 BufferedImage RescaleOp.createCompatibleDestImage(BufferedImage src, ColorModel destCM)
          创建一个具有正确大小和 band 数的经检查的目标图像。
 BufferedImage LookupOp.createCompatibleDestImage(BufferedImage src, ColorModel destCM)
          创建一幅具有正确大小和 band 数的、经过检查的目标图像。
 BufferedImage ConvolveOp.createCompatibleDestImage(BufferedImage src, ColorModel destCM)
          创建具有正确 band 大小和数量的归零目标图像。
 BufferedImage ColorConvertOp.createCompatibleDestImage(BufferedImage src, ColorModel destCM)
          创建给定源的具有正确大小和 band 数量的归零目标图像。
 BufferedImage BufferedImageOp.createCompatibleDestImage(BufferedImage src, ColorModel destCM)
          创建一个具有正确大小和 band 数的经过检查的目标图像。
 BufferedImage AffineTransformOp.createCompatibleDestImage(BufferedImage src, ColorModel destCM)
          创建一个具有正确大小和 band 数的经过检查的目标图像。
 void MemoryImageSource.newPixels(byte[] newpix, ColorModel newmodel, int offset, int scansize)
          改用一个新的 byte 数组以保存此图像的像素。
 void MemoryImageSource.newPixels(int[] newpix, ColorModel newmodel, int offset, int scansize)
          改用一个新的 int 数组以保存此图像的像素。
 void ImageConsumer.setColorModel(ColorModel model)
          设置用于大多数像素的 ColorModel 对象,这些像素使用 setPixels 方法调用进行报告。
 void ImageFilter.setColorModel(ColorModel model)
          过滤 ImageConsumer 接口的 setColorModel 方法中所提供的信息。
 void RGBImageFilter.setColorModel(ColorModel model)
          如果 ColorModel 是 IndexColorModel 且子类将 canFilterIndexColorModel 标志设置为 true,则将这里和 setPixels 方法中任何出现原始 ColorModel 对象的地方替换为过滤后的颜色模型。
 void PixelGrabber.setColorModel(ColorModel model)
          为了检索像素,setColorModel 方法是此类必须实现的 ImageConsumer API 的一部分。
 void BufferedImageFilter.setColorModel(ColorModel model)
          过滤 ImageConsumer 接口的 setColorModel 方法提供的信息。
 void ImageConsumer.setPixels(int x, int y, int w, int h, ColorModel model, byte[] pixels, int off, int scansize)
          一次或多次调用此方法来传递图像的各像素。
 void ImageFilter.setPixels(int x, int y, int w, int h, ColorModel model, byte[] pixels, int off, int scansize)
          过滤由 ImageConsumer 接口的 setPixels 方法所提供的信息,该方法以 byte 数组为参数。
 void RGBImageFilter.setPixels(int x, int y, int w, int h, ColorModel model, byte[] pixels, int off, int scansize)
          如果 ColorModel 对象与已转换的对象相同,则只使用转换后的 ColorModel 传递像素。
 void ReplicateScaleFilter.setPixels(int x, int y, int w, int h, ColorModel model, byte[] pixels, int off, int scansize)
          从传递的 byte pixels 中选择目标缩放图像需要的行和列,并只传递这些所需的行和列,必要时可复制。
 void PixelGrabber.setPixels(int srcX, int srcY, int srcW, int srcH, ColorModel model, byte[] pixels, int srcOff, int srcScan)
          为了检索像素,setPixels 方法是此类必须实现的 ImageConsumer API 的一部分。
 void CropImageFilter.setPixels(int x, int y, int w, int h, ColorModel model, byte[] pixels, int off, int scansize)
          确定已传递的字节像素是否与要提取的区域相交,只传递出现在输出区域的像素子集。
 void BufferedImageFilter.setPixels(int x, int y, int w, int h, ColorModel model, byte[] pixels, int off, int scansize)
          过滤 ImageConsumer 接口(采用字节数组)的 setPixels 方法中提供的信息。
 void AreaAveragingScaleFilter.setPixels(int x, int y, int w, int h, ColorModel model, byte[] pixels, int off, int scansize)
          将已传送 byte 像素的分量组合到累加数组,并发送所有已完成像素行的平均数据。
 void ImageConsumer.setPixels(int x, int y, int w, int h, ColorModel model, int[] pixels, int off, int scansize)
          一次或多次调用 setPixels 方法来传递图像的各像素。
 void ImageFilter.setPixels(int x, int y, int w, int h, ColorModel model, int[] pixels, int off, int scansize)
          过滤由 ImageConsumer 接口的 setPixels 方法所提供的信息,该方法以整数数组为参数。
 void RGBImageFilter.setPixels(int x, int y, int w, int h, ColorModel model, int[] pixels, int off, int scansize)
          如果 ColorModel 对象与已转换的对象相同,则只使用转换后的 ColorModel 传递像素,否则将整数像素的缓冲区转换为默认 RGB ColorModel,并将转换后的缓冲区传递给 filterRGBPixels 方法进行逐一转换。
 void ReplicateScaleFilter.setPixels(int x, int y, int w, int h, ColorModel model, int[] pixels, int off, int scansize)
          从传递的 int pixels 中选择目标缩放图像需要的行和列,并只传递这些所需的行和列,必要时可复制。
 void PixelGrabber.setPixels(int srcX, int srcY, int srcW, int srcH, ColorModel model, int[] pixels, int srcOff, int srcScan)
          为了检索像素,setPixels 方法是此类必须实现的 ImageConsumer API 的一部分。
 void CropImageFilter.setPixels(int x, int y, int w, int h, ColorModel model, int[] pixels, int off, int scansize)
          确定已传递的 int 像素是否与要提取的区域相交,只传递出现在输出区域的像素子集。
 void BufferedImageFilter.setPixels(int x, int y, int w, int h, ColorModel model, int[] pixels, int off, int scansize)
          过滤 ImageConsumer 接口(采用整数数组)的 setPixels 方法中提供的信息。
 void AreaAveragingScaleFilter.setPixels(int x, int y, int w, int h, ColorModel model, int[] pixels, int off, int scansize)
          将已传送 int 像素的分量组合到累加数组,并发送所有已完成像素行的平均数据。
 void RGBImageFilter.substituteColorModel(ColorModel oldcm, ColorModel newcm)
          注册两个用于替换的 ColorModel 对象。
 

参数类型为 ColorModeljava.awt.image 中的构造方法
BufferedImage(ColorModel cm, WritableRaster raster, boolean isRasterPremultiplied, Hashtable<?,?> properties)
          构造一个具有指定 ColorModelRaster 的新 BufferedImage
MemoryImageSource(int w, int h, ColorModel cm, byte[] pix, int off, int scan)
          构造一个使用 byte 数组为 Image 对象生成数据的 ImageProducer 对象。
MemoryImageSource(int w, int h, ColorModel cm, byte[] pix, int off, int scan, Hashtable<?,?> props)
          构造一个使用 byte 数组为 Image 对象生成数据的 ImageProducer 对象。
MemoryImageSource(int w, int h, ColorModel cm, int[] pix, int off, int scan)
          构造一个使用整数数组为 Image 对象生成数据的 ImageProducer 对象。
MemoryImageSource(int w, int h, ColorModel cm, int[] pix, int off, int scan, Hashtable<?,?> props)
          构造一个使用整数数组为 Image 对象生成数据的 ImageProducer 对象。
 

javax.imageioColorModel 的使用
 

声明为 ColorModeljavax.imageio 中的字段
protected  ColorModel ImageTypeSpecifier.colorModel
          将用作原型的 ColorModel
 

返回 ColorModeljavax.imageio 中的方法
 ColorModel ImageTypeSpecifier.getColorModel()
          返回此对象指定的 ColorModel
 

参数类型为 ColorModeljavax.imageio 中的构造方法
ImageTypeSpecifier(ColorModel colorModel, SampleModel sampleModel)
          直接根据 ColorModelSampleModel 构造一个 ImageTypeSpecifier
 


JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策