Класс RenderContext

java.lang.Object

java.awt.image.renderable.RenderContext

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

public class RenderContext extends Object implements Cloneable

RenderContext инкапсулирует информацию, необходимую для создания определённого изображения из RenderableImage. Он содержит область, подлежащую отрисовке и заданную в терминах, не зависящих от процесса отрисовки, разрешение, при котором выполняется отрисовка, и подсказки, используемые для управления процессом отрисовки.

Пользователи создают RenderContext и передают его в RenderableImage с помощью метода createRendering. Большинство методов RenderContext не предназначены для непосредственного использования приложениями; они используются RenderableImage и классами операторов, которым передаётся RenderContext.

Параметр AffineTransform, передаваемый в этот класс и из него, клонируется. Параметры RenderingHints и Shape не обязательно можно клонировать, поэтому копируются только ссылки на них. Изменение экземпляров RenderingHints или Shape, используемых экземплярами RenderContext, может привести к нежелательным побочным эффектам.

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

Конструктор	Описание
`RenderContext(AffineTransform usr2dev)`	Создаёт RenderContext с заданным преобразованием.
`RenderContext(AffineTransform usr2dev, RenderingHints hints)`	Создаёт RenderContext с заданным преобразованием и подсказками отрисовки.
`RenderContext(AffineTransform usr2dev, Shape aoi)`	Создаёт RenderContext с заданным преобразованием и областью интереса.
`RenderContext(AffineTransform usr2dev, Shape aoi, RenderingHints hints)`	Создаёт RenderContext с заданным преобразованием.

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

Модификатор и тип	Метод	Описание
`Object`	`clone()`	Создаёт копию RenderContext.
`void`	`concatenateTransform(AffineTransform modTransform)`	Изменяет текущее преобразование из пользовательских координат в координаты устройства, добавляя в конец другое преобразование.
`void`	`concetenateTransform(AffineTransform modTransform)`	Устарело. заменено на `concatenateTransform(AffineTransform)`.
`Shape`	`getAreaOfInterest()`	Возвращает область интереса, содержащуюся в данный момент в RenderContext.
`RenderingHints`	`getRenderingHints()`	Возвращает подсказки отрисовки этого `RenderContext`.
`AffineTransform`	`getTransform()`	Возвращает текущее преобразование AffineTransform из пользовательских координат в координаты устройства.
`void`	`preConcatenateTransform(AffineTransform modTransform)`	Изменяет текущее преобразование из пользовательских координат в координаты устройства, добавляя перед ним другое преобразование.
`void`	`preConcetenateTransform(AffineTransform modTransform)`	Устарело. заменено на `preConcatenateTransform(AffineTransform)`.
`void`	`setAreaOfInterest(Shape newAoi)`	Задаёт текущую область интереса.
`void`	`setRenderingHints(RenderingHints hints)`	Задаёт подсказки отрисовки этого `RenderContext`.
`void`	`setTransform(AffineTransform newTransform)`	Задаёт текущее преобразование AffineTransform из пользовательских координат в координаты устройства, содержащееся в RenderContext, равным указанному преобразованию.

Методы, объявленные в классе 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, либо до истечения заданного времени.

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

RenderContext

public RenderContext(AffineTransform usr2dev, Shape aoi, RenderingHints hints)

Создаёт RenderContext с заданным преобразованием. Область интереса задаётся в виде Shape, а подсказки отрисовки — в виде объекта RenderingHints.

Параметры:: usr2dev — AffineTransform.; aoi — Shape, представляющий область интереса.; hints — объект RenderingHints, содержащий подсказки отрисовки.

RenderContext

public RenderContext(AffineTransform usr2dev)

Создаёт RenderContext с заданным преобразованием. Областью интереса считается вся область отрисовываемого объекта. Подсказки отрисовки не используются.

Параметры:: usr2dev — AffineTransform.

RenderContext

public RenderContext(AffineTransform usr2dev, RenderingHints hints)

Создаёт RenderContext с заданным преобразованием и подсказками отрисовки. Областью интереса считается вся область отрисовываемого объекта.

Параметры:: usr2dev — AffineTransform.; hints — объект RenderingHints, содержащий подсказки отрисовки.

RenderContext

public RenderContext(AffineTransform usr2dev, Shape aoi)

Создаёт RenderContext с заданным преобразованием и областью интереса. Область интереса задаётся в виде Shape. Подсказки отрисовки не используются.

Параметры:: usr2dev — AffineTransform.; aoi — Shape, представляющий область интереса.

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

getRenderingHints

public RenderingHints getRenderingHints()

Возвращает подсказки отрисовки этого RenderContext.

Возвращает:

объект RenderingHints, представляющий подсказки отрисовки этого RenderContext.

См. также:

setRenderingHints

public void setRenderingHints(RenderingHints hints)

Задаёт подсказки отрисовки этого RenderContext.

Параметры:

hints — объект RenderingHints, представляющий подсказки отрисовки, назначаемые этому RenderContext.

См. также:

setTransform

public void setTransform(AffineTransform newTransform)

Задаёт текущее преобразование AffineTransform из пользовательских координат в координаты устройства, содержащееся в RenderContext, равным указанному преобразованию.

Параметры:

newTransform — новое преобразование AffineTransform.

См. также:

preConcatenateTransform

public void preConcatenateTransform(AffineTransform modTransform)

Изменяет текущее преобразование из пользовательских координат в координаты устройства, добавляя перед ним другое преобразование. В матричной записи операция выглядит так:

[this] = [modTransform] x [this]

Параметры:: modTransform — преобразование AffineTransform, добавляемое перед текущим преобразованием usr2dev.
Начиная с:: 1.3

preConcetenateTransform

@Deprecated public void preConcetenateTransform(AffineTransform modTransform)

Устарело.

заменено на preConcatenateTransform(AffineTransform).

[this] = [modTransform] x [this]

Этот метод выполняет то же действие, что и метод preConcatenateTransform. Он сохранён для обратной совместимости с предыдущими выпусками, в которых имя метода было написано с ошибкой.

Параметры:: modTransform — преобразование AffineTransform, добавляемое перед текущим преобразованием usr2dev.

concatenateTransform

public void concatenateTransform(AffineTransform modTransform)

Изменяет текущее преобразование из пользовательских координат в координаты устройства, добавляя в конец другое преобразование. В матричной записи операция выглядит так:

[this] = [this] x [modTransform]

Параметры:: modTransform — преобразование AffineTransform, добавляемое в конец текущего преобразования usr2dev.
Начиная с:: 1.3

concetenateTransform

@Deprecated public void concetenateTransform(AffineTransform modTransform)

Устарело.

заменено на concatenateTransform(AffineTransform).

[this] = [this] x [modTransform]

Этот метод выполняет то же действие, что и метод concatenateTransform. Он сохранён для обратной совместимости с предыдущими выпусками, в которых имя метода было написано с ошибкой.

Параметры:: modTransform — преобразование AffineTransform, добавляемое в конец текущего преобразования usr2dev.

getTransform

public AffineTransform getTransform()

Возвращает текущее преобразование AffineTransform из пользовательских координат в координаты устройства.

Возвращает:

ссылку на текущее преобразование AffineTransform.

См. также:

setAreaOfInterest

public void setAreaOfInterest(Shape newAoi)

Задаёт текущую область интереса. Прежняя область отбрасывается.

Параметры:

newAoi — новая область интереса.

См. также:

getAreaOfInterest

public Shape getAreaOfInterest()

Возвращает область интереса, содержащуюся в данный момент в RenderContext.

Возвращает:

ссылку на область интереса RenderContext или null, если она не задана.

См. также:

clone

public Object clone()

Создаёт копию RenderContext. Область интереса копируется по ссылке. Преобразование AffineTransform usr2dev и подсказки клонируются, а область интереса копируется по ссылке.

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

clone в классе Object

Возвращает:

новый клонированный RenderContext.

См. также:

© 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.