Класс ReplicateScaleFilter

java.lang.Object

java.awt.image.ImageFilter

java.awt.image.ReplicateScaleFilter

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

Прямые известные подклассы:: AreaAveragingScaleFilter

public class ReplicateScaleFilter extends ImageFilter

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

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

См. также:

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

Модификатор и тип	Поле	Описание
`protected int`	`destHeight`	Целевая высота масштабируемого изображения.
`protected int`	`destWidth`	Целевая ширина масштабируемого изображения.
`protected Object`	`outpixbuf`	Массив `byte`, инициализированный размером `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`	Пиксели будут передаваться сверху вниз, слева направо.

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

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

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

Модификатор и тип	Метод	Описание
`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)`	Выбирает строки и столбцы переданных целочисленных пикселей, необходимые для целевого масштабированного изображения, и передаёт только необходимые строки и столбцы, дублируя их при необходимости.
`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)`	Обрабатывает запрос на повторную передачу данных пикселей из `ImageConsumer` в порядке TopDownLeftRight (TDLR).
`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()`	Заставляет текущий поток ожидать пробуждения, обычно вследствие вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно вследствие вызова notify или interrupt, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно вследствие вызова notify или interrupt, либо до истечения заданного промежутка реального времени.

Подробное описание полей

srcWidth

protected int srcWidth

Ширина исходного изображения.

srcHeight

protected int srcHeight

Высота исходного изображения.

destWidth

protected int destWidth

Целевая ширина для масштабирования изображения.

destHeight

protected int destHeight

Целевая высота для масштабирования изображения.

srcrows

protected int[] srcrows

Массив int, содержащий информацию о строке пикселей.

srccols

protected int[] srccols

Массив int, содержащий информацию о столбце пикселей.

outpixbuf

protected Object outpixbuf

Массив byte, инициализированный размером destWidth и используемый для передачи строки данных пикселей в ImageConsumer.

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

ReplicateScaleFilter

public ReplicateScaleFilter(int width, int height)

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

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

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

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.