java.awt.image

Класс PixelGrabber

java.lang. Объект

java.awt.image. PixelGrabber

Все Реализованные Интерфейсы:

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]);
          }
      }
 }

 

See Also:

ColorModel.getRGBdefault()

Field Summary

Fields inherited from interface java.awt.image.ImageConsumer

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

Constructor Summary

Constructors

Constructor and Description
PixelGrabber(Image img, int x, int y, int w, int h, boolean forceRGB) Create a PixelGrabber object to grab the (x, y, w, h) rectangular section of pixels from the specified image.
PixelGrabber(Image img, int x, int y, int w, int h, int[] pix, int off, int scansize) Create a PixelGrabber object to grab the (x, y, w, h) rectangular section of pixels from the specified image into the given array.
PixelGrabber(ImageProducer ip, int x, int y, int w, int h, int[] pix, int off, int scansize) Create a PixelGrabber object to grab the (x, y, w, h) rectangular section of pixels from the image produced by the specified ImageProducer into the given array.

Method Summary

Methods

Modifier and Type	Method and Description
void	abortGrabbing() Request the PixelGrabber to abort the image fetch.
ColorModel	getColorModel() Get the ColorModel for the pixels stored in the array.
int	getHeight() Get the height of the pixel buffer (after adjusting for image height).
Объект	getPixels() Get the pixel buffer.
int	getStatus() Return the status of the pixels.
int	getWidth() Get the width of the pixel buffer (after adjusting for image width).
boolean	grabPixels() Request the Image or ImageProducer to start delivering pixels and wait for all of the pixels in the rectangle of interest to be delivered.
boolean	grabPixels(long ms) Request the Image or ImageProducer to start delivering pixels and wait for all of the pixels in the rectangle of interest to be delivered or until the specified timeout has elapsed.
void	imageComplete(int status) The imageComplete method is part of the ImageConsumer API which this class must implement to retrieve the pixels.
void	setColorModel(ColorModel model) The setColorModel method is part of the ImageConsumer API which this class must implement to retrieve the pixels.
void	setDimensions(int width, int height) The setDimensions method is part of the ImageConsumer API which this class must implement to retrieve the pixels.
void	setHints(int hints) The setHints method is part of the ImageConsumer API which this class must implement to retrieve the pixels.
void	setPixels(int srcX, int srcY, int srcW, int srcH, ColorModel model, byte[] pixels, int srcOff, int srcScan) The setPixels method is part of the ImageConsumer API which this class must implement to retrieve the pixels.
void	setPixels(int srcX, int srcY, int srcW, int srcH, ColorModel model, int[] pixels, int srcOff, int srcScan) The setPixels method is part of the ImageConsumer API which this class must implement to retrieve the pixels.
void	setProperties(Hashtable<?,?> props) The setProperties method is part of the ImageConsumer API which this class must implement to retrieve the pixels.
void	startGrabbing() Request the PixelGrabber to start fetching the pixels.
int	status() Returns the status of the pixels.

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)

Create a PixelGrabber object to grab the (x, y, w, h) rectangular section of pixels from the specified image into the given array. The pixels are stored into the array in the default RGB ColorModel. The RGB data for pixel (i, j) where (i, j) is inside the rectangle (x, y, w, h) is stored in the array at pix[(j - y) * scansize + (i - x) + off].

Parameters:

img - the image to retrieve pixels from

x - the x coordinate of the upper left corner of the rectangle of pixels to retrieve from the image, relative to the default (unscaled) size of the image

y - the y coordinate of the upper left corner of the rectangle of pixels to retrieve from the image

w - the width of the rectangle of pixels to retrieve

h - the height of the rectangle of pixels to retrieve

pix - the array of integers which are to be used to hold the RGB pixels retrieved from the image

off - the offset into the array of where to store the first pixel

scansize - the distance from one row of pixels to the next in the array

See Also:

ColorModel.getRGBdefault()

PixelGrabber

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

Create a PixelGrabber object to grab the (x, y, w, h) rectangular section of pixels from the image produced by the specified ImageProducer into the given array. The pixels are stored into the array in the default RGB ColorModel. The RGB data for pixel (i, j) where (i, j) is inside the rectangle (x, y, w, h) is stored in the array at pix[(j - y) * scansize + (i - x) + off].

Parameters:

ip - the ImageProducer that produces the image from which to retrieve pixels

x - the x coordinate of the upper left corner of the rectangle of pixels to retrieve from the image, relative to the default (unscaled) size of the image

y - the y coordinate of the upper left corner of the rectangle of pixels to retrieve from the image

w - the width of the rectangle of pixels to retrieve

h - the height of the rectangle of pixels to retrieve

pix - the array of integers which are to be used to hold the RGB pixels retrieved from the image

off - the offset into the array of where to store the first pixel

scansize - the distance from one row of pixels to the next in the array

See Also:

ColorModel.getRGBdefault()

PixelGrabber

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

Create a PixelGrabber object to grab the (x, y, w, h) rectangular section of pixels from the specified image. The pixels are accumulated in the original ColorModel if the same ColorModel is used for every call to setPixels, otherwise the pixels are accumulated in the default RGB ColorModel. If the forceRGB parameter is true, then the pixels will be accumulated in the default RGB ColorModel anyway. A buffer is allocated by the PixelGrabber to hold the pixels in either case. If (w < 0) or (h < 0), then they will default to the remaining width and height of the source data when that information is delivered.

Parameters:

img - the image to retrieve the image data from

x - the x coordinate of the upper left corner of the rectangle of pixels to retrieve from the image, relative to the default (unscaled) size of the image

y - the y coordinate of the upper left corner of the rectangle of pixels to retrieve from the image

w - the width of the rectangle of pixels to retrieve

h - the height of the rectangle of pixels to retrieve

forceRGB - true if the pixels should always be converted to the default RGB ColorModel

Method Detail

startGrabbing

public void startGrabbing()

Request the PixelGrabber to start fetching the pixels.

abortGrabbing

public void abortGrabbing()

Request the PixelGrabber to abort the image fetch.

grabPixels

public boolean grabPixels()
                   throws InterruptedException

Request the Image or ImageProducer to start delivering pixels and wait for all of the pixels in the rectangle of interest to be delivered.

Returns:

true if the pixels were successfully grabbed, false on abort, error or timeout

Throws:

InterruptedException - Another thread has interrupted this thread.

grabPixels

public boolean grabPixels(long ms)
                   throws InterruptedException

Request the Image or ImageProducer to start delivering pixels and wait for all of the pixels in the rectangle of interest to be delivered or until the specified timeout has elapsed. This method behaves in the following ways, depending on the value of ms:

• If ms == 0, waits until all pixels are delivered
• If ms > 0, waits until all pixels are delivered as timeout expires.
• If ms < 0, returns true если все пиксели захватываются, false иначе и не ожидает.

Параметры:

ms - число миллисекунд, чтобы ожидать пикселей изображения прибыть перед синхронизацией

Возвраты:

истина, если пиксели были успешно захвачены, ложь на аварийное прекращение работы, ошибка или тайм-аут

Броски:

InterruptedException - Другой поток прервал этот поток.

getStatus

public int getStatus()

Возвратите состояние пикселей. Флаги ImageObserver представление доступной информации о пикселе возвращается.

Возвраты:

битовое "ИЛИ" всех соответствующих флагов ImageObserver

См. Также:

ImageObserver

getWidth

public int getWidth()

Получите ширину пиксельного буфера (после корректировки для ширины изображения). Если никакая ширина не была определена для прямоугольника пикселей, чтобы захватить тогда тогда эта информация только будет доступна после того, как изображение будет иметь поставленный размерности.

Возвраты:

заключительная ширина, используемая для пиксельного буфера или-1, если ширина еще не известен

См. Также:

getStatus()

getHeight

public int getHeight()

Получите высоту пиксельного буфера (после корректировки для высоты изображения). Если никакая ширина не была определена для прямоугольника пикселей, чтобы захватить тогда тогда эта информация только будет доступна после того, как изображение будет иметь поставленный размерности.

Возвраты:

заключительная высота, используемая для пиксельного буфера или-1, если высота еще не известен

См. Также:

getStatus()

getPixels

public Object getPixels()

Получите пиксельный буфер. Если PixelGrabber не был создан с явным пикселем буферизуют, чтобы содержать пиксели тогда этот метод возвратит нуль до размера, и формат данных изображения известный. Так как PixelGrabber может возвратиться к накоплению данных в RGB по умолчанию ColorModel в любое время, если исходное изображение использование больше чем один ColorModel, чтобы поставить данные, массив объект, возвращенный этим методом, может измениться в течение долгого времени до захват изображения полон.

Возвраты:

или байтовый массив или международный массив

См. Также:

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

getColorModel

public ColorModel getColorModel()

Получите ColorModel для пикселей, сохраненных в массиве. Если PixelGrabber был создан с явным пиксельным буфером тогда этот метод будет всегда возвращать RGB по умолчанию ColorModel, иначе это может возвратить нуль до ColorModel, используемого ImageProducer известен. Так как PixelGrabber может возвратиться к накоплению данных в RGB по умолчанию ColorModel в любое время, если исходное изображение использование больше чем один ColorModel, чтобы поставить данные, ColorModel объект, возвращенный этим методом, может измениться в течение долгого времени до захват изображения полон и, возможно, не отражает ни одного из ColorModel объекты, который использовался ImageProducer, чтобы поставить пиксели.

Возвраты:

объект ColorModel, используемый для того, чтобы сохранить пиксели

См. Также:

getStatus(), ColorModel.getRGBdefault(), setColorModel(ColorModel)

setDimensions

public void setDimensions(int width,
                 int height)

setDimensions метод является частью API ImageConsumer который этот класс должен реализовать, чтобы получить пиксели.

Отметьте: Этот метод предназначается, чтобы быть вызванным ImageProducer из Изображения, пиксели которого захватываются. Разработчики, использующие этот класс, чтобы получить пиксели от изображения должен избежать вызывать этот метод непосредственно начиная с той работы мог привести к проблемам с получением требуемых пикселей.

Определенный:

setDimensions в интерфейсе ImageConsumer

Параметры:

width - ширина размерности

height - высота размерности

setHints

public void setHints(int hints)

setHints метод является частью API ImageConsumer который этот класс должен реализовать, чтобы получить пиксели.

Отметьте: Этот метод предназначается, чтобы быть вызванным ImageProducer из Изображения, пиксели которого захватываются. Разработчики, использующие этот класс, чтобы получить пиксели от изображения должен избежать вызывать этот метод непосредственно начиная с той работы мог привести к проблемам с получением требуемых пикселей.

Определенный:

setHints в интерфейсе ImageConsumer

Параметры:

hints - ряд подсказок, используемых, чтобы обработать пиксели

setProperties

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

setProperties метод является частью API ImageConsumer который этот класс должен реализовать, чтобы получить пиксели.

Отметьте: Этот метод предназначается, чтобы быть вызванным ImageProducer из Изображения, пиксели которого захватываются. Разработчики, использующие этот класс, чтобы получить пиксели от изображения должен избежать вызывать этот метод непосредственно начиная с той работы мог привести к проблемам с получением требуемых пикселей.

Определенный:

setProperties в интерфейсе ImageConsumer

Параметры:

props - список свойств

setColorModel

public void setColorModel(ColorModel model)

setColorModel метод является частью API ImageConsumer который этот класс должен реализовать, чтобы получить пиксели.

Отметьте: Этот метод предназначается, чтобы быть вызванным ImageProducer из Изображения, пиксели которого захватываются. Разработчики, использующие этот класс, чтобы получить пиксели от изображения должен избежать вызывать этот метод непосредственно начиная с той работы мог привести к проблемам с получением требуемых пикселей.

Определенный:

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)

setPixels метод является частью API ImageConsumer который этот класс должен реализовать, чтобы получить пиксели.

Отметьте: Этот метод предназначается, чтобы быть вызванным ImageProducer из Изображения, пиксели которого захватываются. Разработчики, использующие этот класс, чтобы получить пиксели от изображения должен избежать вызывать этот метод непосредственно начиная с той работы мог привести к проблемам с получением требуемых пикселей.

Определенный:

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)

setPixels метод является частью API ImageConsumer который этот класс должен реализовать, чтобы получить пиксели.

Отметьте: Этот метод предназначается, чтобы быть вызванным ImageProducer из Изображения, пиксели которого захватываются. Разработчики, использующие этот класс, чтобы получить пиксели от изображения должен избежать вызывать этот метод непосредственно начиная с той работы мог привести к проблемам с получением требуемых пикселей.

Определенный:

setPixels в интерфейсе ImageConsumer

Параметры:

srcX - X координат верхнего левого угла из области пикселей, которые будут установлены

srcY - координата Y верхнего левого угла из области пикселей, которые будут установлены

srcW - ширина области пикселей

srcH - высота области пикселей

model - указанное ColorModel

pixels - массив пикселей

srcOff - смещение в пиксельный массив

srcScan - расстояние от одной строки пикселей к следующему в пиксельном массиве

См. Также:

getPixels()

imageComplete

public void imageComplete(int status)

imageComplete метод является частью API ImageConsumer который этот класс должен реализовать, чтобы получить пиксели.

Отметьте: Этот метод предназначается, чтобы быть вызванным ImageProducer из Изображения, пиксели которого захватываются. Разработчики, использующие этот класс, чтобы получить пиксели от изображения должен избежать вызывать этот метод непосредственно начиная с той работы мог привести к проблемам с получением требуемых пикселей.

Определенный:

imageComplete в интерфейсе ImageConsumer

Параметры:

status - состояние загрузки изображения

См. Также:

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

состояние

public int status()

Возвращает состояние пикселей. Флаги ImageObserver представление доступной информации о пикселе возвращается. Этот метод и getStatus имейте та же самая реализация, но getStatus привилегированный метод, потому что это соответствует соглашению именование методов информационного поиска с формой "getXXX".

Возвраты:

битовое "ИЛИ" всех соответствующих флагов ImageObserver

См. Также:

ImageObserver, getStatus()