Класс 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(RenderingHints)

setRenderingHints

public void setRenderingHints(RenderingHints hints)

Устанавливает параметры рендеринга этого RenderContext.

Параметры:

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

См. также:

getRenderingHints()

setTransform

public void setTransform(AffineTransform newTransform)

Устанавливает текущее преобразование пользовательского устройства AffineTransform, содержащееся в RenderContext, на заданное преобразование.

Параметры:

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

См. также:

getTransform()

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.

См. также:

setTransform(AffineTransform)

setAreaOfInterest

public void setAreaOfInterest(Shape newAoi)

Устанавливает текущую область интереса. Старая область отбрасывается.

Параметры:

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

См. также:

getAreaOfInterest()

getAreaOfInterest

public Shape getAreaOfInterest()

Получает область интереса, содержащуюся в RenderContext.

Возвращает:

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

См. также:

setAreaOfInterest(Shape)

clone

public Object clone()

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

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

clone в классе Object

Возвращает:

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

См. также:

Cloneable

© 1993, 2021, 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/17/docs/api/java.desktop/java/awt/image/renderable/RenderContext.html