Класс PixelGrabber

public class PixelGrabber
extends Object
implements ImageConsumer

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

Конструкторы

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) из указанного изображения. Пиксели накапливаются в исходном формате ColorModel, если используется тот же ColorModel для каждого вызова setPixels, в противном случае пиксели накапливаются в формате RGB по умолчанию. Если параметр forceRGB равен true, пиксели будут накапливаться в формате RGB по умолчанию. Буфер для хранения пикселей выделяется PixelGrabber в любом случае. Если (w < 0) или (h < 0), они по умолчанию будут равны оставшейся ширине и высоте исходных данных, когда эта информация будет предоставлена.

Параметры:

img - изображение, из которого извлекаются данные изображения

x - координата x левого верхнего угла прямоугольника пикселей для извлечения из изображения, относительно размера изображения по умолчанию (без масштабирования)

y - координата y левого верхнего угла прямоугольника пикселей для извлечения из изображения

w - ширина прямоугольника пикселей для извлечения

h - высота прямоугольника пикселей для извлечения

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

Методы

startGrabbing

public void startGrabbing()

Запросите PixelGrabber начать извлечение пикселей.

abortGrabbing

public void abortGrabbing()

Запросите PixelGrabber прервать извлечение изображения.

grabPixels

public boolean grabPixels()
                   throws InterruptedException

Запросите изображение или ImageProducer начать передачу пикселей и подождите, пока все пиксели в прямоугольнике интереса будут переданы.

Возвращает:

true, если пиксели были успешно извлечены, false при прерывании, ошибке или истечении времени ожидания

Исключения:

InterruptedException - Другая нить прервала эту нить.

grabPixels

public boolean grabPixels(long ms)
                   throws InterruptedException

Запросите изображение или ImageProducer начать передачу пикселей и подождите, пока все пиксели в прямоугольнике интереса будут переданы или истечёт указанное время ожидания. Этот метод ведет себя следующим образом, в зависимости от значения ms:

• Если ms == 0, ждёт, пока все пиксели будут переданы
• Если ms > 0, ждёт, пока все пиксели будут переданы до истечения времени ожидания.
• Если ms < 0, возвращает true если все пиксели получены, false в противном случае и не ждёт.

Параметры:

ms - количество миллисекунд ожидания доставки пикселей изображения перед истечением времени ожидания

Возвращает:

true, если пиксели были успешно извлечены, false при прерывании, ошибке или истечении времени ожидания

Исключения:

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 не был создан с явным буфером пикселей для хранения пикселей, этот метод вернёт null до тех пор, пока размер и формат данных изображения не будут известны. Поскольку PixelGrabber может в любой момент перейти на накопление данных в формате RGB по умолчанию, если исходное изображение использует более одного 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 по умолчанию, в противном случае он может возвращать null до тех пор, пока ColorModel, используемый ImageProducer, не будет известен. Поскольку PixelGrabber может в любой момент перейти на накопление данных в формате RGB по умолчанию, если исходное изображение использует более одного ColorModel для передачи данных, объект ColorModel, возвращаемый этим методом, может меняться до тех пор, пока захват изображения не завершится, и может не отражать ни один из объектов ColorModel, используемых ImageProducer для передачи пикселей.

Возвращает:

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

См. также:

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

setDimensions

public void setDimensions(int width,
                          int height)

Определено в:

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

Параметры:

width - ширина размера

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

setHints

public void setHints(int hints)

Определено в:

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

Параметры:

hints - набор подсказок для обработки пикселей

setProperties

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

Определено в:

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

Параметры:

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

setColorModel

public void setColorModel(ColorModel model)

Указано в:

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 в интерфейсе 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 в интерфейсе ImageConsumer

Параметры:

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

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

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

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

model - указанный ColorModel

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

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

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

См. также:

getPixels()

imageComplete

public void imageComplete(int status)

Указано в:

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

Параметры:

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

См. также:

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

status

public int status()

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

Возвращает:

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

См. также:

ImageObserver, getStatus()