Класс CropImageFilter

java.lang.Object

java.awt.image.ImageFilter

java.awt.image.CropImageFilter

Все реализуемые интерфейсы:: ImageConsumer, Cloneable

public class CropImageFilter extends ImageFilter

Класс ImageFilter для обрезки изображений. Этот класс расширяет базовый класс ImageFilter, чтобы извлекать заданную прямоугольную область из существующего Image и предоставлять источник нового изображения, содержащего только извлечённую область. Он предназначен для использования вместе с объектом FilteredImageSource для создания обрезанных версий существующих изображений.

См. также:

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

Поля, объявленные в классе ImageFilter

consumer

Модификатор и тип	Поле	Описание
`protected ImageConsumer`	`consumer`	Потребитель конкретного потока данных изображения, для которого этот экземпляр ImageFilter фильтрует данные.

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

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

Модификатор и тип	Поле	Описание
`static final int`	`COMPLETESCANLINES`	Пиксели будут передаваться полными строками сканирования (или кратно им).
`static final int`	`IMAGEABORTED`	Процесс создания изображения был намеренно прерван.
`static final int`	`IMAGEERROR`	При создании изображения произошла ошибка.
`static final int`	`RANDOMPIXELORDER`	Пиксели будут передаваться в произвольном порядке.
`static final int`	`SINGLEFRAME`	Изображение содержит один статический кадр.
`static final int`	`SINGLEFRAMEDONE`	Передача одного кадра изображения завершена, но будут переданы и другие кадры.
`static final int`	`SINGLEPASS`	Пиксели будут переданы за один проход.
`static final int`	`STATICIMAGEDONE`	Передача изображения завершена; больше пикселей или кадров передано не будет.
`static final int`	`TOPDOWNLEFTRIGHT`	Пиксели будут передаваться сверху вниз, слева направо.

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

Конструктор	Описание
`CropImageFilter(int x, int y, int w, int h)`	Создаёт CropImageFilter, извлекающий из исходного Image прямоугольную область пикселей, заданную параметрами x, y, w и h.

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

Модификатор и тип	Метод	Описание
`void`	`setDimensions(int w, int h)`	Переопределяет размеры исходного изображения и передаёт ImageConsumer размеры обрезанной прямоугольной области.
`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)`	Определяет, пересекаются ли переданные пиксели типа int с извлекаемой областью, и передаёт только ту их часть, которая попадает в выходную область.
`void`	`setProperties(Hashtable<?,?> props)`	Передаёт свойства исходного объекта, добавляя свойство, указывающее обрезанную область.

Методы, объявленные в классе ImageFilter

clone, getFilterInstance, imageComplete, resendTopDownLeftRight, setColorModel, setHints

Модификатор и тип	Метод	Описание
`Object`	`clone()`	Создаёт копию этого объекта.
`ImageFilter`	`getFilterInstance(ImageConsumer ic)`	Возвращает уникальный экземпляр объекта ImageFilter, который будет выполнять фильтрацию для указанного ImageConsumer.
`void`	`imageComplete(int status)`	Фильтрует сведения, передаваемые методу imageComplete интерфейса ImageConsumer.
`void`	`resendTopDownLeftRight(ImageProducer ip)`	Обрабатывает запрос на повторную передачу данных пикселей в порядке TopDownLeftRight (TDLR) из `ImageConsumer`.
`void`	`setColorModel(ColorModel model)`	Фильтрует сведения, передаваемые методу setColorModel интерфейса ImageConsumer.
`void`	`setHints(int hints)`	Фильтрует сведения, передаваемые методу setHints интерфейса ImageConsumer.

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

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

Модификатор и тип	Метод	Описание
`boolean`	`equals(Object obj)`	Указывает, равен ли этот объект другому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API может быть удалён в будущей версии. Финализация устарела и может быть удалена в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Приостанавливает текущий поток до пробуждения, обычно посредством уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Приостанавливает текущий поток до пробуждения, обычно посредством уведомления или прерывания, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Приостанавливает текущий поток до пробуждения, обычно посредством уведомления или прерывания, либо до истечения заданного промежутка реального времени.

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

CropImageFilter

public CropImageFilter(int x, int y, int w, int h)

Создает CropImageFilter, извлекающий из исходного Image абсолютную прямоугольную область пикселей, заданную параметрами x, y, w и h.

Параметры:: x — координата x верхней границы извлекаемого прямоугольника; y — координата y верхней границы извлекаемого прямоугольника; w — ширина извлекаемого прямоугольника; h — высота извлекаемого прямоугольника

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

setProperties

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

Передает свойства исходного объекта, добавив свойство, указывающее на обрезанную область. Этот метод вызывает super.setProperties, что может привести к добавлению дополнительных свойств.

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

Определено в:: setProperties в интерфейсе ImageConsumer
Переопределяет:: setProperties в классе ImageFilter
Параметры:: props — свойства исходного объекта

setDimensions

public void setDimensions(int w, int h)

Переопределяет размеры исходного изображения и передает ImageConsumer размеры обрезанной прямоугольной области.

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

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

Переопределяет:

setDimensions в классе ImageFilter

Параметры:

w — ширина исходного изображения

h — высота исходного изображения

См. также:

setPixels

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

Определяет, пересекаются ли переданные пиксели типа byte с извлекаемой областью, и передает только ту их часть, которая попадает в выходную область.

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

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

Переопределяет:

setPixels в классе ImageFilter

Параметры:

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

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

w — ширина области пикселей

h — высота области пикселей

model — указанная ColorModel

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

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

scansize — расстояние между соседними строками пикселей в массиве pixels

См. также:

setPixels

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

Определяет, пересекаются ли переданные пиксели типа int с извлекаемой областью, и передает только ту их часть, которая попадает в выходную область.

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

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

Переопределяет:

setPixels в классе ImageFilter

Параметры:

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

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

w — ширина области пикселей

h — высота области пикселей

model — указанная ColorModel

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

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

scansize — расстояние между соседними строками пикселей в массиве pixels

См. также:

© 1993, 2025, 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.