Класс 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 не обязательно равно сумме продвижений его символов.

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

public int charWidth(char ch)

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

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

public int stringWidth(String str)

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

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

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

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

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

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

public int[] getWidths()

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

public boolean hasUniformLineMetrics()

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

public LineMetrics getLineMetrics(String str, Graphics context)

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

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

Возвращает объект LineMetrics для указанной String в указанном контексте 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.