Spec-Zone .ru
спецификации, руководства, описания, API
|
public abstract class GlyphVector extends Object implements Cloneable
GlyphVector
объект является набором глифов, содержащих геометрическую информацию для размещения каждого глифа в преобразованном координатном пространстве, которое соответствует устройству на который GlyphVector
в конечном счете выводится на экран. GlyphVector
не делает попытку никакой интерпретации последовательности глифов, которых это содержит. Отношения между смежными глифами в последовательности исключительно используются, чтобы определить размещение глифов в визуальном координатном пространстве.
Экземпляры GlyphVector
создаются a Font
.
В приложении обработки текста, которое может кэшировать промежуточные представления текста, создания и последующего кэширования a GlyphVector
поскольку использование во время рендеринга является самым быстрым методом, чтобы представить визуальное представление символов пользователю.
A GlyphVector
связывается точно с один Font
, и может обеспечить данные, полезные только относительно этого Font
. Кроме того, метрики получаются из a GlyphVector
не являются обычно геометрически масштабируемыми, так как pixelization и интервал зависят от алгоритмов подбора сетки в пределах a Font
. Облегчить точное измерение a GlyphVector
и его компонентные глифы, следует определить преобразование масштабирования, режим сглаживания, и дробный метрический режим, создавая GlyphVector
. Эти характеристики могут быть получены из целевого устройства.
Для каждого глифа в GlyphVector
, можно получить:
GlyphVector
. Метрики глифа могут отличаться под различными преобразованиями, приложение, определенное, представляя подсказки, и определенный экземпляр глифа в пределах GlyphVector
. Изменение данных, используемых, чтобы создать GlyphVector
не изменяет состояние GlyphVector
.
Методы обеспечиваются, чтобы скорректировать позиции глифов в пределах GlyphVector
. Эти методы являются самыми подходящими для приложений, которые выполняют операции выравнивания для представления глифов.
Методы обеспечиваются, чтобы преобразовать отдельных глифов в пределах GlyphVector
. Эти методы прежде всего полезны для спецэффектов.
Методы обеспечиваются, чтобы возвратить и визуальное, логическое, и пиксельные границы всего GlyphVector
или отдельных глифов в пределах GlyphVector
.
Методы обеспечиваются, чтобы возвратить a Shape
для GlyphVector
, и для отдельных глифов в пределах GlyphVector
.
Font
, GlyphMetrics
, TextLayout
Модификатор и Тип | Поле и Описание |
---|---|
static int |
FLAG_COMPLEX_GLYPHS
Флаг, используемый с getLayoutFlags, который указывает что это
GlyphVector имеет сложное отображение глифа к случайной работе (тот, который не отображает глифов на случайные работы, непосредственные в строго порядке по возрастанию или порядке по убыванию, соответствующем направление выполнения). |
static int |
FLAG_HAS_POSITION_ADJUSTMENTS
Флаг, используемый с getLayoutFlags, который указывает что это
GlyphVector имеет корректировки позиции. |
static int |
FLAG_HAS_TRANSFORMS
Флаг, используемый с getLayoutFlags, который указывает что это
GlyphVector имеет на глифа преобразовывает. |
static int |
FLAG_MASK
Маска для поддерживаемых флагов от getLayoutFlags.
|
static int |
FLAG_RUN_RTL
Флаг, используемый с getLayoutFlags, который указывает что это
GlyphVector имеет справа налево выполненное направление. |
Конструктор и Описание |
---|
GlyphVector() |
Модификатор и Тип | Метод и Описание |
---|---|
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)
Возвращает glyphcode указанного глифа.
|
abstract int[] |
getGlyphCodes(int beginGlyphIndex, int numEntries, int[] codeReturn)
Возвращает массив glyphcodes для указанных глифов.
|
abstract GlyphJustificationInfo |
getGlyphJustificationInfo(int glyphIndex)
Возвращается информация о выравнивании для глифа в указанном индексируют в это
GlyphVector . |
abstract Shape |
getGlyphLogicalBounds(int glyphIndex)
Возвращает логические границы указанного глифа в пределах этого
GlyphVector . |
abstract GlyphMetrics |
getGlyphMetrics(int glyphIndex)
Возвращается метрики глифа в указанном индексируют в это
GlyphVector . |
abstract Shape |
getGlyphOutline(int glyphIndex)
Возвраты a
Shape чья внутренняя часть соответствует визуальному представлению указанного глифа в пределах этого GlyphVector . |
Форма |
getGlyphOutline(int glyphIndex, float x, float y)
Возвраты a
Shape чья внутренняя часть соответствует визуальному представлению указанного глифа в пределах этого GlyphVector , смещение к x, y. |
Прямоугольник |
getGlyphPixelBounds(int index, FontRenderContext renderFRC, float x, float y)
Возвращается пиксельные границы глифа в индексируют когда это
GlyphVector представляется в a 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()
Возвраты a
Shape чья внутренняя часть соответствует визуальному представлению этого GlyphVector . |
abstract Shape |
getOutline(float x, float y)
Возвраты a
Shape чья внутренняя часть соответствует визуальному представлению этого GlyphVector когда представлено в x, y. |
Прямоугольник |
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 . |
public static final int FLAG_HAS_TRANSFORMS
GlyphVector
имеет на глифа преобразовывает.public static final int FLAG_HAS_POSITION_ADJUSTMENTS
GlyphVector
имеет корректировки позиции. Когда это - истина, позиции глифа не соответствуют накопленные усовершенствования значения по умолчанию глифов (например, если кернинг был сделан).public static final int FLAG_RUN_RTL
GlyphVector
имеет справа налево выполненное направление. Это обращается к отображению глифа к случайной работе и не подразумевает, что визуальные расположения глифов находятся обязательно в этом порядке, хотя обычно они будут.public static final int FLAG_COMPLEX_GLYPHS
GlyphVector
имеет сложное отображение глифа к случайной работе (тот, который не отображает глифов на случайные работы, непосредственные в строго порядке по возрастанию или порядке по убыванию, соответствующем направление выполнения).public static final int FLAG_MASK
public abstract Font getFont()
Font
связанный с этим GlyphVector
.Font
используемый, чтобы создать это GlyphVector
.Font
public abstract FontRenderContext getFontRenderContext()
FontRenderContext
связанный с этим GlyphVector
.FontRenderContext
используемый, чтобы создать это GlyphVector
.FontRenderContext
, Font
public abstract void performDefaultLayout()
GlyphVector
. Это может уничтожить информацию, сгенерированную во время начального расположения этого GlyphVector
.public abstract int getNumGlyphs()
GlyphVector
.GlyphVector
.public abstract int getGlyphCode(int glyphIndex)
Font
возразите, что создал это GlyphVector
.glyphIndex
- индексирование в это GlyphVector
это соответствует глифу, от которого можно получить glyphcode.glyphIndex
.IndexOutOfBoundsException
- если glyphIndex
меньше чем 0 или больше чем или равный числу глифов в этом GlyphVector
public abstract int[] getGlyphCodes(int beginGlyphIndex, int numEntries, int[] codeReturn)
Font
используемый, чтобы создать это GlyphVector
. Этот метод используется для удобства и производительности, обрабатывая glyphcodes. Если ни в каком массиве не передают, новый массив создается.beginGlyphIndex
- индексирование в это GlyphVector
в котором можно начать получать glyphcodesnumEntries
- число glyphcodes, чтобы получитьcodeReturn
- массив, который получает glyphcodes и тогда возвращаетсяIllegalArgumentException
- если numEntries
меньше чем 0IndexOutOfBoundsException
- если beginGlyphIndex
меньше чем 0IndexOutOfBoundsException
- если сумма beginGlyphIndex
и numEntries
больше чем число глифов в этом GlyphVector
public int getGlyphCharIndex(int glyphIndex)
glyphIndex
- индексирование глифаpublic int[] getGlyphCharIndices(int beginGlyphIndex, int numEntries, int[] codeReturn)
beginGlyphIndex
- индексирование первого глифаnumEntries
- число индексов глифаcodeReturn
- массив, в который можно возвратить символьные индексыpublic abstract Rectangle2D getLogicalBounds()
GlyphVector
. Этот метод используется, располагая это GlyphVector
относительно визуально смежного GlyphVector
объекты.Rectangle2D
это - логические границы этого GlyphVector
.public abstract Rectangle2D getVisualBounds()
GlyphVector
Визуальные границы являются ограничивающим прямоугольником схемы этого GlyphVector
. Из-за растеризации и выравнивания пикселей, возможно, что это поле не включает все пиксели, на которые влияют, представляя это GlyphVector
.Rectangle2D
это - ограничивающий прямоугольник этого GlyphVector
.public Rectangle getPixelBounds(FontRenderContext renderFRC, float x, float y)
GlyphVector
когда представлено в графике с данным FontRenderContext
в данном расположении. renderFRC не должен быть тем же самым как FontRenderContext
из этого GlyphVector
, и может быть нуль. Если это - нуль, FontRenderContext
из этого GlyphVector
используется. Реализация по умолчанию возвращает визуальные границы, смещение к x, y и закругленный к следующему целочисленному значению (то есть возвращает целочисленный прямоугольник, который включает визуальные границы), и игнорирует FRC. Подклассификаторы должны переопределить этот метод.renderFRC
- FontRenderContext
из Graphics
.x
- x-координата, в которой можно представить это GlyphVector
.y
- y-координата, в которой можно представить это GlyphVector
.Rectangle
ограничение пикселей, на которые влияли бы.public abstract Shape getOutline()
Shape
чья внутренняя часть соответствует визуальному представлению этого GlyphVector
.Shape
это - схема этого GlyphVector
.public abstract Shape getOutline(float x, float y)
Shape
чья внутренняя часть соответствует визуальному представлению этого GlyphVector
когда представлено в x, y.x
- X координат этого GlyphVector
.y
- координата Y этого GlyphVector
.Shape
это - схема этого GlyphVector
когда представлено в указанных координатах.public abstract Shape getGlyphOutline(int glyphIndex)
Shape
чья внутренняя часть соответствует визуальному представлению указанного глифа в пределах этого GlyphVector
. Схема, возвращенная этим методом, располагается вокруг источника каждого отдельного глифа.glyphIndex
- индексирование в это GlyphVector
Shape
это - схема глифа в указанном glyphIndex
из этого GlyphVector
.IndexOutOfBoundsException
- если glyphIndex
меньше чем 0 или больше чем или равный числу глифов в этом GlyphVector
public Shape getGlyphOutline(int glyphIndex, float x, float y)
Shape
чья внутренняя часть соответствует визуальному представлению указанного глифа в пределах этого GlyphVector
, смещение к x, y. Схема, возвращенная этим методом, располагается вокруг источника каждого отдельного глифа.glyphIndex
- индексирование в это GlyphVector
x
- X координат расположения этого GlyphVector
y
- координата Y расположения этого GlyphVector
Shape
это - схема глифа в указанном glyphIndex
из этого GlyphVector
когда представлено в указанных координатах.IndexOutOfBoundsException
- если glyphIndex
меньше чем 0 или больше чем или равный числу глифов в этом GlyphVector
public abstract Point2D getGlyphPosition(int glyphIndex)
GlyphVector
. Если glyphIndex
равняется числу глифов в этом GlyphVector
, этот метод возвращает позицию после последнего глифа. Эта позиция используется, чтобы определить усовершенствование всего GlyphVector
.glyphIndex
- индексирование в это GlyphVector
Point2D
объект, который является позицией глифа в указанном glyphIndex
.IndexOutOfBoundsException
- если glyphIndex
меньше чем 0 или больше чем число глифов в этом GlyphVector
setGlyphPosition(int, java.awt.geom.Point2D)
public abstract void setGlyphPosition(int glyphIndex, Point2D newPos)
GlyphVector
. Если glyphIndex
равняется числу глифов в этом GlyphVector
, этот метод устанавливает позицию после последнего глифа. Эта позиция используется, чтобы определить усовершенствование всего GlyphVector
.glyphIndex
- индексирование в это GlyphVector
newPos
- Point2D
в котором можно расположить глифа в указанное glyphIndex
IndexOutOfBoundsException
- если glyphIndex
меньше чем 0 или больше чем число глифов в этом GlyphVector
getGlyphPosition(int)
public abstract AffineTransform getGlyphTransform(int glyphIndex)
GlyphVector
. Преобразование относительно позиции глифа. Если никакое специальное преобразование не было применено, null
может быть возвращен. Нулевой возврат указывает, что идентификационные данные преобразовывают.glyphIndex
- индексирование в это GlyphVector
AffineTransform
это - преобразование глифа в указанном glyphIndex
.IndexOutOfBoundsException
- если glyphIndex
меньше чем 0 или больше чем или равный числу глифов в этом GlyphVector
setGlyphTransform(int, java.awt.geom.AffineTransform)
public abstract void setGlyphTransform(int glyphIndex, AffineTransform newTX)
GlyphVector
. Преобразование относительно позиции глифа. A null
параметр за newTX
указывает, что никакое специальное преобразование не применяется для указанного глифа. Этот метод может использоваться, чтобы повернуть, зеркально отразить, преобразовать и масштабировать глифа. Добавление преобразования может привести к signifant изменениям производительности.glyphIndex
- индексирование в это GlyphVector
newTX
- новое преобразование глифа в glyphIndex
IndexOutOfBoundsException
- если glyphIndex
меньше чем 0 или больше чем или равный числу глифов в этом GlyphVector
getGlyphTransform(int)
public int getLayoutFlags()
FLAG_HAS_POSITION_ADJUSTMENTS
, FLAG_HAS_TRANSFORMS
, FLAG_RUN_RTL
, FLAG_COMPLEX_GLYPHS
, FLAG_MASK
public abstract float[] getGlyphPositions(int beginGlyphIndex, int numEntries, float[] positionReturn)
beginGlyphIndex + position/2
. Нечетные пронумерованные записи массива, начинающиеся, располагают, каждый - координаты Y пронумерованного глифа beginGlyphIndex + (position-1)/2
. Если beginGlyphIndex
равняется числу глифов в этом GlyphVector
, этот метод получает позицию после последнего глифа, и эта позиция используется, чтобы определить усовершенствование всего GlyphVector
.beginGlyphIndex
- индексирование, при котором можно начать получать позиции глифаnumEntries
- число глифов, чтобы получитьpositionReturn
- массив, который получает позиции глифа и тогда возвращается.beginGlyphIndex
и numEntries
.IllegalArgumentException
- если numEntries
меньше чем 0IndexOutOfBoundsException
- если beginGlyphIndex
меньше чем 0IndexOutOfBoundsException
- если сумма beginGlyphIndex
и numEntries
больше чем число глифов в этом GlyphVector
плюс одинpublic abstract Shape getGlyphLogicalBounds(int glyphIndex)
GlyphVector
. У этих логических границ есть в общей сложности четыре края с двумя краями, параллельными базовой линии под преобразованием глифа, и другие два края совместно используются со смежными глифами, если они присутствуют. Этот метод полезен для тестирования хита указанного глифа, расположения каре при продвижении или запаздывающем крае глифа, и для рисования области выделения вокруг указанного глифа.glyphIndex
- индексирование в это GlyphVector
это соответствует глифу, от которого можно получить его логические границыShape
это - логические границы глифа в указанном glyphIndex
.IndexOutOfBoundsException
- если glyphIndex
меньше чем 0 или больше чем или равный числу глифов в этом GlyphVector
getGlyphVisualBounds(int)
public abstract Shape getGlyphVisualBounds(int glyphIndex)
GlyphVector
. Границы, возвращенные этим методом, располагаются вокруг источника каждого отдельного глифа.glyphIndex
- индексирование в это GlyphVector
это соответствует глифу, от которого можно получить его визуальные границыShape
это - визуальные границы глифа в указанном glyphIndex
.IndexOutOfBoundsException
- если glyphIndex
меньше чем 0 или больше чем или равный числу глифов в этом GlyphVector
getGlyphLogicalBounds(int)
public Rectangle getGlyphPixelBounds(int index, FontRenderContext renderFRC, float x, float y)
GlyphVector
представляется в a Graphics
с данным FontRenderContext
в данном расположении. renderFRC не должен быть тем же самым как FontRenderContext
из этого GlyphVector
, и может быть нуль. Если это - нуль, FontRenderContext
из этого GlyphVector
используется. Реализация по умолчанию возвращает визуальные границы глифа, смещения к x, y и закругленный к следующему целочисленному значению, и игнорирует FRC. Подклассификаторы должны переопределить этот метод.index
- индексирование глифа.renderFRC
- FontRenderContext
из Graphics
.x
- X позиций, в которых можно представить это GlyphVector
.y
- позиция Y, в которой можно представить это GlyphVector
.Rectangle
ограничение пикселей, на которые влияли бы.public abstract GlyphMetrics getGlyphMetrics(int glyphIndex)
GlyphVector
.glyphIndex
- индексирование в это GlyphVector
это соответствует глифу, от которого можно получить его метрикиGlyphMetrics
объект, который представляет метрики глифа в указанном glyphIndex
в это GlyphVector
.IndexOutOfBoundsException
- если glyphIndex
меньше чем 0 или больше чем или равный числу глифов в этом GlyphVector
public abstract GlyphJustificationInfo getGlyphJustificationInfo(int glyphIndex)
GlyphVector
.glyphIndex
- индексирование в это GlyphVector
это соответствует глифу, от которого можно получить его свойства выравниванияGlyphJustificationInfo
объект, который представляет свойства выравнивания глифа в указанном glyphIndex
в это GlyphVector
.IndexOutOfBoundsException
- если glyphIndex
меньше чем 0 или больше чем или равный числу глифов в этом GlyphVector
public abstract boolean equals(GlyphVector set)
GlyphVector
точно равняется этому GlyphVector
.set
- указанное GlyphVector
протестироватьtrue
если указанное GlyphVector
равняется этому GlyphVector
; false
иначе.
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92