Class TextPathLayout

java.lang.Object
org.apache.batik.ext.awt.font.TextPathLayout

public class TextPathLayout extends Object
PathLayout can layout text along a Shape, usually a Path object.

There are a number of improvements that could be made to this class. I'll try to list some of them:

  • The layout should really only modify the GlyphVector, rather than converting to a Shape.
  • Maybe the functions should take a AttributedCharacterIterator or something? Should this class do the entire layout?
  • The layout code works, but it's definitely not perfect.
Version:
$Id: TextPathLayout.java 1808001 2017-09-11 09:51:29Z ssteiner $
  • Field Details

    • ALIGN_START

      public static final int ALIGN_START
      Align the text at the start of the path.
      See Also:
    • ALIGN_MIDDLE

      public static final int ALIGN_MIDDLE
      Align the text at the middle of the path.
      See Also:
    • ALIGN_END

      public static final int ALIGN_END
      Align the text at the end of the path.
      See Also:
    • ADJUST_SPACING

      public static final int ADJUST_SPACING
      Use the spacing between the glyphs to adjust for textLength.
      See Also:
    • ADJUST_GLYPHS

      public static final int ADJUST_GLYPHS
      Use the entire glyph to adjust for textLength.
      See Also:
  • Constructor Details

    • TextPathLayout

      public TextPathLayout()
  • Method Details

    • layoutGlyphVector

      public static Shape layoutGlyphVector(GlyphVector glyphs, Shape path, int align, float startOffset, float textLength, int lengthAdjustMode)
      Wraps the GlyphVector around the given path. The results are mostly quite nice but you need to be careful choosing the size of the font that created the GlyphVector, as well as the "curvyness" of the path (really dynamic curves don't look so great, abrupt changes/vertices look worse).
      Parameters:
      glyphs - The GlyphVector to layout.
      path - The path (or shape) to wrap around
      align - The text alignment to use. Should be one of ALIGN_START, ALIGN_MIDDLE or ALIGN_END.
      startOffset - The offset from the start of the path for the initial text position.
      textLength - The length that the text should fill.
      lengthAdjustMode - The method used to expand or contract the text to meet the textLength.
      Returns:
      A shape that is the outline of the glyph vector wrapped along the path
    • layoutGlyphVector

      public static Shape layoutGlyphVector(GlyphVector glyphs, Shape path, int align)
      Wraps the GlyphVector around the given path.
      Parameters:
      glyphs - The GlyphVector to layout.
      path - The path (or shape) to wrap around
      align - The text alignment to use. Should be one of ALIGN_START, ALIGN_MIDDLE or ALIGN_END.
      Returns:
      A shape that is the outline of the glyph vector wrapped along the path
    • layoutGlyphVector

      public static Shape layoutGlyphVector(GlyphVector glyphs, Shape path)
      Wraps the GlyphVector around the given path.
      Parameters:
      glyphs - The GlyphVector to layout.
      path - The path (or shape) to wrap around
      Returns:
      A shape that is the outline of the glyph vector wrapped along the path