Класс AreaAveragingScaleFilter

java.awt.image.AreaAveragingScaleFilter

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

public class AreaAveragingScaleFilter extends ReplicateScaleFilter

Класс ImageFilter для масштабирования изображений с помощью простого алгоритма усреднения по площади, обеспечивающего более плавные результаты, чем алгоритм ближайшего соседа.

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

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

См. также:

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

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

destHeight, destWidth, outpixbuf, srccols, srcHeight, srcrows, srcWidth

Модификатор и тип	Поле	Описание
`protected int`	`destHeight`	Целевая высота масштабирования изображения.
`protected int`	`destWidth`	Целевая ширина масштабирования изображения.
`protected Object`	`outpixbuf`	Массив `byte`, инициализированный размером `ReplicateScaleFilter.destWidth` и используемый для передачи строки данных пикселей объекту `ImageConsumer`.
`protected int[]`	`srccols`	Массив `int`, содержащий информацию о столбце пикселей.
`protected int`	`srcHeight`	Высота исходного изображения.
`protected int[]`	`srcrows`	Массив `int`, содержащий информацию о строке пикселей.
`protected int`	`srcWidth`	Ширина исходного изображения.

Поля, объявленные в классе 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`	Пиксели будут передаваться в порядке сверху вниз и слева направо.

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

Конструктор	Описание
`AreaAveragingScaleFilter(int width, int height)`	Создаёт AreaAveragingScaleFilter, масштабируя пиксели исходного изображения в соответствии с параметрами ширины и высоты.

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

Модификатор и тип	Метод	Описание
`void`	`setHints(int hints)`	Определяет, передаются ли данные с необходимыми подсказками, позволяющими алгоритму усреднения выполнить свою работу.
`void`	`setPixels(int x, int y, int w, int h, ColorModel model, byte[] pixels, int off, int scansize)`	Объединяет компоненты переданных пикселей типа byte в массивы накопления и передаёт усреднённые данные для всех завершённых строк пикселей.
`void`	`setPixels(int x, int y, int w, int h, ColorModel model, int[] pixels, int off, int scansize)`	Объединяет компоненты переданных пикселей типа int в массивы накопления и передаёт усреднённые данные для всех завершённых строк пикселей.

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

setDimensions, setProperties

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

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

clone, getFilterInstance, imageComplete, resendTopDownLeftRight, setColorModel

Модификатор и тип	Метод	Описание
`Object`	`clone()`	Клонирует этот объект.
`ImageFilter`	`getFilterInstance(ImageConsumer ic)`	Возвращает уникальный экземпляр объекта ImageFilter, который будет выполнять фильтрацию для указанного ImageConsumer.
`void`	`imageComplete(int status)`	Фильтрует информацию, переданную методу imageComplete интерфейса ImageConsumer.
`void`	`resendTopDownLeftRight(ImageProducer ip)`	Обрабатывает запрос на повторную передачу данных пикселей из `ImageConsumer` в порядке TopDownLeftRight (TDLR).
`void`	`setColorModel(ColorModel model)`	Фильтрует информацию, переданную методу setColorModel интерфейса 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)`	Приостанавливает выполнение текущего потока до его пробуждения, обычно посредством уведомления или прерывания, либо до истечения заданного периода реального времени.

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

AreaAveragingScaleFilter

public AreaAveragingScaleFilter(int width, int height)

Создаёт AreaAveragingScaleFilter, масштабируя пиксели исходного изображения в соответствии с параметрами ширины и высоты.

Параметры:: width — целевая ширина масштабирования изображения; height — целевая высота масштабирования изображения
Вызывает исключение:: IllegalArgumentException — если width равно нулю или height равно нулю

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

setHints

public void setHints(int hints)

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

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

Определён в:

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

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

setHints в классе ImageFilter

Параметры:

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

См. также:

setPixels

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

Объединяет компоненты переданных пикселей типа byte в массивы накопления и передаёт усреднённые данные для всех завершённых строк пикселей. Если при вызове setHints не были указаны необходимые подсказки, обработка передаётся суперклассу, который может масштабировать пиксели независимо от подсказок о порядке их передачи.

Определён в:

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

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

setPixels в классе ReplicateScaleFilter

Параметры:

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 в массивы накопления и передаёт усреднённые данные для всех завершённых строк пикселей. Если при вызове setHints не были указаны необходимые подсказки, обработка передаётся суперклассу, который может масштабировать пиксели независимо от подсказок о порядке их передачи.

Определён в:

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

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

setPixels в классе ReplicateScaleFilter

Параметры:

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.