Spec-Zone.ru › OpenJDK 21

Класс FontRenderContext

java.lang.Object
java.awt.font.FontRenderContext
public class FontRenderContext extends Object
Класс FontRenderContext — контейнер для информации, необходимой для корректного измерения текста. Измерение текста может меняться из-за правил, которые сопоставляют контуры с пикселями, и настроек рендеринга, заданных приложением.

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

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

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

См. также:
  • RenderingHints.KEY_TEXT_ANTIALIASING
  • RenderingHints.KEY_FRACTIONALMETRICS
  • Graphics2D.getFontRenderContext()
  • LineMetrics

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

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()
Возвращает boolean, указывающий, используется ли какой-либо вид антиалиасинга в этом FontRenderContext.
boolean isTransformed()
Указывает, измеряет ли этот объект FontRenderContext текст в преобразованном контексте рендеринга.
boolean usesFractionalMetrics()
Возвращает boolean, указывающий, используется ли режим дробных метрик текста в этом 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
См. также:
  • getTransform()

getTransformType

public int getTransformType()
Возвращает целочисленный тип аффинного преобразования для этого объекта FontRenderContext, как указано в AffineTransform.getType()
Возвращает:
тип преобразования.
С момента:
1.6
См. также:
  • AffineTransform

getTransform

public AffineTransform getTransform()
Получает преобразование, используемое для масштабирования типографических точек в пиксели в этом объекте FontRenderContext.
Возвращает:
преобразование AffineTransform этого объекта 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.
С момента:
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 в противном случае.
См. также:
  • Object.hashCode()
  • HashMap

equals

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

hashCode

public int hashCode()
Возвращает хэш-код для этого FontRenderContext.
Переопределяет:
hashCode в классе Object
Возвращает:
значение хэш-кода для этого объекта.
См. также:
  • Object.equals(java.lang.Object)
  • System.identityHashCode(java.lang.Object)

© 1993, 2023, 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/21/docs/api/java.desktop/java/awt/font/FontRenderContext.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API