Spec-Zone.ru › OpenJDK 17

Класс PixelGrabber

java.lang.Object
java.awt.image.PixelGrabber
Все реализованные интерфейсы:
ImageConsumer
public class PixelGrabber extends Object implements ImageConsumer
Класс PixelGrabber реализует интерфейс ImageConsumer, который может быть присоединён к объекту Image или 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()

Краткое описание полей

Поля, объявленные в интерфейсе java.awt.image.ImageConsumer

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

Краткое описание конструкторов

Конструктор Описание
PixelGrabber(ImageProducer ip, int x, int y, int w, int h, int[] pix, int off, int scansize)
Создать объект PixelGrabber для захвата прямоугольного фрагмента пикселей (x, y, w, h) из изображения, созданного указанным ImageProducer, в заданный массив.
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) из указанного изображения в заданный массив.

Краткое описание методов

Модификатор и тип Метод Описание
void abortGrabbing()
Запросить PixelGrabber прервать загрузку изображения.
ColorModel getColorModel()
Получить ColorModel для пикселей, хранящихся в массиве.
int getHeight()
Получить высоту буфера пикселей (после корректировки на высоту изображения).
Object getPixels()
Получить буфер пикселей.
int getStatus()
Возвращает состояние пикселей.
int getWidth()
Получить ширину буфера пикселей (после корректировки на ширину изображения).
boolean grabPixels()
Запросить у Image или ImageProducer начать доставку пикселей и подождать, пока все пиксели в прямоугольнике интереса будут доставлены.
boolean grabPixels(long ms)
Запросить у Image или ImageProducer начать доставку пикселей и подождать, пока все пиксели в прямоугольнике интереса будут доставлены или пока не истечёт указанное время ожидания.
void imageComplete(int status)
Метод imageComplete является частью API ImageConsumer, который должен быть реализован этим классом для получения пикселей.
void setColorModel(ColorModel model)
Метод setColorModel является частью API ImageConsumer, который должен быть реализован этим классом для получения пикселей.
void setDimensions(int width, int height)
Метод setDimensions является частью API ImageConsumer, который должен быть реализован этим классом для получения пикселей.
void setHints(int hints)
Метод setHints является частью API ImageConsumer, который должен быть реализован этим классом для получения пикселей.
void setPixels(int srcX, int srcY, int srcW, int srcH, ColorModel model, byte[] pixels, int srcOff, int srcScan)
Метод setPixels является частью API ImageConsumer, который должен быть реализован этим классом для получения пикселей.
void setPixels(int srcX, int srcY, int srcW, int srcH, ColorModel model, int[] pixels, int srcOff, int srcScan)
Метод setPixels является частью API ImageConsumer, который должен быть реализован этим классом для получения пикселей.
void setProperties(Hashtable<?,?> props)
Метод setProperties является частью API ImageConsumer, который должен быть реализован этим классом для получения пикселей.
void startGrabbing()
Запросить PixelGrabber начать извлечение пикселей.
int status()
Возвращает состояние пикселей.

Методы, объявленные в классе java.lang.Object

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

Подробное описание конструкторов

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 - 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 по умолчанию в любой момент, если исходное изображение использует более одной модели цвета для передачи данных, объект массива, возвращаемый этим методом, может меняться со временем до тех пор, пока захват изображения не будет завершен.
Возвращает:
массив байтов или массив целых чисел
См. также:
  • 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, не будет известна. Поскольку PixelGrabber может перейти к накоплению данных в модели цвета RGB по умолчанию в любой момент, если исходное изображение использует более одной модели цвета для передачи данных, объект 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)

status

public int status()
Возвращает состояние пикселей. Возвращаются флаги ImageObserver, представляющие доступную информацию о пикселях. Этот метод и getStatus имеют одинаковую реализацию, но getStatus является предпочтительным методом, так как он соответствует соглашению об именовании методов получения информации в форме "getXXX".
Возвращает:
побитовое ИЛИ всех соответствующих флагов ImageObserver
См. также:
  • ImageObserver
  • getStatus()

© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/java.desktop/java/awt/image/PixelGrabber.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API