Класс FontRenderContext

public class FontRenderContext
extends Object

Класс FontRenderContext служит контейнером для информации, необходимой для правильного измерения текста. Измерение текста может варьироваться из-за правил, сопоставляющих контуры с пикселями, и параметров отрисовки, заданных приложением.

Одним из таких элементов информации является преобразование, масштабирующее типографические точки в пиксели. (Точка определяется как ровно 1/72 дюйма, что немного отличается от традиционного механического измерения точки.) Символ, отображаемый при 12 пт на устройстве с разрешением 600 точек на дюйм, может иметь размер, отличающийся от того же символа, отображаемого при 12 пт на устройстве с разрешением 72 точки на дюйм, из-за таких факторов, как округление до границ пикселей и указанные дизайнером шрифта параметры.

Сглаживание и дробные метрики, заданные приложением, также могут влиять на размер символа из-за округления до границ пикселей.

Обычно экземпляры FontRenderContext получаются из объекта Graphics2D. Объект FontRenderContext, созданный напрямую, скорее всего, не будет представлять никакого реального графического устройства и может привести к неожиданным или неправильным результатам.

Конструкторы

FontRenderContext

protected FontRenderContext()

Создаёт новый объект FontRenderContext.

FontRenderContext

public FontRenderContext(AffineTransform tx,
                         boolean isAntiAliased,
                         boolean usesFractionalMetrics)

Параметры:

tx - преобразование, используемое для масштабирования типографических пунктов до пикселей в этом FontRenderContext. Если null, используется тождественное преобразование.

isAntiAliased - определяет, будет ли у созданного объекта анти-алиасинг.

usesFractionalMetrics - определяет, будет ли у созданного объекта дробные метрики.

FontRenderContext

public FontRenderContext(AffineTransform tx,
                         Object aaHint,
                         Object fmHint)

Создаёт объект FontRenderContext из необязательного AffineTransform и двух значений Object, определяющих, будет ли у созданного объекта анти-алиасинг или дробные метрики.

Параметры:

tx - преобразование, используемое для масштабирования типографических пунктов до пикселей в этом FontRenderContext. Если null, используется тождественное преобразование.

aaHint - одно из значений параметров рендеринга анти-алиасинга текста, определенных в java.awt.RenderingHints. Любое другое значение вызовет IllegalArgumentException. VALUE_TEXT_ANTIALIAS_DEFAULT может быть указано, в этом случае используемый режим зависит от реализации.

fmHint - одно из значений параметров рендеринга дробных метрик текста, определенных в java.awt.RenderingHints. VALUE_FRACTIONALMETRICS_DEFAULT может быть указано, в этом случае используемый режим зависит от реализации. Любое другое значение вызовет IllegalArgumentException.

Исключения:

IllegalArgumentException - если параметры не являются допустимыми значениями.

C момента:

1.6

Методы

isTransformed

public boolean isTransformed()

Указывает, измеряет ли этот объект FontRenderContext текст в преобразованном контексте рендеринга.

Возвращает:

true если у этого объекта FontRenderContext есть атрибут AffineTransform, отличный от тождественного; false в противном случае.

C момента:

1.6

См. также:

getTransform()

getTransformType

public int getTransformType()

Возвращает целочисленный тип аффинного преобразования для этого объекта FontRenderContext, как определено в AffineTransform.getType()

Возвращает:

тип преобразования.

C момента:

1.6

См. также:

AffineTransform

getTransform

public AffineTransform getTransform()

Возвращает преобразование, используемое для масштабирования типографических пунктов до пикселей в этом объекте FontRenderContext.

Возвращает:

преобразование этого объекта FontRenderContext.

См. также:

AffineTransform

isAntiAliased

public boolean isAntiAliased()

Возвращает булево значение, указывающее, указан ли какой-либо антиалиасинг этим объектом FontRenderContext. Вызовите getAntiAliasingHint() для получения конкретного значения параметра рендеринга.

Возвращает:

true, если текст анти-алиасингуется в этом объекте FontRenderContext; false в противном случае.

См. также:

RenderingHints.KEY_TEXT_ANTIALIASING, FontRenderContext(AffineTransform,boolean,boolean), FontRenderContext(AffineTransform,Object,Object)

usesFractionalMetrics

public boolean usesFractionalMetrics()

Возвращает булево значение, указывающее, используется ли режим дробных метрик текста в этом объекте FontRenderContext. Вызовите getFractionalMetricsHint(), чтобы получить соответствующее значение параметра рендеринга.

Возвращает:

true, если для вычислений используются дробные метрики; false в противном случае. в этом объекте FontRenderContext.

См. также:

RenderingHints.KEY_FRACTIONALMETRICS, FontRenderContext(AffineTransform,boolean,boolean), FontRenderContext(AffineTransform,Object,Object)

getAntiAliasingHint

public Object getAntiAliasingHint()

Возвращает значение параметра рендеринга анти-алиасинга текста, используемого в этом объекте FontRenderContext. Оно будет одним из значений параметров рендеринга анти-алиасинга текста, определённых в java.awt.RenderingHints.

Возвращает:

значение параметра рендеринга анти-алиасинга текста, используемого в этом объекте FontRenderContext.

C момента:

1.6

getFractionalMetricsHint

public Object getFractionalMetricsHint()

Возвращает значение параметра рендеринга дробных метрик текста, используемого в этом объекте FontRenderContext. Оно будет одним из значений параметров рендеринга дробных метрик текста, определённых в java.awt.RenderingHints.

Возвращает:

значение параметра рендеринга дробных метрик текста, используемого в этом объекте FontRenderContext.

C момента:

1.6

equals

public boolean equals(Object obj)

Возвращает true, если obj является экземпляром FontRenderContext и имеет такие же значения преобразования, антиалиасинга и дробных метрик, что и этот.

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

equals в классе Object

Параметры:

obj - объект для проверки на равенство

Возвращает:

true если указанный объект равен этому объекту FontRenderContext; false в противном случае.

См. также:

Object.hashCode(), HashMap

equals

public boolean equals(FontRenderContext rhs)

Возвращает true, если rhs имеет такие же значения преобразования, антиалиасинга и дробных метрик, что и этот.

Параметры:

rhs - объект FontRenderContext для проверки на равенство

Возвращает:

true если rhs равен этому объекту FontRenderContext; false в противном случае.

C момента:

1.4

hashCode

public int hashCode()

Возвращает хэш-код для этого объекта FontRenderContext.

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

hashCode в классе Object

Возвращает:

значение хэш-кода для этого объекта.

См. также:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)