java.awt.image

Class PixelGrabber

java.lang.Object

java.awt.image.PixelGrabber

All Implemented Interfaces:

ImageConsumer

public class PixelGrabber
extends Object
implements ImageConsumer

的pixelgrabber类实现一个imageconsumer可以附加到图像或imageproducer对象检索图像中的像素的一个子集。这里有一个例子：

 public void handlesinglepixel(int x, int y, int pixel) {
      int alpha = (pixel >> 24) & 0xff;
      int red   = (pixel >> 16) & 0xff;
      int green = (pixel >>  8) & 0xff;
      int blue  = (pixel      ) & 0xff;
      // Deal with the pixel as necessary...
 }

 public void handlepixels(Image img, int x, int y, int w, int h) {
      int[] pixels = new int[w * h];
      PixelGrabber pg = new PixelGrabber(img, x, y, w, h, pixels, 0, w);
      try {
          pg.grabPixels();
      } catch (InterruptedException e) {
          System.err.println("interrupted waiting for pixels!");
          return;
      }
      if ((pg.getStatus() & ImageObserver.ABORT) != 0) {
          System.err.println("image fetch aborted or errored");
          return;
      }
      for (int j = 0; j < h; j++) {
          for (int i = 0; i < w; i++) {
              handlesinglepixel(x+i, y+j, pixels[j * w + i]);
          }
      }
 }

 

另请参见：

ColorModel.getRGBdefault()

Field Summary

Fields inherited from interface java.awt.image.ImageConsumer

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

构造方法摘要

构造方法

Constructor and Description
PixelGrabber(Image img, int x, int y, int w, int h, boolean forceRGB) 创建一个对象pixelgrabber抢（X，Y，W，H）从指定的图像像素的矩形截面。
PixelGrabber(Image img, int x, int y, int w, int h, int[] pix, int off, int scansize) 创建一个对象pixelgrabber抢（X，Y，W，H）矩形像素从指定的图像到给定的数组。
PixelGrabber(ImageProducer ip, int x, int y, int w, int h, int[] pix, int off, int scansize) 创建一个对象pixelgrabber抢（X，Y，W，H）从图像由指定的imageproducer到给定的像素阵列的矩形截面。

方法摘要

Modifier and Type	Method and Description
void	abortGrabbing() 要求pixelgrabber中止图像获取。
ColorModel	getColorModel() 获取存储在阵列的像素的颜色模型。
int	getHeight() 获取像素缓冲区的高度（调整后的图像高度）。
Object	getPixels() 获取像素缓冲区。
int	getStatus() 返回像素的状态。
int	getWidth() 获取像素缓冲区的宽度（调整后的图像宽度）。
boolean	grabPixels() 请求的图像或imageproducer开始交付像素等所有感兴趣的矩形的像素将交付。
boolean	grabPixels(long ms) 请求的图像或imageproducer开始交付像素等所有感兴趣的矩形的像素被交付或在指定的超时时间。
void	imageComplete(int status) 该方法是imagecomplete的imageconsumer API这类部分必须实现检索点。
void	setColorModel(ColorModel model) 该方法是setcolormodel的imageconsumer API这类部分必须实现检索点。
void	setDimensions(int width, int height) 该方法是setdimensions的imageconsumer API这类部分必须实现检索点。
void	setHints(int hints) 该方法是sethints的imageconsumer API这类部分必须实现检索点。
void	setPixels(int srcX, int srcY, int srcW, int srcH, ColorModel model, byte[] pixels, int srcOff, int srcScan) 该方法是imageconsumer SetPixels的API，这类必须实现检索点。
void	setPixels(int srcX, int srcY, int srcW, int srcH, ColorModel model, int[] pixels, int srcOff, int srcScan) 该方法是imageconsumer SetPixels的API，这类必须实现检索点。
void	setProperties(Hashtable<?,?> props) 这是imageconsumer setProperties方法的API，这类必须实现检索点。
void	startGrabbing() 要求pixelgrabber开始取像素。
int	status() 返回像素的状态。

Methods inherited from class java.lang.Object

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

Constructor Detail

PixelGrabber

public PixelGrabber(Image img,
                    int x,
                    int y,
                    int w,
                    int h,
                    int[] pix,
                    int off,
                    int scansize)

创建一个对象pixelgrabber抢（X，Y，W，H）矩形像素从指定的图像到给定的数组。像素的存储在默认的RGB色彩模型的阵列。对于像素的RGB数据（i，j）（i，j），在矩形（X，Y，W，H）是存储在 pix[(j - y) * scansize + (i - x) + off]阵列。

参数

img -图像检索点

x的x坐标的像素的矩形左上角的图像检索，相对于默认的图像大小（缩放）

y -像素的矩形左上角的图像检索的Y坐标

w -矩形像素检索宽度

h -像素的矩形的高度来检索

pix -整数是用来存储RGB像素阵列的图像检索

off -偏移到数组里存储的第一个像素

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

另请参见：

ColorModel.getRGBdefault()

PixelGrabber

public PixelGrabber(ImageProducer ip,
                    int x,
                    int y,
                    int w,
                    int h,
                    int[] pix,
                    int off,
                    int scansize)

创建一个对象pixelgrabber抢（X，Y，W，H）从图像由指定的imageproducer到给定的像素阵列的矩形截面。像素的存储在默认的RGB色彩模型的阵列。对于像素的RGB数据（i，j）（i，j），在矩形（X，Y，W，H）是存储在 pix[(j - y) * scansize + (i - x) + off]阵列。

参数

ip -产生的图像检索的 ImageProducer像素

x的x坐标的像素的矩形左上角的图像检索，相对于默认的图像大小（缩放）

y -像素的矩形左上角的图像检索的Y坐标

w -矩形像素检索宽度

h -像素的矩形的高度来检索

pix -整数是用来存储RGB像素阵列的图像检索

off -偏移到数组里存储的第一个像素

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

另请参见：

ColorModel.getRGBdefault()

PixelGrabber

public PixelGrabber(Image img,
                    int x,
                    int y,
                    int w,
                    int h,
                    boolean forceRGB)

创建一个对象pixelgrabber抢（X，Y，W，H）从指定的图像像素的矩形截面。像素是积累在原来要如果同样要用于每一个电话，SetPixels，否则像素在RGB色彩模型的积累。如果forcergb参数为true，那么像素就会积聚在默认的RGB颜色模型，无论如何。缓冲区是由pixelgrabber分配在任何情况下保持像素。如果 (w < 0)或 (h < 0)，然后他们将默认为剩余的宽度和高度的源数据时，信息传递。

参数

img -图像检索图像数据

x的x坐标的像素的矩形左上角的图像检索，相对于默认的图像大小（缩放）

y -像素的矩形左上角的图像检索的Y坐标

w -矩形像素检索宽度

h -像素的矩形的高度来检索

forceRGB -如果像素应该转换到RGB色彩模型

方法详细信息

startGrabbing

public void startGrabbing()

要求pixelgrabber开始取像素。

abortGrabbing

public void abortGrabbing()

要求pixelgrabber中止图像获取。

grabPixels

public boolean grabPixels()
                   throws InterruptedException

请求的图像或imageproducer开始交付像素等所有感兴趣的矩形的像素将交付。

结果

如果像素成功抓取，错误中止，错误或超时

异常

InterruptedException -另一个线程中断了这个线程。

grabPixels

public boolean grabPixels(long ms)
                   throws InterruptedException

请求的图像或imageproducer开始交付像素等所有感兴趣的矩形的像素被交付或在指定的超时时间。这种方法表现在以下几个方面，根据 ms价值：

• 如果ms == 0，等到所有像素都交付
• 如果ms > 0，等到所有像素为超时到期交付。
• 如果ms < 0，返回true如果所有像素都抓住了，false否则不等待。

参数

ms -毫秒数等图像像素超时前到达

结果

如果像素成功抓取，错误中止，错误或超时

异常

InterruptedException -另一个线程中断了这个线程。

getStatus

public int getStatus()

返回像素的状态。返回表示可用的像素信息的同时标志。

结果

位或所有相关同时标志

另请参见：

ImageObserver

getWidth

public int getWidth()

获取像素缓冲区的宽度（调整后的图像宽度）。如果没有指定宽度为矩形的像素抓住然后这个信息将只可在图像已交付的尺寸。

结果

用于像素缓冲区的最终宽度或- 1如果宽度还不知道

另请参见：

getStatus()

getHeight

public int getHeight()

获取像素缓冲区的高度（调整后的图像高度）。如果没有指定宽度为矩形的像素抓住然后这个信息将只可在图像已交付的尺寸。

结果

用于像素缓冲区或- 1的最终高度，如果高度还不知道

另请参见：

getStatus()

getPixels

public Object getPixels()

获取像素缓冲区。如果PixelGrabber没有建造一个明确的像素缓冲区来保存像素然后这个方法将返回null到图像数据的大小和格式是已知的。由于pixelgrabber可以依靠积累的数据在默认的RGB颜色模型，在任何时间，如果源图像使用多个要传送数据的数组，此方法返回的对象可能会随时间而改变直到图像采集完成。

结果

一个字节数组或数组

另请参见：

getStatus()， setPixels(int, int, int, int, ColorModel, byte[], int, int)， setPixels(int, int, int, int, ColorModel, int[], int, int)

getColorModel

public ColorModel getColorModel()

获取存储在阵列的像素的颜色模型。如果pixelgrabber构建一个明确的像素缓冲然后该方法总是返回默认的RGB色彩模型，否则可能返回null直到imageproducer使用ColorModel是众所周知的。由于pixelgrabber可以依靠积累的数据在默认的RGB颜色模型，在任何时间，如果源图像使用多个要传送数据的色彩模型，此方法返回的对象可能会随时间而改变直到图像采集完成，并不反映任何的对象要被imageproducer使用将像素。

结果

ColorModel对象用于存储像素

另请参见：

getStatus()， ColorModel.getRGBdefault()， setColorModel(ColorModel)

setDimensions

public void setDimensions(int width,
                          int height)

该方法是setdimensions的imageconsumer API这类部分必须实现检索点。

注意：这个方法是由其像素被抓的图像imageproducer。使用此类来从图像中检索像素的开发人员应该避免直接调用该方法，因为该操作可能会导致检索请求的像素的问题。

Specified by:

setDimensions 接口 ImageConsumer

参数

width -尺寸的宽度

height -维度的高度

setHints

public void setHints(int hints)

该方法是sethints的imageconsumer API这类部分必须实现检索点。

注意：这个方法是由其像素被抓的图像imageproducer。使用此类来从图像中检索像素的开发人员应该避免直接调用该方法，因为该操作可能会导致检索请求的像素的问题。

Specified by:

setHints 接口 ImageConsumer

参数

hints -一套用于处理像素的暗示

setProperties

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

这是imageconsumer setProperties方法的API，这类必须实现检索点。

注意：这个方法是由其像素被抓的图像imageproducer。使用此类来从图像中检索像素的开发人员应该避免直接调用该方法，因为该操作可能会导致检索请求的像素的问题。

Specified by:

setProperties 接口 ImageConsumer

参数

props -属性列表

setColorModel

public void setColorModel(ColorModel model)

该方法是setcolormodel的imageconsumer API这类部分必须实现检索点。

注意：这个方法是由其像素被抓的图像imageproducer。使用此类来从图像中检索像素的开发人员应该避免直接调用该方法，因为该操作可能会导致检索请求的像素的问题。

Specified by:

setColorModel 接口 ImageConsumer

参数

model -指定 ColorModel

另请参见：

getColorModel()

setPixels

public void setPixels(int srcX,
                      int srcY,
                      int srcW,
                      int srcH,
                      ColorModel model,
                      byte[] pixels,
                      int srcOff,
                      int srcScan)

该方法是imageconsumer SetPixels的API，这类必须实现检索点。

注意：这个方法是由其像素被抓的图像imageproducer。使用此类来从图像中检索像素的开发人员应该避免直接调用该方法，因为该操作可能会导致检索请求的像素的问题。

Specified by:

setPixels 接口 ImageConsumer

参数

srcX的x坐标的像素区域的左上角是集

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

srcW -像素区域的宽度

srcH -像素区域的高度

model -指定 ColorModel

pixels -像素阵列

srcOff -偏移的像素阵列

srcScan -从一行像素的像素阵列的距离下

另请参见：

getPixels()

setPixels

public void setPixels(int srcX,
                      int srcY,
                      int srcW,
                      int srcH,
                      ColorModel model,
                      int[] pixels,
                      int srcOff,
                      int srcScan)

该方法是imageconsumer SetPixels的API，这类必须实现检索点。

注意：这个方法是由其像素被抓的图像imageproducer。使用此类来从图像中检索像素的开发人员应该避免直接调用该方法，因为该操作可能会导致检索请求的像素的问题。

Specified by:

setPixels 接口 ImageConsumer

参数

srcX的x坐标的像素区域的左上角是集

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

srcW -像素区域的宽度

srcH -像素区域的高度

model -指定 ColorModel

pixels -像素阵列

srcOff -偏移的像素阵列

srcScan -从一行像素的像素阵列的距离下

另请参见：

getPixels()

imageComplete

public void imageComplete(int status)

该方法是imagecomplete的imageconsumer API这类部分必须实现检索点。

注意：这个方法是由其像素被抓的图像imageproducer。使用此类来从图像中检索像素的开发人员应该避免直接调用该方法，因为该操作可能会导致检索请求的像素的问题。

Specified by:

imageComplete 接口 ImageConsumer

参数

status -图片加载状态

另请参见：

ImageProducer.removeConsumer(java.awt.image.ImageConsumer)

status

public int status()

返回像素的状态。返回表示可用的像素信息的同时标志。这种方法和 getStatus有相同的实现，但 getStatus是首选方法，因为它符合公约命名的信息检索方法与形式”的getXXX”。

结果

位或所有相关同时标志

另请参见：

ImageObserver， getStatus()