Класс 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()`	Возвращает текущее 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)

Устанавливает текущее преобразование пользовательского пространства в устройство 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, 2023, 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/21/docs/api/java.desktop/java/awt/image/renderable/RenderContext.html