Класс RenderContext

java.lang.Object

java.awt.image.renderable.RenderContext

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

public class RenderContext extends Object implements Cloneable

Класс RenderContext encapsuliрует информацию, необходимую для получения конкретного рендеринга из 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()`	Получает текущее 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, на заданное преобразование.

Методы, объявленные в классе java.lang.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)

Устанавливает текущее преобразование 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.
https://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/awt/image/renderable/RenderContext.html