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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Финализация объявлена устаревшей и подлежит удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания, либо до истечения заданного промежутка реального времени.

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

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.