Package pi.resources.color

Class ColorSchemeContainer

java.lang.Object
pi.resources.color.ColorSchemeContainer
public class ColorSchemeContainer extends Object
Ein Speicher für Farbschemata.

Diese Klasse verwaltet eine Sammlung von Farbschemata und ermöglicht deren Verwaltung und Abruf anhand von Namen. Sie wird automatisch mit allen vordefinierten Farbschemata aus der Aufzählung PredefinedColorScheme initialisiert.

Die Klasse bietet folgende Funktionalität:

  • Speichern und Abrufen von Farbschemata anhand ihrer Namen.
  • Sichere Abfrage mit Fallback auf das GNOME-Standardschema.
  • Groß-/Kleinschreibung wird bei der Namensabfrage ignoriert.
Since:
0.42.0
See Also:

  • Method Details

    • getInstance

      public static ColorSchemeContainer getInstance()
      Gibt die Singleton/Einzelner-Instanz ColorSchemeContainer zurück.

      Wenn noch keine Instanz existiert, wird eine neue erstellt. Bei weiteren Aufrufen wird immer die gleiche Instanz zurückgegeben.

      Returns:
      Die Singleton/Einzelner-Instanz des ColorSchemeContainer.

    • add

      public void add(ColorScheme scheme)
      Fügt ein Farbschema zum Container hinzu.
      Parameters:
      scheme - Das hinzuzufügende Farbschema.
      Since:
      0.42.0

    • set

      public void set(ColorScheme scheme)
      Setzt das angegebene Farbschema als Standard und fügt es zum Farbschemaspeicher hinzu.
      Parameters:
      scheme - Das hinzuzufügende Farbschema.

    • get

      public ColorScheme get(String name)
      Ruft ein Farbschema anhand seines Namens ab.
      Parameters:
      name - Der Name des Farbschemas (Groß-/Kleinschreibung wird ignoriert)
      Returns:
      Das Farbschema mit dem angegebenen Namen.
      Throws:
      RuntimeException - Wenn kein Farbschema mit dem angegebenen Namen existiert
      Since:
      0.42.0

    • get

      public ColorScheme get()
      Gibt das aktuelle Farbschema aus der Konfiguration zurück.
      Returns:
      das Farbschema, das in der Grafikkonfiguration festgelegt ist
      Since:
      0.42.0

    • getSafe

      public ColorScheme getSafe(String name)
      Ruft ein Farbschema anhand seines Namens sicher ab.

      Bei der Suche wird die Groß-/Kleinschreibung ignoriert. Wenn das angeforderte Farbschema nicht existiert, wird das vordefinierte Gnome-Farbschema zurückgegeben.

      Parameters:
      name - der Name des Farbschemas (Groß-/Kleinschreibung wird ignoriert)
      Returns:
      das angeforderte Farbschema oder das GNOME-Standardschema, falls nicht vorhanden
      Since:
      0.42.0

    • clear

      public void clear()
      Löscht alle Farbschemata aus diesem Farbschemataspeicher.

      Nach dem Aufruf dieser Methode sind keine Farbschemata mehr vorhanden.

      Since:
      0.42.0

    • reset

      public void reset()
      Setzt den Farbschemataspeicher auf seinen Standardzustand zurück.

      Löscht alle vorhandenen Farbschemen und lädt alle vordefinierten Farbschemen erneut in den Farbschemataspeicher.

      Since:
      0.42.0

    • size

      public int size()
      Gibt die Anzahl der Farbschemas in diesem Container zurück.
      Returns:
      die Anzahl der gespeicherten Farbschemas
      Since:
      0.42.0

    • names

      @Getter public String[] names()
      Gibt ein Array mit den Namen aller Farbschemen in diesem Container zurück.

      Die Reihenfolge der Namen entspricht der Reihenfolge der Einträge in der zugrunde liegenden Map-Struktur.

      Returns:
      Ein String-Array mit den Namen aller gespeicherten Farbschemen. Das Array hat die gleiche Länge wie die Anzahl der Schemen.
      Since:
      0.42.0

    • next

      public ColorScheme next()
      Gibt das aktuelle Farbschema zurück und wechselt zum nächsten Schema.

      Die Farbschemen werden in der Einfügereihenfolge ausgegeben. Wenn das letzte Schema in der Sammlung erreicht ist, wird wieder zum ersten Schema gewechselt (zirkuläres Verhalten).

      Returns:
      das aktuelle ColorScheme vor dem Wechsel zum nächsten
      Since:
      0.42.0