Класс RenderContext

public class RenderContext
extends Object
implements Cloneable

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

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

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

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

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