Spec-Zone.ru › OpenJDK 17

Класс FontRenderContext

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

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

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

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

getTransformType

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

getTransform

public AffineTransform getTransform()
Возвращает преобразование, используемое для масштабирования типографских пунктов до пикселей в этом FontRenderContext.
Возвращает:
преобразование этого объекта AffineTransform.
См. также:
  • 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, 2021, 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/17/docs/api/java.desktop/java/awt/font/FontRenderContext.html

Spec-Zone.ru

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