Package pi.actor

Class StopWatch

java.lang.Object
pi.actor.Actor
pi.actor.BoxActor<T>
pi.actor.TextActor<TextLineBox>
pi.actor.Text
pi.actor.StopWatch
All Implemented Interfaces:
FrameUpdateListener, FrameUpdateListenerRegistration, KeyStrokeListenerRegistration, MouseClickListenerRegistration, MouseScrollListenerRegistration
public class StopWatch extends Text implements FrameUpdateListener
Eine Stoppuhr, die die verstrichene Zeit anzeigt und verwaltet.

Die StopWatch erweitert die Text-Klasse und implementiert FrameUpdateListener, um die Anzeige bei jedem Einzelbild zu aktualisieren. Sie unterstützt das Starten, Stoppen, Pausieren und Zurücksetzen der Zeit. Außerdem kann das das Zeitformat im printf-Stil gesetzt werden.

Beispiel: 

 
 StopWatch watch = new StopWatch();
 watch.format("%02d:%02d:%02d.%03d"); // Setzt das Zeitformat
 watch.start(); // Zeitmessung beginnt
 watch.stop(); // Zeitmessung pausiert
 watch.reset(); // Zurücksetzen auf 0
Since:
0.45.0

  • Constructor Details

    • StopWatch

      public StopWatch()

  • Method Details

    • time

      @API @Getter public long time()
      Gibt das Zeitintervall in Millisekunden zurück.
      Returns:
      Das Zeitintervall in Millisekunden.
      Since:
      0.45.0

    • time

      @API @Setter @ChainableMethod public StopWatch time(long time)
      Setzt das Zeitintervall in Millisekunden.
      Parameters:
      time - Das Zeitintervall in Millisekunden.
      Returns:
      Eine Referenz auf die eigene Instanz der Stoppuhr, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Stoppuhr durch aneinander gekettete Setter festgelegt werden können, z.B. watch.format(..).time(..).start().
      Since:
      0.45.0

    • format

      @API @Getter public String format()
      Gibt das Zeitformat im printf-Stil zurück.
      Returns:
      Das Zeitformat im printf-Stil, beispielsweise %02d:%02d:%02d.%03d.
      Since:
      0.45.0

    • format

      @API @Setter @ChainableMethod public StopWatch format(String format)
      Setzt das Zeitformat im printf-Stil für die Stoppuhr.
      Parameters:
      format - Das Zeitformat im printf-Stil, beispielsweise %02d:%02d:%02d.%03d.
      Returns:
      Eine Referenz auf die eigene Instanz der Stoppuhr, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Stoppuhr durch aneinander gekettete Setter festgelegt werden können, z.B. watch.format(..).time(..).start().
      Since:
      0.45.0

    • isRunning

      @API @Getter public boolean isRunning()
      Prüft, ob die Stoppuhr gerade läuft.
      Returns:
      true, wenn die Stoppuhr läuft, false sonst
      Since:
      0.45.0

    • start

      @API @ChainableMethod public StopWatch start()
      Startet die Stoppuhr, falls sie nicht bereits läuft. Wenn die Stoppuhr nicht aktiv ist, wird die Startzeit gesetzt und die Stoppuhr in den laufenden Zustand versetzt. Bei erneuter Aktivierung nach einer Pause wird die pausierte Zeit berücksichtigt.
      Returns:
      Eine Referenz auf die eigene Instanz der Stoppuhr, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Stoppuhr durch aneinander gekettete Setter festgelegt werden können, z.B. watch.format(..).time(..).start().
      Since:
      0.45.0

    • stop

      @API @ChainableMethod public StopWatch stop()
      Stoppt die Stoppuhr, falls sie läuft. Wenn die Stoppuhr aktiv ist, wird die verstrichene Zeit berechnet und gespeichert. Der Laufstatus wird auf inaktiv gesetzt.
      Returns:
      Eine Referenz auf die eigene Instanz der Stoppuhr, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Stoppuhr durch aneinander gekettete Setter festgelegt werden können, z.B. watch.format(..).time(..).start().
      Since:
      0.45.0

    • toggle

      @API @ChainableMethod public StopWatch toggle()
      Schaltet die Stoppuhr um zwischen Laufen und Stoppen. Wenn die Stoppuhr läuft, wird sie gestoppt. Wenn die Stoppuhr gestoppt ist, wird sie gestartet.
      Returns:
      Eine Referenz auf die eigene Instanz der Stoppuhr, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Stoppuhr durch aneinander gekettete Setter festgelegt werden können, z.B. watch.format(..).time(..).start().
      Since:
      0.45.0

    • reset

      @API @ChainableMethod public StopWatch reset()
      Setzt die Stoppuhr auf ihren Initialwert zurück.

      Diese Methode setzt alle internen Zustände der Stoppuhr zurück:

      • Startzeit wird auf 0 gesetzt
      • Pausierte Zeit wird auf 0 gesetzt
      • Laufstatus wird auf inaktiv gesetzt
      • Millisekunden werden auf null zurückgesetzt
      Returns:
      Eine Referenz auf die eigene Instanz der Stoppuhr, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Stoppuhr durch aneinander gekettete Setter festgelegt werden können, z.B. watch.format(..).time(..).start().
      Since:
      0.45.0