Module java.desktop

软件包 java.awt.image

Class CropImageFilter

java.lang.Object

java.awt.image.ImageFilter

java.awt.image.CropImageFilter

All Implemented Interfaces:

ImageConsumer ， Cloneable

public class CropImageFilter
extends ImageFilter

用于裁剪图像的ImageFilter类。 该类扩展了基本的ImageFilter类，以提取现有图像的给定矩形区域，并为仅包含提取区域的新图像提供源。 它意味着与FilteredImageSource对象结合使用以产生现有图像的裁剪版本。

另请参见：

FilteredImageSource ， ImageFilter

Field Summary

Fields inherited from interface java.awt.image.ImageConsumer

COMPLETESCANLINES, IMAGEABORTED, IMAGEERROR, RANDOMPIXELORDER, SINGLEFRAME, SINGLEFRAMEDONE, SINGLEPASS, STATICIMAGEDONE, TOPDOWNLEFTRIGHT

Fields inherited from class java.awt.image.ImageFilter

consumer

构造方法摘要

构造方法

Constructor	描述
CropImageFilter(int x, int y, int w, int h)	构造一个CropImageFilter，它从x，y，w和h参数指定的源图像中提取像素的绝对矩形区域。

方法摘要

Modifier and Type	方法	描述
void	setDimensions(int w, int h)	覆盖源图像的尺寸，并将矩形裁剪区域的尺寸传递给ImageConsumer。
void	setPixels(int x, int y, int w, int h, ColorModel model, byte[] pixels, int off, int scansize)	确定所传送的字节像素是否与要提取的区域相交，并仅通过出现在输出区域中的像素子集。
void	setPixels(int x, int y, int w, int h, ColorModel model, int[] pixels, int off, int scansize)	确定所传递的int像素是否与要提取的区域相交，并仅通过出现在输出区域中的像素子集。
void	setProperties(Hashtable<?,?> props)	在添加指定裁剪区域的属性后，沿着源对象的属性传递。

Methods inherited from class java.awt.image.ImageFilter

clone, getFilterInstance, imageComplete, resendTopDownLeftRight, setColorModel, setHints

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造方法详细信息

CropImageFilter

public CropImageFilter(int x,
                       int y,
                       int w,
                       int h)

构造一个CropImageFilter，它从x，y，w和h参数指定的源图像中提取像素的绝对矩形区域。

参数

x - 要提取的矩形顶部的x位置

y - 要提取的矩形顶部的y位置

w - 要提取的矩形的宽度

h - 要提取的矩形的高度

方法详细信息

setProperties

public void setProperties(Hashtable<?,?> props)

在添加指定裁剪区域的属性后，沿着源对象的属性传递。 此方法调用super.setProperties ，这可能会导致添加其他属性。

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

Specified by:

setProperties在接口 ImageConsumer

重写：

setProperties在 ImageFilter

参数

props - 源对象的属性

setDimensions

public void setDimensions(int w,
                          int h)

覆盖源图像的尺寸，并将矩形裁剪区域的尺寸传递给ImageConsumer。

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

Specified by:

setDimensions在接口 ImageConsumer

重写：

setDimensions在 ImageFilter

参数

w - 源图像的宽度

h - 源图像的高度

另请参见：

ImageConsumer

setPixels

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

确定所传送的字节像素是否与要提取的区域相交，并仅通过出现在输出区域中的像素子集。

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

Specified by:

setPixels在接口 ImageConsumer

重写：

setPixels在 ImageFilter

参数

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

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

w - 像素面积的宽度

h - 像素面积的高度

model - 指定的 ColorModel

pixels - 像素数组

off - 偏移到 pixels数组

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

另请参见：

ImageConsumer.setPixels(int, int, int, int, java.awt.image.ColorModel, byte[], int, int)

setPixels

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

确定所传递的int像素是否与要提取的区域相交，并仅通过出现在输出区域中的像素子集。

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

Specified by:

setPixels在接口 ImageConsumer

重写：

setPixels在 ImageFilter

参数

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

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

w - 像素面积的宽度

h - 像素面积的高度

model - 指定的 ColorModel

pixels - 像素数组

off - 偏移到 pixels数组

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

另请参见：

ImageConsumer.setPixels(int, int, int, int, java.awt.image.ColorModel, byte[], int, int)