Класс FontMetrics

protected Font font

Фактический Font, из которого создаются метрики шрифта. Не может быть null.

protected FontMetrics(Font font)

Создает новый объект FontMetrics для получения информации о высоте и ширине указанного Font и конкретных глифов символов в этом Font.

public Font getFont()

Возвращает Font, описываемый этим объектом FontMetrics.

public FontRenderContext getFontRenderContext()

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

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

public int getLeading()

Определяет стандартное отведение Font, описываемого этим объектом FontMetrics. Стандартное отведение, или межстрочный интервал, — это логическое количество пробела между нисходящей частью одной строки текста и восходящей частью следующей строки. Метрика высоты рассчитывается с учетом этого дополнительного пробела.

public int getAscent()

Определяет восходящую часть шрифта Font, описываемого этим объектом FontMetrics. Восходящая часть шрифта — это расстояние от базовой линии шрифта до верхней части большинства буквенно-цифровых символов. Некоторые символы в Font могут выходить за пределы восходящей части шрифта.

public int getDescent()

Определяет нисходящую часть шрифта Font, описываемого этим объектом FontMetrics. Нисходящая часть шрифта — это расстояние от базовой линии шрифта до нижней части большинства буквенно-цифровых символов с нисходящими элементами. Некоторые символы в Font могут выходить за пределы нисходящей части шрифта.

public int getHeight()

Получает стандартную высоту строки текста в этом шрифте. Это расстояние между базовыми линиями смежных строк текста. Это сумма отведения + восходящей части + нисходящей части. Из-за округления это может отличаться от getAscent() + getDescent() + getLeading(). Нет гарантии, что строки текста, расположенные на этом расстоянии, не пересекаются; такие строки могут перекрываться, если некоторые символы выходят за пределы стандартной восходящей или стандартной нисходящей метрики.

public int getMaxAscent()

Определяет максимальную восходящую часть Font, описываемую этим объектом FontMetrics. Ни один символ не выходит за пределы базовой линии шрифта выше этой высоты.

public int getMaxDescent()

Определяет максимальную нисходящую часть Font, описываемую этим объектом FontMetrics. Ни один символ не выходит за пределы базовой линии шрифта ниже этой высоты.

@Deprecated public int getMaxDecent()

Только для обеспечения обратной совместимости.

public int getMaxAdvance()

Возвращает оценку максимальной ширины продвижения любого символа в Font, описываемого этим объектом FontMetrics, с важными оговорками, перечисленными ниже.

Продвижение — это расстояние от самой левой точки, используемой для позиционирования символа, до самой правой точки вдоль базовой линии. Это не то же самое, что видимая ширина глифа, представляющего символ.

Продвижение String не обязательно равно сумме продвижений его символов. Оно может существенно отличаться, если требуется сложное расположение текста для правильного отображения.

Некоторые оговорки относительно полученного значения включают

• Возвращаемое значение зависит от информации из некоторой системной шрифта, и правильность этой информации не контролируется AWT.
• Когда конкретные символы отображаются в виде глифов в некотором контексте отображения, инструкции в самом шрифте вместе с процессом растрирования могут привести к тому, что некоторый глиф будет иметь более широкое продвижение, чем указано.
• Когда шрифт запрашивается с некоторым стилем, например Font.BOLD, для которого нет точного соответствия, методы удовлетворения запрошенного отображения аналогичным образом могут привести к глифам, которые шире, чем указанный максимум.
• В зависимости от реализации, логическому или физическому шрифту AWT может потребоваться найти некоторые символы из одного или нескольких «резервных» шрифтов, когда основной подлежащий физический шрифт не поддерживает символ. Эти шрифты могут быть неизвестны или не учитываться при расчете указанного максимального продвижения. Обычно центр дизайна таких резервных шрифтов относится к другому письму, чем центр дизайна основного шрифта, поэтому их продвижения могут сильно отличаться. Это также может привести к неожиданному результату, что шрифт, такой как Font.MONOSPACED, может отображать глифы, которые не имеют одинаковую ширину.

Никакие из этих оговорок не показаны, так как они являются деталями реализации, и нет практического способа определить, когда они действуют. Приложение, которое нуждается в более точной оценке максимального продвижения и знает подмножество символов, которые оно ожидает отобразить, может запросить продвижение каждого такого символа, чтобы найти самое широкое, однако, как обсуждалось выше, поскольку отображаемая ширина String не обязательно равна сумме продвижений, значение все еще должно использоваться с осторожностью.

В итоге, этот метод не дает абсолютной гарантии, и даже не может гарантировать правильность в пределах некоторой погрешности. Поэтому он должен использоваться, по крайней мере, только для оценки общего пространства, достаточного для отображения некоторого числа пока неизвестных символов из шрифта. И это может быть как завышенной, так и заниженной оценкой в зависимости от конкретного текста и контекста отображения.

public int charWidth(int codePoint)

Возвращает ширину продвижения указанного символа в этом Font. Продвижение — это расстояние от самой левой точки до самой правой точки на базовой линии символа. Обратите внимание, что продвижение String не обязательно равно сумме продвижений его символов.

Этот метод не проверяет, является ли указанный символ допустимым кодом Юникода. Вызывающий метод должен проверить значение символа с помощью Character.isValidCodePoint, если это необходимо.

public int charWidth(char ch)

Возвращает ширину продвижения указанного символа в этом шрифте. Продвижение — это расстояние от самой левой до самой правой точки на базовой линии символа. Обратите внимание, что продвижение String не обязательно равно сумме продвижений его символов.

Примечание: Этот метод не может обрабатывать дополнительные символы. Для поддержки всех символов Юникода, включая дополнительные, используйте метод charWidth(int).

public int stringWidth(String str)

Возвращает общую ширину продвижения для отображения указанной строки в этом шрифте. Продвижение — это расстояние от самой левой до самой правой точки на базовой линии строки.

Обратите внимание, что продвижение String не обязательно равно сумме продвижений его символов.

public int charsWidth(char[] data, int off, int len)

Возвращает общую ширину продвижения для отображения указанного массива символов в этом шрифте. Продвижение — это расстояние от самой левой до самой правой точки на базовой линии строки. Продвижение String не обязательно равно сумме продвижений его символов. Это эквивалентно измерению продвижения символов в указанном диапазоне.

public int bytesWidth(byte[] data, int off, int len)

Возвращает общую ширину продвижения для отображения указанного массива байтов в этом шрифте. Продвижение — это расстояние от самой левой до самой правой точки на базовой линии строки. Продвижение String не обязательно равно сумме продвижений его символов. Это эквивалентно измерению продвижения символов в указанном диапазоне.

public int[] getWidths()

Получает ширины продвижения первых 256 символов в этом шрифте. Продвижение — это расстояние от самой левой до самой правой точки на базовой линии символа. Обратите внимание, что продвижение String не обязательно равно сумме продвижений его символов.

public boolean hasUniformLineMetrics()

Проверяет, имеет ли шрифт равномерные метрики строк. Композитный шрифт может состоять из нескольких разных шрифтов для охвата различных наборов символов. В таких случаях объекты шрифта не равномерны. Разные шрифты могут иметь различный подъем, спуск, метрики и т. д. Эта информация иногда необходима для измерения строк и разбиения строк на строки.

public LineMetrics getLineMetrics(String str, Graphics context)

Возвращает объект LineMetrics для указанной строки в указанном контексте Graphics.

public LineMetrics getLineMetrics(String str, int beginIndex, int limit, Graphics context)

Возвращает объект LineMetrics для указанной строки в указанном контексте Graphics.

public LineMetrics getLineMetrics(char[] chars, int beginIndex, int limit, Graphics context)

Возвращает объект LineMetrics для указанного массива символов в указанном контексте Graphics.

public LineMetrics getLineMetrics(CharacterIterator ci, int beginIndex, int limit, Graphics context)

Возвращает объект LineMetrics для указанного CharacterIterator в указанном контексте Graphics.

public Rectangle2D getStringBounds(String str, Graphics context)

Возвращает область заданного String в указанном Graphics контексте. Область используется для выравнивания String.

Примечание: Возвращаемая область находится в координатах, относительных к базовой линии (см. class notes).

public Rectangle2D getStringBounds(String str, int beginIndex, int limit, Graphics context)

Возвращает область заданного String в указанном Graphics контексте. Область используется для выравнивания String.

Примечание: Возвращаемая область находится в координатах, относительных к базовой линии (см. class notes).

public Rectangle2D getStringBounds(char[] chars, int beginIndex, int limit, Graphics context)

Возвращает область заданного массива символов в указанном Graphics контексте. Область используется для выравнивания String, созданного с указанным массивом символов, beginIndex и limit.

Примечание: Возвращаемая область находится в координатах, относительных к базовой линии (см. class notes).

public Rectangle2D getStringBounds(CharacterIterator ci, int beginIndex, int limit, Graphics context)

Возвращает область символов, индексированных в указанном CharacterIterator в указанном Graphics контексте.

Примечание: Возвращаемая область находится в координатах, относительных к базовой линии (см. class notes).

public Rectangle2D getMaxCharBounds(Graphics context)

Возвращает область символа с максимальной областью в заданном Graphics контексте.

public String toString()

Возвращает представление значений этого объекта FontMetrics в виде String.