Класс 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` режим дробных метрик текста.

Методы, объявленные в классе 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 этого FontRenderContext.

См. также:

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://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/java/awt/font/FontRenderContext.html