java.awt.image

Интерфейс ImageConsumer

Все Известные Классы с реализацией:

AreaAveragingScaleFilter, BufferedImageFilter, CropImageFilter, GrayFilter, ImageFilter, PixelGrabber, ReplicateScaleFilter, RGBImageFilter

public interface ImageConsumer

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

См. Также:

ImageProducer

Полевая Сводка

Поля

Модификатор и Тип	Поле и Описание
static int	COMPLETESCANLINES Пиксели будут поставлены в (сеть магазинов) полные строки развертки за один раз.
static int	IMAGEABORTED Процесс создания изображения был сознательно прерван.
static int	IMAGEERROR С ошибкой встретились, производя изображение.
static int	RANDOMPIXELORDER Пиксели будут поставлены в произвольном порядке.
static int	SINGLEFRAME Изображение содержит единственное статическое изображение.
static int	SINGLEFRAMEDONE Один фрейм изображения полон, но есть больше фреймов, которое будет поставлено.
static int	ОДНОПРОХОДНЫЙ Пиксели будут поставлены в единственной передаче.
static int	STATICIMAGEDONE Изображение полно и нет больше пикселей или фреймов, которые будут поставлены.
static int	TOPDOWNLEFTRIGHT Пиксели будут поставлены в нисходящем, слева направо упорядочат.

Сводка метода

Модификатор и Тип	Метод и Описание
void	imageComplete(int status) imageComplete метод вызывают, когда ImageProducer заканчивается, поставляя все пиксели, которые исходное изображение содержит, или когда единственный фрейм анимации сверхкадра был завершен, или когда ошибка в загрузке или создании изображения произошла.
void	setColorModel(ColorModel model) Устанавливает объект ColorModel, используемый для большинства пикселей, о которых сообщают, используя setPixels вызовы метода.
void	setDimensions(int width, int height) О размерностях исходного изображения сообщают, используя setDimensions вызов метода.
void	setHints(int hintflags) Устанавливает подсказки что использование ImageConsumer, чтобы обработать пиксели, поставленные ImageProducer.
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) Пиксели изображения поставляются, используя один или более звонков в setPixels метод.
void	setProperties(Hashtable<?,?> props) Устанавливает расширяемый список свойств, связанных с этим изображением.

Полевая Деталь

RANDOMPIXELORDER

static final int RANDOMPIXELORDER

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

См. Также:

setHints(int), Постоянные Значения полей

TOPDOWNLEFTRIGHT

static final int TOPDOWNLEFTRIGHT

Пиксели будут поставлены в нисходящем, слева направо упорядочат.

См. Также:

setHints(int), Постоянные Значения полей

COMPLETESCANLINES

static final int COMPLETESCANLINES

Пиксели будут поставлены в (сеть магазинов) полные строки развертки за один раз.

См. Также:

setHints(int), Постоянные Значения полей

ОДНОПРОХОДНЫЙ

static final int SINGLEPASS

Пиксели будут поставлены в единственной передаче. Каждый пиксель появится только в одном звонке в любой из setPixels методов. Примером формата изображения, который не соответствует этому критерию, является прогрессивное изображение JPEG, которое определяет пиксели в многократных передачах, каждый более усовершенствованный чем предыдущее.

См. Также:

setHints(int), Постоянные Значения полей

SINGLEFRAME

static final int SINGLEFRAME

Изображение содержит единственное статическое изображение. Пиксели будут определены в звонках в setPixels методы, и затем imageComplete метод вызовут с флагом STATICIMAGEDONE, после которого не будет поставлено больше данных изображения. Примером типа изображения, который не соответствовал бы этим критериям, будет вывод видео канала, или представление 3-D рендеринга, управляемого пользователем. Конец каждого фрейма в тех типах изображений будет обозначен, вызывая imageComplete с флагом SINGLEFRAMEDONE.

См. Также:

setHints(int), imageComplete(int), Постоянные Значения полей

IMAGEERROR

static final int IMAGEERROR

С ошибкой встретились, производя изображение.

См. Также:

imageComplete(int), Постоянные Значения полей

SINGLEFRAMEDONE

static final int SINGLEFRAMEDONE

Один фрейм изображения полон, но есть больше фреймов, которое будет поставлено.

См. Также:

imageComplete(int), Постоянные Значения полей

STATICIMAGEDONE

static final int STATICIMAGEDONE

Изображение полно и нет больше пикселей или фреймов, которые будут поставлены.

См. Также:

imageComplete(int), Постоянные Значения полей

IMAGEABORTED

static final int IMAGEABORTED

Процесс создания изображения был сознательно прерван.

См. Также:

imageComplete(int), Постоянные Значения полей

Деталь метода

setDimensions

void setDimensions(int width,
                   int height)

О размерностях исходного изображения сообщают, используя setDimensions вызов метода.

Параметры:

width - width исходного изображения

height - height исходного изображения

setProperties

void setProperties(Hashtable<?,?> props)

Устанавливает расширяемый список свойств, связанных с этим изображением.

Параметры:

props - список свойств, которые будут связаны с этим изображением

setColorModel

void setColorModel(ColorModel model)

Устанавливает объект ColorModel, используемый для большинства пикселей, о которых сообщают, используя setPixels вызовы метода. Отметьте, что каждый набор пикселей, поставленных, используя setPixels, содержит свой собственный объект ColorModel, таким образом, никакое предположение не должно быть сделано, что эта модель будет единственной, используемой в поставке пиксельных значений. Известный случай, где многократные объекты ColorModel могут быть замечены, является фильтруемым изображением, когда для каждого набора пикселей, которые это фильтрует, фильтр определяет, могут ли пиксели быть пересланы нетронутые, используя исходный ColorModel, или должны ли пиксели быть изменены (фильтруемые) и передавали использование ColorModel, более удобного для процесса фильтрации.

Параметры:

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

См. Также:

ColorModel

setHints

void setHints(int hintflags)

Устанавливает подсказки что использование ImageConsumer, чтобы обработать пиксели, поставленные ImageProducer. ImageProducer может поставить пиксели в любом порядке, но ImageConsumer может быть в состоянии масштабировать или преобразовать пиксели в место назначения Колормоделя более эффективно или с более высоким качеством, если это знает некоторую информацию о том, как пиксели будут поставлены переднюю сторону. setHints метод нужно вызвать перед любыми звонками в любой из setPixels методов с небольшим количеством маски подсказок о способе, которым будут поставлены пиксели. Если ImageProducer не следует за направляющими линиями для обозначенной подсказки, результаты неопределены.

Параметры:

hintflags - ряд подсказок, что использование ImageConsumer, чтобы обработать пиксели

setPixels

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

Поставляет пиксели изображения с одним или более звонками в этот метод. Каждый вызов определяет расположение и размер прямоугольника исходных пикселей, которые содержатся в массиве пикселей. Указанный объект ColorModel должен использоваться, чтобы преобразовать пиксели в их соответствующий цвет и альфа-компоненты. Пиксель (м., n) сохранен в пиксельном массиве в, индексируют (n * scansize + м. + прочь). Пиксели поставляли, использование этого метода все сохранены как байты.

Параметры:

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

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

w - width области пикселей

h - height области пикселей

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

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

off - смещение в pixels массив

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

См. Также:

ColorModel

setPixels

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

Пиксели изображения поставляются, используя один или более звонков в setPixels метод. Каждый вызов определяет расположение и размер прямоугольника исходных пикселей, которые содержатся в массиве пикселей. Указанный объект ColorModel должен использоваться, чтобы преобразовать пиксели в их соответствующий цвет и альфа-компоненты. Пиксель (м., n) сохранен в пиксельном массиве в, индексируют (n * scansize + м. + прочь). Пиксели поставляли, использование этого метода все сохранены, как ints. этот метод все сохранены как ints.

Параметры:

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

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

w - width области пикселей

h - height области пикселей

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

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

off - смещение в pixels массив

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

См. Также:

ColorModel

imageComplete

void imageComplete(int status)

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

Параметры:

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

См. Также:

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