Класс FontRenderContext

java.lang.Object

java.awt.font.FontRenderContext

public class FontRenderContext extends Object

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

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

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

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

См. также:

Краткое описание конструкторов

FontRenderContext()

FontRenderContext(AffineTransform tx,
 boolean isAntiAliased,
 boolean usesFractionalMetrics)

FontRenderContext(AffineTransform tx,
 Object aaHint,
 Object fmHint)

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

Краткое описание методов

Модификатор и тип	Метод	Описание
`boolean`	`equals(FontRenderContext rhs)`	Возвращает true, если rhs имеет те же значения преобразования, антиалиасинга и дробных метрик, что и этот.
`boolean`	`equals(Object obj)`	Возвращает true, если obj является экземпляром FontRenderContext и имеет те же значения преобразования, антиалиасинга и дробных метрик, что и этот.
`Object`	`getAntiAliasingHint()`	Возвращает параметр режима рендеринга антиалиасинга текста, используемый в этом `FontRenderContext`.
`Object`	`getFractionalMetricsHint()`	Возвращает параметр режима рендеринга дробных метрик текста, используемый в этом `FontRenderContext`.
`AffineTransform`	`getTransform()`	Возвращает преобразование, используемое для масштабирования типографических точек в пиксели в этом объекте `FontRenderContext`.
`int`	`getTransformType()`	Возвращает целочисленный тип аффинного преобразования для этого `FontRenderContext`, как указано в `AffineTransform.getType()`
`int`	`hashCode()`	Возвращает хэш-код для этого FontRenderContext.
`boolean`	`isAntiAliased()`	Возвращает логическое значение, указывающее, используется ли какой-либо вид антиалиасинга в этом объекте `FontRenderContext`.
`boolean`	`isTransformed()`	Указывает, измеряет ли этот объект `FontRenderContext` текст в преобразованном контексте рендеринга.
`boolean`	`usesFractionalMetrics()`	Возвращает логическое значение, указывающее, используется ли режим дробных метрик текста в этом `FontRenderContext`.

Методы, объявленные в классе java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

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

FontRenderContext

protected FontRenderContext()

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

FontRenderContext

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

Создает объект FontRenderContext из необязательного AffineTransform и двух значений boolean, определяющих, включает ли вновь созданный объект сглаживание или дробные метрики. В каждом случае логические значения true и false соответствуют значениям подсказок рендеринга ON и OFF соответственно.

Для указания других значений подсказок используйте конструктор, который указывает значения подсказок рендеринга в качестве параметров: FontRenderContext(AffineTransform, Object, Object).

Параметры:: 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 - если подсказки не являются допустимыми значениями.
С:: 1.6

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

isTransformed

public boolean isTransformed()

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

Возвращает:

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

С:

1.6

См. также:

getTransformType

public int getTransformType()

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

Возвращает:

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

С:

1.6

См. также:

getTransform

public AffineTransform getTransform()

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

Возвращает:

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

См. также:

isAntiAliased

public boolean isAntiAliased()

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

Возвращает:

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

См. также:

usesFractionalMetrics

public boolean usesFractionalMetrics()

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

Возвращает:

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

См. также:

getAntiAliasingHint

public Object getAntiAliasingHint()

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

Возвращает:: подсказка режима сглаживания текста, используемая в этом объекте FontRenderContext.
С:: 1.6

getFractionalMetricsHint

public Object getFractionalMetricsHint()

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

Возвращает:: подсказка режима дробных метрик, используемая в этом объекте FontRenderContext.
С:: 1.6

equals

public boolean equals(Object obj)

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

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

equals в классе Object

Параметры:

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

Возвращает:

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

См. также:

equals

public boolean equals(FontRenderContext rhs)

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

Параметры:: rhs - объект FontRenderContext для проверки равенства
Возвращает:: true, если rhs равен этому объекту FontRenderContext; false в противном случае.
С:: 1.4

hashCode

public int hashCode()

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

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

hashCode в классе Object

Возвращает:

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

См. также:

© 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/font/FontRenderContext.html