Класс AreaAveragingScaleFilter

java.awt.image.AreaAveragingScaleFilter

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

public class AreaAveragingScaleFilter extends ReplicateScaleFilter

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

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

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

См. также:

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

Поля, объявленные в классе java.awt.image.ReplicateScaleFilter

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

Поля, объявленные в классе java.awt.image.ImageFilter

consumer

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

COMPLETESCANLINES, IMAGEABORTED, IMAGEERROR, RANDOMPIXELORDER, SINGLEFRAME, SINGLEFRAMEDONE, SINGLEPASS, STATICIMAGEDONE, 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)`	Объединяет компоненты для полученных байтовых пикселей в массивы накопления и отправляет любые усреднённые данные для полных строк пикселей.
`void`	`setPixels(int x, int y, int w, int h, ColorModel model, int[] pixels, int off, int scansize)`	Объединяет компоненты для полученных целочисленных пикселей в массивы накопления и отправляет любые усреднённые данные для полных строк пикселей.

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

setDimensions, setProperties

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

clone, getFilterInstance, imageComplete, resendTopDownLeftRight, setColorModel

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

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

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

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)

Объединяет компоненты для полученных байтовых пикселей в массивы накопления и отправляет любые усреднённые данные для полных строк пикселей. Если в вызове 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/awt/image/AreaAveragingScaleFilter.html