src/java.desktop/share/classes/java/awt/font/GlyphVector.java

Print this page




  45  * containing geometric information for the placement of each glyph
  46  * in a transformed coordinate space which corresponds to the
  47  * device on which the <code>GlyphVector</code> is ultimately
  48  * displayed.
  49  * <p>
  50  * The <code>GlyphVector</code> does not attempt any interpretation of
  51  * the sequence of glyphs it contains.  Relationships between adjacent
  52  * glyphs in sequence are solely used to determine the placement of
  53  * the glyphs in the visual coordinate space.
  54  * <p>
  55  * Instances of <code>GlyphVector</code> are created by a {@link Font}.
  56  * <p>
  57  * In a text processing application that can cache intermediate
  58  * representations of text, creation and subsequent caching of a
  59  * <code>GlyphVector</code> for use during rendering is the fastest
  60  * method to present the visual representation of characters to a user.
  61  * <p>
  62  * A <code>GlyphVector</code> is associated with exactly one
  63  * <code>Font</code>, and can provide data useful only in relation to
  64  * this <code>Font</code>.  In addition, metrics obtained from a
  65  * <code>GlyphVector</code> are not generally geometrically scaleable
  66  * since the pixelization and spacing are dependent on grid-fitting
  67  * algorithms within a <code>Font</code>.  To facilitate accurate
  68  * measurement of a <code>GlyphVector</code> and its component
  69  * glyphs, you must specify a scaling transform, anti-alias mode, and
  70  * fractional metrics mode when creating the <code>GlyphVector</code>.
  71  * These characteristics can be derived from the destination device.
  72  * <p>
  73  * For each glyph in the <code>GlyphVector</code>, you can obtain:
  74  * <ul>
  75  * <li>the position of the glyph
  76  * <li>the transform associated with the glyph
  77  * <li>the metrics of the glyph in the context of the
  78  *   <code>GlyphVector</code>.  The metrics of the glyph may be
  79  *   different under different transforms, application specified
  80  *   rendering hints, and the specific instance of the glyph within
  81  *   the <code>GlyphVector</code>.
  82  * </ul>
  83  * <p>
  84  * Altering the data used to create the <code>GlyphVector</code> does not
  85  * alter the state of the <code>GlyphVector</code>.




  45  * containing geometric information for the placement of each glyph
  46  * in a transformed coordinate space which corresponds to the
  47  * device on which the <code>GlyphVector</code> is ultimately
  48  * displayed.
  49  * <p>
  50  * The <code>GlyphVector</code> does not attempt any interpretation of
  51  * the sequence of glyphs it contains.  Relationships between adjacent
  52  * glyphs in sequence are solely used to determine the placement of
  53  * the glyphs in the visual coordinate space.
  54  * <p>
  55  * Instances of <code>GlyphVector</code> are created by a {@link Font}.
  56  * <p>
  57  * In a text processing application that can cache intermediate
  58  * representations of text, creation and subsequent caching of a
  59  * <code>GlyphVector</code> for use during rendering is the fastest
  60  * method to present the visual representation of characters to a user.
  61  * <p>
  62  * A <code>GlyphVector</code> is associated with exactly one
  63  * <code>Font</code>, and can provide data useful only in relation to
  64  * this <code>Font</code>.  In addition, metrics obtained from a
  65  * <code>GlyphVector</code> are not generally geometrically scalable
  66  * since the pixelization and spacing are dependent on grid-fitting
  67  * algorithms within a <code>Font</code>.  To facilitate accurate
  68  * measurement of a <code>GlyphVector</code> and its component
  69  * glyphs, you must specify a scaling transform, anti-alias mode, and
  70  * fractional metrics mode when creating the <code>GlyphVector</code>.
  71  * These characteristics can be derived from the destination device.
  72  * <p>
  73  * For each glyph in the <code>GlyphVector</code>, you can obtain:
  74  * <ul>
  75  * <li>the position of the glyph
  76  * <li>the transform associated with the glyph
  77  * <li>the metrics of the glyph in the context of the
  78  *   <code>GlyphVector</code>.  The metrics of the glyph may be
  79  *   different under different transforms, application specified
  80  *   rendering hints, and the specific instance of the glyph within
  81  *   the <code>GlyphVector</code>.
  82  * </ul>
  83  * <p>
  84  * Altering the data used to create the <code>GlyphVector</code> does not
  85  * alter the state of the <code>GlyphVector</code>.