Класс 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

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

consumer

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

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

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

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

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

Модификатор и тип	Метод	Описание
`void`	`setHints(int hints)`	Определяет, передаются ли данные с необходимыми подсказками, позволяющими алгоритму усреднения выполнить свою работу.
`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)`	Объединяет компоненты переданных целочисленных пикселей в массивы накопления и передаёт усреднённые данные для завершённых строк пикселей.

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

setDimensions, setProperties

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

clone, getFilterInstance, imageComplete, resendTopDownLeftRight, setColorModel

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

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

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

AreaAveragingScaleFilter

public AreaAveragingScaleFilter(int width, int height)

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

Параметры:: 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)

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

Объединяет компоненты переданных целочисленных пикселей в массивы накопления и передаёт усреднённые данные для завершённых строк пикселей. Если при вызове 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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/java/awt/image/AreaAveragingScaleFilter.html