Package pi.actor

Class ImageFont

java.lang.Object
pi.actor.ImageFont
public class ImageFont extends Object
Eine Schriftart, bei der die einzelnen Buchstaben durch ein Bild repräsentiert sind.

Jedes Bild entspricht einem Buchstaben oder Zeichen. Die Bilder müssen alle die gleiche Abmessung aufweisen.

Eine Alternative wäre die BitmapFont-Klasse der Game-Engine libgdx. ...

Since:
0.23.0
Author:
Josef Friedrich
See Also:

  • Constructor Details

    • ImageFont

      public ImageFont(String basePath, String extension, ImageFontCaseSensitivity caseSensitivity, TextAlignment alignment)
      Erzeugt eine neue Bilderschriftart.
      Parameters:
      basePath - Der Pfad zu einem Ordner, in dem die Bilder der einzelnen Buchstaben liegen.
      extension - Die Dateierweiterung der Buchstabenbilder.
      caseSensitivity - Die Handhabung der Groß- und Kleinschreibung.
      alignment - Die Textausrichtung.

    • ImageFont

      public ImageFont(String basePath, ImageFontCaseSensitivity caseSensitivity)
      Erzeugt eine neue Bilderschriftart. Die einzelnen Glyphen müssen als Dateierweiterung png haben. Der Text wird linksbündig ausgerichtet.
      Parameters:
      basePath - Der Pfad zu einem Ordner, in dem die Bilder der einzelnen Buchstaben liegen.
      caseSensitivity - Die Handhabung der Groß- und Kleinschreibung.

    • ImageFont

      public ImageFont(String basePath)
      Erzeugt eine neue Bilderschriftart. Die einzelnen Glyphen müssen als Dateierweiterung png haben. Der Text wird linksbündig ausgerichtet.
      Parameters:
      basePath - Der Pfad zu einem Ordner, in dem die Bilder der einzelnen Buchstaben liegen.

  • Method Details

    • basePath

      @Setter public ImageFont basePath(String basePath)
      Setzt den Pfad zu einem Ordner, in dem die Bilder der einzelnen Buchstaben liegen.
      Parameters:
      basePath - Der Pfad zu einem Ordner, in dem die Bilder der einzelnen Buchstaben liegen.
      Returns:
      Eine Instanz dieser Klasse, damit mehrere Setter mit der Punktschreibweise verkettet werden können.

    • glyphWidth

      @Getter public int glyphWidth()
      Gibt die Breite der Buchstabenbilder in Pixel zurück.
      Returns:
      Die Breite der Buchstabenbilder in Pixel.

    • color

      @Setter public ImageFont color(Color color)
      Setzt die Farbe, in der die schwarze Farbe der Ausgangsbilder umgefärbt werden soll.
      Parameters:
      color - Die Farbe, in der die schwarze Farbe der Ausgangsbilder umgefärbt werden soll.
      Returns:
      Eine Instanz dieser Klasse, damit mehrere Setter mit der Punktschreibweise verkettet werden können.

    • color

      @Getter public Color color()
      Gibt die Farbe zurück, in der die schwarze Farbe der Ausgangsbilder umgefärbt werden soll.
      Returns:
      Die Farbe, in der die schwarze Farbe der Ausgangsbilder umgefärbt werden soll.

    • extension

      @Setter public ImageFont extension(String extension)
      Setzt die Dateierweiterung der Buchstabenbilder.
      Parameters:
      extension - Die Dateierweiterung der Buchstabenbilder.
      Returns:
      Eine Instanz dieser Klasse, damit mehrere Setter mit der Punktschreibweise verkettet werden können.

    • pixelMultiplication

      @Setter public ImageFont pixelMultiplication(int pixelMultiplication)
      Setzt, wie oft ein Pixel vervielfältigt werden soll.
      Parameters:
      pixelMultiplication - Wie oft ein Pixel vervielfältigt werden soll. Beispielsweise verwandelt die Zahl 3 ein Pixel in 9 Pixel der Abmessung 3x3.
      Returns:
      Eine Instanz dieser Klasse, damit mehrere Setter mit der Punktschreibweise verkettet werden können.

    • pixelMultiplication

      @Getter public int pixelMultiplication()
      Gibt zurück, wie oft ein Pixel vervielfältigt werden soll. i
      Returns:
      Wie oft ein Pixel vervielfältigt werden soll. Beispielsweise verwandelt die Zahl 3 ein Pixel in 9 Pixel der Abmessung 3x3.

    • caseSensitivity

      @Setter public ImageFont caseSensitivity(ImageFontCaseSensitivity caseSensitivity)
      Setzt die Handhabung der Groß- und Kleinschreibung.
      Parameters:
      caseSensitivity - Die Handhabung der Groß- und Kleinschreibung.
      Returns:
      Eine Instanz dieser Klasse, damit mehrere Setter mit der Punktschreibweise verkettet werden können.

    • lineWidth

      @Setter public ImageFont lineWidth(int lineWidth)
      Setzt die maximale Anzahl an Zeichen, die eine Zeile aufnehmen kann.
      Parameters:
      lineWidth - Die maximale Anzahl an Zeichen, die eine Zeile aufnehmen kann.
      Returns:
      Eine Instanz dieser Klasse, damit mehrere Setter mit der Punktschreibweise verkettet werden können.

    • lineWidth

      @Getter public int lineWidth()
      Gibt die maximale Anzahl an Zeichen zurück, die eine Zeile aufnehmen kann.
      Returns:
      Die maximale Anzahl an Zeichen, die eine Zeile aufnehmen kann.

    • lineWidth

      @Getter public int lineWidth(String content)
      Gibt die maximale Anzahl an Zeichen zurück, die eine Zeile aufnehmen kann.
      Returns:
      Die maximale Anzahl an Zeichen, die eine Zeile aufnehmen kann.

    • lineWidth

      @Getter public int lineWidth(String content, int lineWidth)
      Gibt die maximale Anzahl an Zeichen zurück, die eine Zeile aufnehmen kann.
      Returns:
      Die maximale Anzahl an Zeichen, die eine Zeile aufnehmen kann.

    • alignment

      @Setter public ImageFont alignment(TextAlignment alignment)
      Setzt die Textausrichtung.
      Parameters:
      alignment - Die Textausrichtung.
      Returns:
      Eine Instanz dieser Klasse, damit mehrere Setter mit der Punktschreibweise verkettet werden können.

    • alignment

      @Getter public TextAlignment alignment()
      Gibt die Textausrichtung zurück.
      Returns:
      Die Textausrichtung.

    • throwException

      @Setter public ImageFont throwException(boolean throwException)
      Setzt, ob bei einem nicht vorhandenen Zeichen eine Fehlermeldung geworfen werden soll oder nicht.
      Parameters:
      throwException - Ob bei einem nicht vorhandenen Zeichen eine Fehlermeldung geworfen werden soll oder nicht.
      Returns:
      Eine Instanz dieser Klasse, damit mehrere Setter mit der Punktschreibweise verkettet werden können.

    • glyphs

      @Getter public ImageFontGlyph[] glyphs()

    • addMapping

      public ImageFont addMapping(char glyph, String filename)
      Ordnet einem Zeichen einem Bilder-Dateinamen zu. Nicht alle Zeichen wie zum Beispiel der Schrägstrich oder der Doppelpunkt können als Dateinamen verwendet werden.
      Parameters:
      glyph - Das Zeichen, das durch ein Bild dargestellt werden soll.
      filename - Der Dateiname des Bilds ohne Dateierweiterung, das ein Zeichen darstellt, relativ zu basePath.
      Returns:
      Eine Instanz dieser Klasse, damit mehrere Setter mit der Punktschreibweise verkettet werden können.

    • render

      public BufferedImage render(String content, int lineWidth, TextAlignment alignment, Color color, int pixelMultiplication)
      Setzt den gegebenen Textinhalt in ein Bild.
      Parameters:
      content - Der Textinhalt, der in das Bild geschrieben werden soll.
      lineWidth - Die maximale Anzahl an Zeichen, die eine Zeile aufnehmen kann.
      alignment - Die Textausrichtung.
      color - Die Farbe, in der die schwarze Farbe der Ausgangsbilder umgefärbt werden soll.
      pixelMultiplication - Wie oft ein Pixel vervielfältigt werden soll. Beispielsweise verwandelt die Zahl 3 ein Pixel in 9 Pixel der Abmessung 3x3.
      Returns:
      Ein Bild, in dem alle Zeichen-Einzelbilder zusammengefügt wurden.

    • render

      public BufferedImage render(String content)
      Setzt den gegebenen Textinhalt in ein Bild.
      Parameters:
      content - Der Textinhalt, der in das Bild geschrieben werden soll.
      Returns:
      Ein Bild, in dem alle Zeichen-Einzelbilder zusammengefügt wurden.