java.awt.image
类 RGBImageFilter

java.lang.Object
  java.awt.image.ImageFilter
      java.awt.image.RGBImageFilter

所有已实现的接口：

ImageConsumer, Cloneable

直接已知子类：

GrayFilter

public abstract class RGBImageFilter
extends ImageFilter

此类提供一种便捷方式创建 ImageFilter，创建的 ImageFilter 可修改使用默认 RGB ColorModel 图像的像素。这意味着要与 FilteredImageSource 对象结合使用来生成现有图像的过滤形式。该类是一个抽象类，它提供引导所有像素数据通过单独某个方法所需的调用，其中，无论 ImageProducer 正使用何种 ColorModel，该方法每次都会转换默认 RGB ColorModel 中的一个像素。创建可用图像过滤器需要定义的惟一方法是 filterRGB 方法。以下是定义交换图像中红色分量和蓝色分量过滤器的一个例子：

        class RedBlueSwapFilter extends RGBImageFilter {
            public RedBlueSwapFilter() {
                // The filter's operation does not depend on the
                // pixel's location, so IndexColorModels can be
                // filtered directly.
                canFilterIndexColorModel = true;
            }

            public int filterRGB(int x, int y, int rgb) {
                return ((rgb & 0xff00ff00)
                        | ((rgb & 0xff0000) >> 16)
                        | ((rgb & 0xff) << 16));
            }
        }

 

另请参见：

FilteredImageSource, ImageFilter, ColorModel.getRGBdefault()

origmodel

protected ColorModel origmodel

用户调用 substituteColorModel 时将由 newmodel 替换的 ColorModel。

newmodel

protected ColorModel newmodel

用户调用 substituteColorModel 时替换 origmodel 的 ColorModel。

canFilterIndexColorModel

protected boolean canFilterIndexColorModel

此布尔值指示是否可以接受用 filterRGB 方法的颜色过滤替代逐像素过滤，并应用于 IndexColorModel 对象的颜色表项。如果子类的 filterRGB 方法不依赖过滤像素的坐标，则子类应在其构造方法中将此变量设置为 true。

另请参见：

substituteColorModel(java.awt.image.ColorModel, java.awt.image.ColorModel), filterRGB(int, int, int), IndexColorModel

RGBImageFilter

public RGBImageFilter()

setColorModel

public void setColorModel(ColorModel model)

如果 ColorModel 是 IndexColorModel 且子类将 canFilterIndexColorModel 标志设置为 true，则将此处及 setPixels 方法中任何出现原始 ColorModel 对象的地方替换为过滤后的颜色模型。如果 ColorModel 不是 IndexColorModel 或者为 null，则此方法重写由 ImageProducer 使用的默认 ColorModel，并指定默认 RGB ColorModel。

注：此方法应由其像素将被过滤的 Image 的 ImageProducer 调用。使用此类过滤图像像素的开发人员应该避免直接调用此方法，因为该操作可能干扰过滤操作。

指定者：

接口 ImageConsumer 中的 setColorModel

覆盖：

类 ImageFilter 中的 setColorModel

参数：

model - 指定的 ColorModel

另请参见：

ImageConsumer, ColorModel.getRGBdefault()

substituteColorModel

public void substituteColorModel(ColorModel oldcm,
                                 ColorModel newcm)

注册两个用于替换的 ColorModel 对象。如果在运行 setPixels 方法期间遇到 oldcm，则用 newcm 替换它，并不加变动地传递像素（但使用新的 ColorModel 对象）。

参数：

oldcm - 要被动态替换的 ColorModel 对象

newcm - 要动态替换 oldcm 的 ColorModel 对象

filterIndexColorModel

public IndexColorModel filterIndexColorModel(IndexColorModel icm)

过滤 IndexColorModel 对象：通过 filterRGB 函数（RGBImageFilter 子类必须提供该函数）运行该对象颜色表中的每一项。使用坐标 -1 指示将过滤的是颜色表项，而不是实际像素值。

参数：

icm - 要过滤的 IndexColorModel 对象

返回：

表示已过滤颜色的新 IndexColorModel

抛出：

NullPointerException - 如果 icm 为 null

filterRGBPixels

public void filterRGBPixels(int x,
                            int y,
                            int w,
                            int h,
                            int[] pixels,
                            int off,
                            int scansize)

过滤缓冲区中使用默认 RGB ColorModel 的像素：将其一个接一个地传递给 filterRGB 方法。

参数：

x - 像素区域左上角的 X 坐标

y - 像素区域左上角的 Y 坐标

w - 像素区域的宽度

h - 像素区域的高度

pixels - 像素数组

off - pixels 数组中的偏移量

scansize - 数组中从一行像素到下一行像素的距离

另请参见：

ColorModel.getRGBdefault(), filterRGB(int, int, int)

setPixels

public void setPixels(int x,
                      int y,
                      int w,
                      int h,
                      ColorModel model,
                      byte[] pixels,
                      int off,
                      int scansize)

如果 ColorModel 对象就是已转换后的对象，则使用转换后的 ColorModel 传递像素。否则，将字节像素的缓冲区转换为默认 RGB ColorModel，并将转换后的缓冲区传递给 filterRGBPixels 方法进行逐一转换。

注：此方法应由其像素将被过滤的 Image 的 ImageProducer 调用。使用此类过滤图像像素的开发人员应该避免直接调用此方法，因为该操作可能干扰过滤操作。

指定者：

接口 ImageConsumer 中的 setPixels

覆盖：

类 ImageFilter 中的 setPixels

参数：

x - 要设置的像素区域左上角的 X 坐标

y - 要设置的像素区域左上角的 Y 坐标

w - 像素区域的宽度

h - 像素区域的高度

model - 指定的 ColorModel

pixels - 像素数组

off - pixels 数组中的偏移量

scansize - pixels 数组中一行像素到下一行的距离

另请参见：

ColorModel.getRGBdefault(), filterRGBPixels(int, int, int, int, int[], int, int)

setPixels

public void setPixels(int x,
                      int y,
                      int w,
                      int h,
                      ColorModel model,
                      int[] pixels,
                      int off,
                      int scansize)

如果 ColorModel 对象就是已转换后的对象，则使用转换后的 ColorModel 传递像素，否则，将整数像素的缓冲区转换为默认 RGB ColorModel，并将转换后的缓冲区传递给 filterRGBPixels 方法进行逐一转换。将整数像素的缓冲区转换为默认 RGB ColorModel，并将转换后的缓冲区传递给 filterRGBPixels 方法。

注：此方法应由其像素将被过滤的 Image 的 ImageProducer 调用。使用此类过滤图像像素的开发人员应该避免直接调用此方法，因为该操作可能干扰过滤操作。

指定者：

接口 ImageConsumer 中的 setPixels

覆盖：

类 ImageFilter 中的 setPixels

参数：

x - 要设置的像素区域左上角的 X 坐标

y - 要设置的像素区域左上角的 Y 坐标

w - 像素区域的宽度

h - 像素区域的高度

model - 指定的 ColorModel

pixels - 像素数组

off - pixels 数组中的偏移量

scansize - pixels 数组中一行像素到下一行的距离

另请参见：

ColorModel.getRGBdefault(), filterRGBPixels(int, int, int, int, int[], int, int)

filterRGB

public abstract int filterRGB(int x,
                              int y,
                              int rgb)

子类必须指定该方法，以将使用默认 RGB ColorModel 的单个输入像素转换成单个输出像素。

参数：

x - 像素的 X 坐标

y - 像素的 Y 坐标

rgb - 使用默认 RGB 颜色模型的整数像素表示

返回：

使用默认 RGB 颜色模型的过滤后的像素。

另请参见：

ColorModel.getRGBdefault(), filterRGBPixels(int, int, int, int, int[], int, int)

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