Класс GlyphVector

java.lang.Object

java.awt.font.GlyphVector

Все реализованные интерфейсы:: Cloneable

public abstract class GlyphVector extends Object implements Cloneable

Объект GlyphVector представляет собой коллекцию глифов, содержащую геометрическую информацию для размещения каждого глифа в преобразованном пространстве координат, соответствующем устройству, на котором отображается GlyphVector.

Объект GlyphVector не пытается интерпретировать последовательность глифов, которые он содержит. Связи между соседними глифами в последовательности используются только для определения размещения глифов в пространстве визуальных координат.

Экземпляры GlyphVector создаются объектом Font.

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

GlyphVector связан ровно с одним Font, и может предоставлять данные, полезные только в связи с этим Font. Кроме того, метрики, полученные из GlyphVector, как правило, не масштабируются геометрически, поскольку пикселизация и интервалы зависят от алгоритмов привязки к сетке в рамках Font. Чтобы обеспечить точное измерение GlyphVector и его компонентов-глифов, необходимо указать преобразование масштабирования, режим сглаживания и режим дробных метрик при создании GlyphVector. Эти характеристики могут быть получены от целевого устройства.

Для каждого глифа в GlyphVector можно получить:

позицию глифа
преобразование, связанное с глифом
метрики глифа в контексте GlyphVector. Метрики глифа могут отличаться при различных преобразованиях, заданных пользователем параметрах отрисовки и конкретном экземпляре глифа в рамках GlyphVector.

Изменение данных, используемых для создания GlyphVector не изменяет состояние GlyphVector.

Предоставлены методы для корректировки позиций глифов в рамках GlyphVector. Эти методы наиболее подходят для приложений, выполняющих операции выравнивания для отображения глифов.

Предоставлены методы для преобразования отдельных глифов в рамках GlyphVector. Эти методы, в основном, полезны для специальных эффектов.

Предоставлены методы для возвращения визуальных, логических и пиксельных границ всего GlyphVector или отдельных глифов в рамках GlyphVector.

Предоставлены методы для возвращения Shape для GlyphVector и для отдельных глифов в рамках GlyphVector.

См. также:

Краткое описание полей

Модификатор и тип	Поле	Описание
`static final int`	`FLAG_COMPLEX_GLYPHS`	Флаг, используемый с getLayoutFlags, указывающий, что у этого `GlyphVector` есть сложное отображение глифов на символы (которое не отображает глифы на символы один к одному в строго возрастающем или убывающем порядке, соответствующем направлению строки).
`static final int`	`FLAG_HAS_POSITION_ADJUSTMENTS`	Флаг, используемый с getLayoutFlags, указывающий, что у этого `GlyphVector` есть корректировки позиции.
`static final int`	`FLAG_HAS_TRANSFORMS`	Флаг, используемый с getLayoutFlags, указывающий, что у этого `GlyphVector` есть преобразования для каждого глифа.
`static final int`	`FLAG_MASK`	Маска для поддерживаемых флагов из getLayoutFlags.
`static final int`	`FLAG_RUN_RTL`	Флаг, используемый с getLayoutFlags, указывающий, что у этого `GlyphVector` направление строки справа налево.

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

GlyphVector()

Модификатор	Конструктор	Описание
`protected`	Конструктор для вызова подклассами.

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

Модификатор и тип	Метод	Описание
`abstract boolean`	`equals(GlyphVector set)`	Проверяет, точно ли указанный `GlyphVector` равен этому `GlyphVector`.
`abstract Font`	`getFont()`	Возвращает `Font` связанный с этим `GlyphVector`.
`abstract FontRenderContext`	`getFontRenderContext()`	Возвращает `FontRenderContext` связанный с этим `GlyphVector`.
`int`	`getGlyphCharIndex(int glyphIndex)`	Возвращает индекс символа указанного глифа.
`int[]`	`getGlyphCharIndices(int beginGlyphIndex, int numEntries, int[] codeReturn)`	Возвращает индексы символов указанных глифов.
`abstract int`	`getGlyphCode(int glyphIndex)`	Возвращает код глифа указанного глифа.
`abstract int[]`	`getGlyphCodes(int beginGlyphIndex, int numEntries, int[] codeReturn)`	Возвращает массив кодов глифов для указанных глифов.
`abstract GlyphJustificationInfo`	`getGlyphJustificationInfo(int glyphIndex)`	Возвращает информацию о выравнивании для глифа по указанному индексу в этом `GlyphVector`.
`abstract Shape`	`getGlyphLogicalBounds(int glyphIndex)`	Возвращает логические границы указанного глифа в этом `GlyphVector`.
`abstract GlyphMetrics`	`getGlyphMetrics(int glyphIndex)`	Возвращает метрики глифа по указанному индексу в этом `GlyphVector`.
`abstract Shape`	`getGlyphOutline(int glyphIndex)`	Возвращает `Shape` , внутренняя область которого соответствует визуальному представлению указанного глифа в этом `GlyphVector`.
`Shape`	`getGlyphOutline(int glyphIndex, float x, float y)`	Возвращает `Shape` , внутренняя область которого соответствует визуальному представлению указанного глифа в этом `GlyphVector`, смещенного на x, y.
`Rectangle`	`getGlyphPixelBounds(int index, FontRenderContext renderFRC, float x, float y)`	Возвращает пиксельные границы глифа по индексу, когда этот `GlyphVector` отрисовывается в `Graphics` с данным `FontRenderContext` в заданном месте.
`abstract Point2D`	`getGlyphPosition(int glyphIndex)`	Возвращает положение указанного глифа относительно начала координат этого `GlyphVector`.
`abstract float[]`	`getGlyphPositions(int beginGlyphIndex, int numEntries, float[] positionReturn)`	Возвращает массив положений глифов для указанных глифов.
`abstract AffineTransform`	`getGlyphTransform(int glyphIndex)`	Возвращает преобразование указанного глифа в этом `GlyphVector`.
`abstract Shape`	`getGlyphVisualBounds(int glyphIndex)`	Возвращает визуальные границы указанного глифа в `GlyphVector`.
`int`	`getLayoutFlags()`	Возвращает флаги, описывающие глобальное состояние GlyphVector.
`abstract Rectangle2D`	`getLogicalBounds()`	Возвращает логические границы этого `GlyphVector`.
`abstract int`	`getNumGlyphs()`	Возвращает количество глифов в этом `GlyphVector`.
`abstract Shape`	`getOutline()`	Возвращает `Shape` , внутренняя область которого соответствует визуальному представлению этого `GlyphVector`.
`abstract Shape`	`getOutline(float x, float y)`	Возвращает `Shape` , внутренняя область которого соответствует визуальному представлению этого `GlyphVector` при отрисовке в x, y.
`Rectangle`	`getPixelBounds(FontRenderContext renderFRC, float x, float y)`	Возвращает пиксельные границы этого `GlyphVector` при отрисовке в графике с данным `FontRenderContext` в заданном месте.
`abstract Rectangle2D`	`getVisualBounds()`	Возвращает визуальные границы этого `GlyphVector` Визуальные границы - это ограничивающая рамка контура этого `GlyphVector`.
`abstract void`	`performDefaultLayout()`	Присваивает значения по умолчанию позициям каждого глифа в этом `GlyphVector`.
`abstract void`	`setGlyphPosition(int glyphIndex, Point2D newPos)`	Устанавливает положение указанного глифа в этом `GlyphVector`.
`abstract void`	`setGlyphTransform(int glyphIndex, AffineTransform newTX)`	Устанавливает преобразование указанного глифа в этом `GlyphVector`.

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Подробное описание полей

FLAG_HAS_TRANSFORMS

public static final int FLAG_HAS_TRANSFORMS

Флаг, используемый с getLayoutFlags, указывающий, что у этого GlyphVector есть преобразования для каждого глифа.

С тех пор:

1.4

См. также:

FLAG_HAS_POSITION_ADJUSTMENTS

public static final int FLAG_HAS_POSITION_ADJUSTMENTS

Флаг, используемый с getLayoutFlags, указывающий, что у этого GlyphVector есть корректировки позиций. Когда это значение истинно, позиции глифов не соответствуют накопленным стандартным смещениям глифов (например, если было выполнено кернинг).

С тех пор:

1.4

См. также:

FLAG_RUN_RTL

public static final int FLAG_RUN_RTL

Флаг, используемый с getLayoutFlags, указывающий, что у этого GlyphVector есть направление выполнения справа налево. Это относится к сопоставлению глифов с символами и не подразумевает, что визуальные расположения глифов обязательно находятся в этом порядке, хотя обычно они таковы.

С тех пор:

1.4

См. также:

FLAG_COMPLEX_GLYPHS

public static final int FLAG_COMPLEX_GLYPHS

Флаг, используемый с getLayoutFlags, указывающий, что у этого GlyphVector есть сложное сопоставление глифов с символами (которое не сопоставляет глифы с символами один к одному в строго возрастающем или убывающем порядке, соответствующем направлению выполнения).

С тех пор:

1.4

См. также:

FLAG_MASK

public static final int FLAG_MASK

Маска для поддерживаемых флагов из getLayoutFlags. Следует проверять только биты, охваченные маской.

С тех пор:

1.4

См. также:

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

GlyphVector

protected GlyphVector()

Конструктор для вызова подклассами.

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

getFont

public abstract Font getFont()

Возвращает Font , связанный с этим GlyphVector.

Возвращает:

Font , использованный для создания этого GlyphVector.

См. также:

getFontRenderContext

public abstract FontRenderContext getFontRenderContext()

Возвращает FontRenderContext, связанный с этим GlyphVector.

Возвращает:

FontRenderContext , использованный для создания этого GlyphVector.

См. также:

performDefaultLayout

public abstract void performDefaultLayout()

Назначает стандартные позиции каждому глифу в этом GlyphVector. Это может уничтожить информацию, сгенерированную во время первоначального макета этого GlyphVector.

getNumGlyphs

public abstract int getNumGlyphs()

Возвращает количество глифов в этом GlyphVector.

Возвращает:: количество глифов в этом GlyphVector.

getGlyphCode

public abstract int getGlyphCode(int glyphIndex)

Возвращает код глифа указанного глифа. Это возвращаемое значение не имеет смысла для любого объекта, кроме Font , который создал этот GlyphVector.

Параметры:: glyphIndex - индекс в этом GlyphVector , который соответствует глифу, из которого необходимо извлечь код глифа.
Возвращает:: код глифа глифа в указанном glyphIndex.
Исключения:: IndexOutOfBoundsException - если glyphIndex меньше 0 или больше или равно количеству глифов в этом GlyphVector

getGlyphCodes

public abstract int[] getGlyphCodes(int beginGlyphIndex, int numEntries, int[] codeReturn)

Возвращает массив кодов глифов для указанных глифов. Содержимое этого возвращаемого значения не имеет смысла для чего-либо, кроме Font , используемого для создания этого GlyphVector . Этот метод используется для удобства и повышения производительности при обработке кодов глифов. Если массив не передан, создается новый массив.

Параметры:: beginGlyphIndex - индекс в этом GlyphVector , с которого нужно начать извлечение кодов глифов; numEntries - количество кодов глифов для извлечения; codeReturn - массив, который получает коды глифов и затем возвращается
Возвращает:: массив кодов глифов для указанных глифов.
Исключения:: IllegalArgumentException - если numEntries меньше 0; IndexOutOfBoundsException - если beginGlyphIndex меньше 0; IndexOutOfBoundsException - если сумма beginGlyphIndex и numEntries больше количества глифов в этом GlyphVector

getGlyphCharIndex

public int getGlyphCharIndex(int glyphIndex)

Возвращает индекс символа указанного глифа. Индекс символа — это индекс первого логического символа, представленного глифом. Входная реализация предполагает взаимно однозначное, слева направо сопоставление глифов с символами.

Параметры:: glyphIndex - индекс глифа
Возвращает:: индекс первого символа, представленного глифом
С тех пор:: 1.4

getGlyphCharIndices

public int[] getGlyphCharIndices(int beginGlyphIndex, int numEntries, int[] codeReturn)

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

Параметры:: beginGlyphIndex - индекс первого глифа; numEntries - количество индексов глифов; codeReturn - массив, в который нужно вернуть индексы символов
Возвращает:: массив индексов символов, по одному на глиф.
С тех пор:: 1.4

getLogicalBounds

public abstract Rectangle2D getLogicalBounds()

Возвращает логические границы этого GlyphVector. Этот метод используется при позиционировании этого GlyphVector относительно визуально смежных объектов GlyphVector.

Возвращает:: a Rectangle2D который является логическими границами этого GlyphVector.

getVisualBounds

public abstract Rectangle2D getVisualBounds()

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

Возвращает:: a Rectangle2D ограничивающая рамка этого GlyphVector.

getPixelBounds

public Rectangle getPixelBounds(FontRenderContext renderFRC, float x, float y)

Возвращает пиксельные границы этого GlyphVector при рендеринге в графическом режиме с заданным FontRenderContext в заданном месте. RenderFRC не обязательно должен совпадать с FontRenderContext этого GlyphVector, и может быть null. Если он null, используется FontRenderContext этого GlyphVector. Входная реализация возвращает визуальные границы, смещенные по x, y и округляются до ближайшего целого значения (т. е. возвращает целую прямоугольную область, которая охватывает визуальные границы) и игнорирует FRC. Подклассы должны переопределить этот метод.

Параметры:: renderFRC - FontRenderContext Graphics.; x - координата x, в которой нужно отобразить этот GlyphVector.; y - координата y, в которой нужно отобразить этот GlyphVector.
Возвращает:: a Rectangle ограничивающая пиксели, которые будут затронуты.
С тех пор:: 1.4

getOutline

public abstract Shape getOutline()

Возвращает Shape , внутренняя часть которого соответствует визуальному представлению этого GlyphVector.

Возвращает:: a Shape , являющийся контуром этого GlyphVector.

getOutline

public abstract Shape getOutline(float x, float y)

Возвращает Shape, внутренняя часть которого соответствует визуальному представлению этого GlyphVector при отрисовке в координатах x, y.

Parameters:: x - координата X этого GlyphVector.; y - координата Y этого GlyphVector.
Returns:: Shape, представляющий собой контур этого GlyphVector при отрисовке в указанных координатах.

getGlyphOutline

public abstract Shape getGlyphOutline(int glyphIndex)

Возвращает Shape, внутренняя часть которого соответствует визуальному представлению указанного глифа внутри этого GlyphVector Глиф возвращается относительно начала каждого индивидуального глифа.

Parameters:: glyphIndex - индекс в этом GlyphVector
Returns:: Shape, который представляет собой контур глифа по указанному glyphIndex этого GlyphVector.
Throws:: IndexOutOfBoundsException - если glyphIndex меньше 0 или больше или равно количеству глифов в этом GlyphVector

getGlyphOutline

public Shape getGlyphOutline(int glyphIndex, float x, float y)

Возвращает Shape, внутренняя часть которого соответствует визуальному представлению указанного глифа внутри этого GlyphVector, смещенного до x, y. Глиф возвращается относительно начала каждого индивидуального глифа.

Parameters:: glyphIndex - индекс в этом GlyphVector; x - координата X положения этого GlyphVector; y - координата Y положения этого GlyphVector
Returns:: Shape, который представляет собой контур глифа по указанному glyphIndex этого GlyphVector при отрисовке в указанных координатах.
Throws:: IndexOutOfBoundsException - если glyphIndex меньше 0 или больше или равно количеству глифов в этом GlyphVector
Since:: 1.4

getGlyphPosition

public abstract Point2D getGlyphPosition(int glyphIndex)

Возвращает положение указанного глифа относительно начала этого GlyphVector Если glyphIndex равно числу глифов в этом GlyphVector, этот метод возвращает позицию после последнего глифа. Эта позиция используется для определения продвижения всего GlyphVector.

Parameters:

glyphIndex - индекс в этом GlyphVector

Returns:

объект Point2D, представляющий собой положение глифа по указанному glyphIndex.

Throws:

IndexOutOfBoundsException - если glyphIndex меньше 0 или больше числа глифов в этом GlyphVector

See Also:

setGlyphPosition

public abstract void setGlyphPosition(int glyphIndex, Point2D newPos)

Устанавливает положение указанного глифа внутри этого GlyphVector Если glyphIndex равно числу глифов в этом GlyphVector, этот метод устанавливает положение после последнего глифа. Эта позиция используется для определения продвижения всего GlyphVector.

Parameters:

glyphIndex - индекс в этом GlyphVector

newPos - Point2D в котором нужно расположить глиф по указанному glyphIndex

Throws:

IndexOutOfBoundsException - если glyphIndex меньше 0 или больше числа глифов в этом GlyphVector

See Also:

getGlyphTransform

public abstract AffineTransform getGlyphTransform(int glyphIndex)

Возвращает преобразование указанного глифа внутри этого GlyphVector Преобразование относительно позиции глифа. Если не было применено специального преобразования, возвращается null. Нулевое значение указывает тождественное преобразование.

Parameters:

glyphIndex - индекс в этом GlyphVector

Returns:

объект AffineTransform , который является преобразованием глифа по указанному glyphIndex.

Throws:

IndexOutOfBoundsException - если glyphIndex меньше 0 или больше или равно количеству глифов в этом GlyphVector

See Also:

setGlyphTransform

public abstract void setGlyphTransform(int glyphIndex, AffineTransform newTX)

Устанавливает преобразование указанного глифа внутри этого GlyphVector Преобразование относительно позиции глифа. Аргумент null для newTX указывает, что для указанного глифа не применяется специальное преобразование. Этот метод можно использовать для поворота, отражения, перемещения и масштабирования глифа. Добавление преобразования может привести к существенным изменениям производительности.

Parameters:

glyphIndex - индекс в этом GlyphVector

newTX - новое преобразование глифа по glyphIndex

Throws:

IndexOutOfBoundsException - если glyphIndex меньше 0 или больше или равно количеству глифов в этом GlyphVector

See Also:

getLayoutFlags

public int getLayoutFlags()

Возвращает флаги, описывающие общее состояние GlyphVector. Флаги, не описанные ниже, зарезервированы. Реализация по умолчанию возвращает 0 (т.е. false) для корректировок позиции, преобразований, rtl и сложных флагов. Классы-наследники должны переопределять этот метод и убедиться, что он правильно описывает GlyphVector и соответствует результатам связанных вызовов.

Returns:

целое число, содержащее флаги, описывающие состояние

Since:

1.4

See Also:

getGlyphPositions

public abstract float[] getGlyphPositions(int beginGlyphIndex, int numEntries, float[] positionReturn)

Возвращает массив позиций глифов для указанных глифов. Этот метод используется для удобства и повышения производительности при обработке позиций глифов. Если массив не передан, создается новый массив. Четные элементы массива, начиная с нулевого, представляют координаты X глифа с номером beginGlyphIndex + position/2. Нечетные элементы массива, начиная с первого, представляют координаты Y глифа с номером beginGlyphIndex + (position-1)/2. Если beginGlyphIndex равно числу глифов в этом GlyphVector, этот метод получает позицию после последнего глифа, и эта позиция используется для определения продвижения всего GlyphVector.

Parameters:: beginGlyphIndex - индекс, с которого начинать извлечение позиций глифов; numEntries - количество глифов для извлечения; positionReturn - массив, который получает позиции глифов и затем возвращается.
Returns:: массив позиций глифов, указанных beginGlyphIndex и numEntries.
Throws:: IllegalArgumentException - если numEntries меньше 0; IndexOutOfBoundsException - если beginGlyphIndex меньше 0; IndexOutOfBoundsException - если сумма beginGlyphIndex и numEntries больше количества глифов в этом GlyphVector плюс один

getGlyphLogicalBounds

public abstract Shape getGlyphLogicalBounds(int glyphIndex)

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

Parameters:

glyphIndex - индекс в этом GlyphVector , соответствующий глифу, из которого необходимо получить его логические границы

Returns:

объект Shape, представляющий собой логические границы глифа по указанному glyphIndex.

Throws:

IndexOutOfBoundsException - если glyphIndex меньше 0 или больше или равно количеству глифов в этом GlyphVector

See Also:

getGlyphVisualBounds

public abstract Shape getGlyphVisualBounds(int glyphIndex)

Возвращает визуальные границы указанного глифа внутри GlyphVector. Границы, возвращаемые этим методом, позиционированы относительно начала каждого отдельного глифа.

Параметры:

glyphIndex - индекс в этом GlyphVector, соответствующий глифу, для которого необходимо получить его визуальные границы

Возвращает:

a Shape, представляющий визуальные границы глифа по указанному glyphIndex.

Исключения:

IndexOutOfBoundsException - если glyphIndex меньше 0 или больше или равно количеству глифов в этом GlyphVector

См. также:

getGlyphPixelBounds

public Rectangle getGlyphPixelBounds(int index, FontRenderContext renderFRC, float x, float y)

Возвращает пиксельные границы глифа с заданным индексом, когда этот GlyphVector отображается в Graphics с заданным FontRenderContext в заданном месте. RenderFRC не обязательно должен совпадать с FontRenderContext этого GlyphVector, и может быть null. Если он null, используется FontRenderContext этого GlyphVector. Базовое реализация возвращает визуальные границы глифа, смещенные по x, y и округлённые до ближайшего целого значения, игнорируя FRC. Подклассы должны переопределять этот метод.

Параметры:: index - индекс глифа.; renderFRC - FontRenderContext Graphics.; x - положение по оси X для отображения этого GlyphVector.; y - положение по оси Y для отображения этого GlyphVector.
Возвращает:: a Rectangle , ограничивающий пиксели, которые будут затронуты.
С:: 1.4

getGlyphMetrics

public abstract GlyphMetrics getGlyphMetrics(int glyphIndex)

Возвращает метрики глифа по указанному индексу в этом GlyphVector.

Параметры:: glyphIndex - индекс в этом GlyphVector, соответствующий глифу, для которого необходимо получить его метрики
Возвращает:: объект GlyphMetrics, представляющий метрики глифа по указанному glyphIndex в этом GlyphVector.
Исключения:: IndexOutOfBoundsException - если glyphIndex меньше 0 или больше или равно количеству глифов в этом GlyphVector

getGlyphJustificationInfo

public abstract GlyphJustificationInfo getGlyphJustificationInfo(int glyphIndex)

Возвращает информацию о выравнивании глифа по указанному индексу в этом GlyphVector.

Параметры:: glyphIndex - индекс в этом GlyphVector, соответствующий глифу, для которого необходимо получить его свойства выравнивания
Возвращает:: объект GlyphJustificationInfo, представляющий свойства выравнивания глифа по указанному glyphIndex в этом GlyphVector.
Исключения:: IndexOutOfBoundsException - если glyphIndex меньше 0 или больше или равно количеству глифов в этом GlyphVector

equals

public abstract boolean equals(GlyphVector set)

Проверяет, равен ли указанный GlyphVector этому GlyphVector.

Параметры:: set - указанный GlyphVector для проверки
Возвращает:: true если указанный GlyphVector равен этому GlyphVector; false в противном случае.

© 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/GlyphVector.html