Package pi.resources.font

Class FontContainer

java.lang.Object
pi.resources.ResourcesContainer<Font>
pi.resources.font.FontContainer
All Implemented Interfaces:
Container<Font>
public final class FontContainer extends ResourcesContainer<Font>
Ein Speicher für Schriftarten des Datentyps Font.
Author:
Steffen Wilke, Matthias Wilke, Josef Friedrich

  • Field Details

    • systemFonts

      public static final String[] systemFonts
      Alle möglichen Schriftnamen des Systems, auf dem man sich gerade befindet.

      Hiernach werden Überprüfungen gemacht, ob die gewünschte Schriftart auf dem System vorhanden ist.

  • Constructor Details

    • FontContainer

      public FontContainer()

  • Method Details

    • isSystemFont

      @API public static boolean isSystemFont(String fontName)
      Prüft, ob eine Schriftart auf diesem System vorhanden ist.
      Parameters:
      fontName - Der Name der zu überprüfenden Schriftart.
      Returns:
      true, falls die Schriftart auf dem System existiert, sonst false.

    • getSystemFonts

      @API public static String[] getSystemFonts()
      Gibt eine Namesliste der Systemschriftarten zurück.
      Returns:
      Liste mit Systemschriftarten.

    • loadSystemFontByName

      public static Font loadSystemFontByName(String fontName)
      Lädt eine Systemschriftart basierend auf dem Namen.
      Parameters:
      fontName - Der Name der Systemschriftart.
      Returns:
      Die Systemschriftart.

    • get

      public Font get(String name)
      Gibt eine Schriftart zurück, die durch einen Namen oder Dateipfad ermittelt wird.
      Specified by:
      get in interface Container<Font>
      Overrides:
      get in class ResourcesContainer<Font>
      Parameters:
      name - Der Name einer Systemschriftart (z. B. "Arial") oder der Dateipfad zu einer Schriftdatei (z. B. "fonts/Cantarell-Regular.ttf").
      Returns:
      Die Schriftart.

    • get

      public Font get(String name, int style)
      Gibt eine Schriftart zurück, die durch einen Namen oder Dateipfad ermittelt wird, und mit den gewünschten Stilattribut versehen ist.
      Parameters:
      name - Der Name einer Systemschriftart (z. B. "Arial") oder der Dateipfad zu einer Schriftdatei (z. B. "fonts/Cantarell-Regular.ttf").
      style - Der Stil der Schriftart (fett, kursiv, oder fett und kursiv).
      • 0: Normaler Text
      • 1: Fett
      • 2: Kursiv
      • 3: Fett und Kursiv
      Returns:
      Die Schriftart, die die angegebenen Stileinstellungen besitzt.

    • get

      public Font get(String name, double size)
      Gibt eine Schriftart zurück, die durch einen Namen oder Dateipfad ermittelt wird, und mit den gewünschten Größenattribut versehen ist.
      Parameters:
      name - Der Name einer Systemschriftart (z. B. "Arial") oder der Dateipfad zu einer Schriftdatei (z. B. "fonts/Cantarell-Regular.ttf").
      size - Die Schriftgröße in Punkten (pt, Points), z. B. 12.0 für 12pt.
      Returns:
      Die Schriftart, die die angegebenen Größeneinstellungen besitzt.

    • get

      public Font get(String name, int style, double size)
      Gibt eine Schriftart zurück, die durch einen Namen oder Dateipfad ermittelt wird, und mit den gewünschten Stil- und Größenattributen versehen ist.
      Parameters:
      name - Der Name einer Systemschriftart (z. B. "Arial") oder der Dateipfad zu einer Schriftdatei (z. B. "fonts/Cantarell-Regular.ttf").
      style - Der Stil der Schriftart (fett, kursiv, oder fett und kursiv).
      • 0: Normaler Text
      • 1: Fett
      • 2: Kursiv
      • 3: Fett und Kursiv
      size - Die Schriftgröße in Punkten (pt, Points), z. B. 12.0 für 12pt.
      Returns:
      Die Schriftart, die die angegebenen Stil- und Größeneinstellungen besitzt.

    • defaultFont

      @Getter public Font defaultFont(FontStyle style)
      Gibt die mit der Engine Pi mitgelieferte Standardschrift aus. Dabei muss der Schriftstil als Aufzählungstyp angegeben werden.
      Parameters:
      style - Der Schriftstil als Aufzählungstyp.
      Returns:
      Die mitgelieferte Standardschrift.
      Since:
      0.37.0

    • defaultFont

      @Getter public Font defaultFont(int style)
      Gibt die mit der Engine Pi mitgelieferte Standardschrift aus. Dabei muss der Schriftstil als Ganzzahl angegeben werden.
      Parameters:
      style - Der Schriftstil als Ganzzahl.
      Returns:
      Die mitgelieferte Standardschrift.
      Since:
      0.39.0

    • defaultFont

      @Getter public Font defaultFont()
      Gibt die mit der Engine Pi mitgelieferte Standardschrift im normalen Schriftstil aus.
      Returns:
      Die mitgelieferte Standardschrift.
      Since:
      0.37.0

    • load

      protected Font load(URL resourceName)
      Lädt eine TrueType-Schriftart aus der angegebenen URL und gibt das resultierende Font-Objekt zurück. Es wird versucht, über ResourceLoader.get(URL) einen InputStream zur Ressource zu öffnen. Aus diesem Stream wird mittels Font.createFont(Font.TRUETYPE_FONT, InputStream) ein Font-Objekt erzeugt. Falls die Schriftart nicht gefunden wird oder beim Lesen/Parsen der Schriftart eine Ausnahme auftritt, wird eine RuntimeException mit einer entsprechenden Fehlermeldung geworfen.
      Specified by:
      load in class ResourcesContainer<Font>
      Parameters:
      resourceName - URL der Schriftressource
      Returns:
      Die geladene Schriftart.
      Throws:
      RuntimeException - wenn die Ressource nicht geladen werden kann oder beim Erstellen der Schrift ein Fehler auftritt