Класс RenderContext

java.lang.Object

java.awt.image.renderable.RenderContext

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

public class RenderContext extends Object implements Cloneable

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

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

Параметры 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()`	Возвращает текущее аффинное преобразование из пользовательских координат в координаты устройства.
`void`	`preConcatenateTransform(AffineTransform modTransform)`	Изменяет текущее преобразование из пользовательских координат в координаты устройства, добавляя перед ним другое преобразование.
`void`	`preConcetenateTransform(AffineTransform modTransform)`	Устарело. заменён на `preConcatenateTransform(AffineTransform)`.
`void`	`setAreaOfInterest(Shape newAoi)`	Задаёт текущую область интереса.
`void`	`setRenderingHints(RenderingHints hints)`	Задаёт подсказки отображения этого `RenderContext`.
`void`	`setTransform(AffineTransform newTransform)`	Задаёт текущее аффинное преобразование из пользовательских координат в координаты устройства, содержащееся в RenderContext, равным заданному преобразованию.

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

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

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

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)

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

См. также:

setAreaOfInterest

public void setAreaOfInterest(Shape newAoi)

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

Параметры:

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

См. также:

getAreaOfInterest

public Shape getAreaOfInterest()

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

Возвращает:

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

См. также:

clone

public Object clone()

Создаёт копию RenderContext. Область интереса копируется по ссылке. Аффинное преобразование 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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/java/awt/image/renderable/RenderContext.html