Package pi.actor

Class Actor

java.lang.Object
pi.actor.Actor
All Implemented Interfaces:
FrameUpdateListenerRegistration, KeyStrokeListenerRegistration, MouseClickListenerRegistration, MouseScrollListenerRegistration
Direct Known Subclasses:
Animation, Geometry, Grid, Grid, Image, Line, StatefulAnimation, TileRegistration
public abstract class Actor extends Object implements KeyStrokeListenerRegistration, MouseClickListenerRegistration, MouseScrollListenerRegistration, FrameUpdateListenerRegistration
Jede Figur auf der Zeichenebene ist ein Actor.

Dies ist die absolute Superklasse aller grafischen Objekte. Umgekehrt kann somit jedes grafische Objekt die folgenden Methoden nutzen.

Author:
Michael Andonie, Niklas Keller

  • Field Details

    • color

      protected Color color
      Die Farbe der Figur.

    • physics

      public pi.physics.PhysicsHandler physics
      Der JB2D-Handler für dieses spezifische Objekt.

  • Constructor Details

    • Actor

      public Actor(Supplier<FixtureData> defaultFixtureSupplier)
      Erstellt ein neue Figur.
      Parameters:
      defaultFixtureSupplier - Eine Supplier-Funktion, der den Umriss für diese Figur generiert. Dieser Umriss ist in der Regel ein optimal gelegtes Rechteck parallel zu den Axen bei einem Rotationswinkel von 0 Grad.

  • Method Details

    • addMountListener

      @API public final Actor addMountListener(Runnable listener)
      Fügt einen Beobachter hinzu, der ausgeführt wird, sobald das Objekt angemeldet wurde.
      Parameters:
      listener - Beobachter-Implementierung
      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).

    • removeMountListener

      @API public final Actor removeMountListener(Runnable listener)
      Entfernt einen Beobachter, der ausgeführt wird, sobald das Objekt angemeldet wurde.
      Parameters:
      listener - Beobachter-Implementierung
      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).

    • addUnmountListener

      @API public final Actor addUnmountListener(Runnable listener)
      Fügt einen Beobachter hinzu, der ausgeführt wird, sobald das Objekt abgemeldet wurde.
      Parameters:
      listener - Beobachter-Implementierung
      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).

    • removeUnmountListener

      @API public final Actor removeUnmountListener(Runnable listener)
      Entfernt einen Beobachter, der ausgeführt wird, sobald das Objekt abgemeldet wurde.
      Parameters:
      listener - Beobachter-Implementierung
      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).

    • layerPosition

      @API @Setter public final Actor layerPosition(int position)
      Setzt die Ebenenposition dieses Objekts. Je größer, desto weiter vorne wird das Objekt gezeichnet.
      Parameters:
      position - Der Ebenen-Index.
      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).
      See Also:

    • layerPosition

      @API @Getter public final int layerPosition()
      Gibt die Ebenenposition zurück. Je größer, desto weiter vorne wird das Objekt gezeichnet.
      Returns:
      Der Ebenen-Index.
      See Also:

    • visible

      @API @Setter public final Actor visible(boolean visible)
      Setzt die Sichtbarkeit des Objektes.
      Parameters:
      visible - Ob das Objekt sichtbar sein soll oder nicht.
      Ist dieser Wert false, so wird es nicht gezeichnet.
      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).
      See Also:

    • toggleVisible

      @API public final Actor toggleVisible()
      Wechselt zwischen den Zuständen sichtbar und nicht sichtbar hin und her.
      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).
      Since:
      0.27.0
      See Also:

    • isVisible

      @API public final boolean isVisible()
      Gibt an, ob das Objekt sichtbar ist.
      Returns:
      Ist true, wenn das Objekt zurzeit sichtbar ist.
      See Also:

    • show

      @API public final Actor show()
      Zeigt die Figur auf der Ebene bzw. blendet die Figur ein.
      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).
      Since:
      0.35.0
      See Also:

    • hide

      @API public final Actor hide()
      Versteckt die Figur auf der Ebene bzw. blendet die Figur aus.
      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).
      Since:
      0.35.0
      See Also:

    • opacity

      @API @Getter public final double opacity()
      Gibt die aktuelle Durchsichtigkeit des Actor-Objekts zurück.
      Returns:
      Gibt die aktuelle Durchsichtigkeit des Actor-Objekts zurück.

    • opacity

      @API @Setter public final Actor opacity(double opacity)
      Setzt die Durchsichtigkeit des Objekts.
      Parameters:
      opacity -
      • 0.0 entspricht einem komplett durchsichtigen (transparenten) Objekt.
      • 1.0 entspricht einem undurchsichtigen Objekt.
      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).

    • color

      @API @Getter public Color color()
      Gibt die Farbe der Figur zurück.
      Returns:
      Die Farbe der Figur.

    • complementaryColor

      @API @Getter public Color complementaryColor()
      Gibt die Komplementärfarbe der Figur zurück.
      Returns:
      Die Komplementärfarbe der Figur.

    • color

      @API @Setter public Actor color(Color color)
      Setzt die Farbe der Figur auf eine bestimmte Farbe.
      Parameters:
      color - Die neue Farbe.
      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).

    • color

      @API @Setter public Actor color(String color)
      Setzt die Farbe der Figur auf eine bestimmte Farbe, die als Zeichenkette angegeben werden kann.
      Parameters:
      color - Ein Farbname, ein Farbalias (siehe Auflistung) oder eine Farbe in hexadezimaler Codierung (z. B. #ff0000).
      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).
      See Also:

    • contains

      @API public final boolean contains(Vector point)
      Prüft, ob ein bestimmter Punkt innerhalb des Objekts liegt.
      Parameters:
      point - Der Punkt, der auf Inhalt im Objekt getestet werden soll.
      Returns:
      true, wenn der Punkt innerhalb des Objekts liegt.

    • overlaps

      @API public final boolean overlaps(Actor other)
      Prüft, ob dieses Objekt sich mit einem weiteren Objekt schneidet.

      Für die Überprüfung des Überlappens werden die internen Collider genutzt. Je nach Genauigkeit der Collider kann die Überprüfung unterschiedlich befriedigend ausfallen. Die Collider können im Debug-Modus der Engine eingesehen werden.

      Parameters:
      other - Ein weiteres Actor-Objekt.
      Returns:
      true, wenn dieses Actor-Objekt sich mit other schneidet. Sonst false.
      See Also:

    • collisions

      @API @Getter public final List<CollisionEvent<Actor>> collisions()
      Gibt eine Liste bestehend aus Kollisionsereignissen zurück.
      Returns:
      Eine Liste aus Kollisionsereignissen.

    • bodyType

      @API @Setter public final Actor bodyType(BodyType type)
      Setzt das allgemeine Verhalten, dass dieses Objekt im Rahmen der Physics-Engine (und Kollisionserkennungen) haben soll. Eine Erläuterung der verschiedenen Verhaltenstypen finden sich in der Dokumentation von BodyType.
      Parameters:
      type - Der neue BodyType für den Actor.
      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).
      See Also:

    • makeStatic

      @API public final Actor makeStatic()
      Verwandelt den Actor in ein statisches Objekt.

      Statische Objekte haben keine Geschwindigkeit. Sie bewegen sich nicht in der Simulation, Kräfte haben keinen Einfluss auf sie. Diese Eigenschaft gehört zum Beispiel zu Wänden, Böden und Decken.

      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).
      See Also:

    • makeDynamic

      @API public final Actor makeDynamic()
      Verwandelt den Actor in ein dynamisches Objekt.

      Dynamische Objekte verhalten sich wie Objekte der Newton’schen Mechanik. Sie können Kräfte auf sich wirken lassen und interagieren miteinander. Diese Eigenschaft gehört zum Beispiel zu Billiardkugeln, Spielfiguren und Wurfgeschossen.

      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).
      See Also:

    • makeKinematic

      @API public final Actor makeKinematic()
      Verwandelt den Actor in ein kinematisches Objekt.

      Kinematische Objekte können eine Geschwindigkeit haben, aber reagieren nicht auf Kräfte. Sie kollidieren (im Sinne der Physics) nur mit dynamischen Objekten. Diese Eigenschaft gehört zum Beispiel zu beweglichen Plattformen.

      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).
      See Also:

    • makeSensor

      @API public final Actor makeSensor()
      Verwandelt den Actor in einen Sensor.

      Sensoren nehmen nicht an der Physiksimulation teil. Sie werden von der Physics so behandelt, als wären sie nicht da. Sie generieren trotzdem Kollisionsereignisse. Dies ist die Standardeinstellung für Actors, wenn sie erstellt werden.

      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..)
      See Also:

    • makeParticle

      @API public final Actor makeParticle()
      Verwandelt den Actor in ein Partikel.

      Partikel nehmen wie Sensoren nicht an der Physiksimulation teil, sie generieren trotzdem Kollisionsereignisse. Dieser Typ ist hilfreich, wenn du viele Actors generieren willst, diese aber rein optisch auf das Spiel wirken sollen, wie zum Beispiel Dreck, den ein Auto beim Anfahren aufwühlt oder Funken, die von einer Wand nach einem Schuss sprühen.

      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).
      See Also:

    • bodyType

      @API @Getter public final BodyType bodyType()
      Gibt aus, was für ein Physics-Typ dieses Objekt momentan ist.
      Returns:
      Der Physics-Typ, der das entsprechende Actor-Objekt momentan ist.
      See Also:

    • fixtures

      @API @Setter public final Actor fixtures(String code)
      Setzt die Halterung (Fixture) für dieses Objekt neu. Dies hat Einfluss auf die Physik (Kollisionen, Masse, etc.).
      Parameters:
      code - Eine Minisprache, die die Halterung definiert. Alle Werte sind in der Einheit Meter anzugeben. Die Koordinatenangaben beziehen sich dabei auf den Ankerpunkt der Figur links unten.
      • Die Formen werden getrennt durch "&"
      • Rechteck: R0.5,0.5,4,5 Rechteck mit Startpunkt (0.5|0.5), Breite 4 Meter, Höhe 5 Meter
      • Polygon: P4,4,5,5,1,2 Polygon mit drei Punkten: (4|4), (5|5), (1|2)
      • Kreis: C1,1,4 Kreis mit Mittelpunkt (1|1) und Radius 4
      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).
      See Also:

    • fixture

      @API @Setter public final Actor fixture(Supplier<FixtureData> fixtureSupplier)
      Setzt die Halterung (Fixture) der Figur neu in eine einzige alternative Halterung.
      Parameters:
      fixtureSupplier - Der Supplier, der die neue Shape des Objektes ausgibt.
      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).
      See Also:

    • fixtures

      @API @Setter public final Actor fixtures(Supplier<List<FixtureData>> fixturesSupplier)
      Ändert die Halterung (Fixture) dieses Objekts durch Angabe einer Liste.
      Parameters:
      fixturesSupplier - Ein Supplier, der eine Liste mit allen neuen Shapes für den Actor angibt.
      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).
      See Also:

    • addCollisionListener

      @API public final <E extends Actor> Actor addCollisionListener(E collider, CollisionListener<E> listener)
      Meldet einen neuen CollisionListener an, der auf alle Kollisionen zwischen diesem Actor und dem Actor collider reagiert.
      Type Parameters:
      E - Typ-Parameter. Sollte im Regelfall exakt die Klasse von collider sein. Dies ermöglicht die Nutzung von spezifischen Methoden aus spezialisierteren Klassen der Actor-Hierarchie.
      Parameters:
      listener - Der Listener, der bei Kollisionen zwischen dem ausführenden Actor und collider informiert werden soll.
      collider - Ein weiteres Actor-Objekt.
      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).
      See Also:

    • addCollisionListener

      @API public final <E extends Actor> Actor addCollisionListener(Class<E> clazz, CollisionListener<E> listener)
      Meldet einen neuen CollisionListener an, der auf alle Kollisionen reagiert, die dieser Actor mit seiner Umwelt erlebt.
      Type Parameters:
      E - Typ des anderen Objekts bei Kollisionen.
      Parameters:
      clazz - Typ des anderen Objekts bei Kollisionen.
      listener - Der Beobachter, der bei Kollisionen informiert werden soll, die der ausführende Actor mit allen anderen Objekten der Szene erlebt.
      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).
      See Also:

    • addCollisionListener

      @API public final Actor addCollisionListener(CollisionListener<Actor> listener)
      Meldet einen neuen CollisionListener an, der auf alle Kollisionen reagiert, die dieser Actor mit seiner Umwelt erlebt.
      Parameters:
      listener - Der Listener, der bei Kollisionen informiert werden soll, die der ausführende Actor mit allen anderen Objekten der Szene erlebt.
      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).
      See Also:

    • layer

      @Getter public final Layer layer()
      Gibt die Ebene zurück, an der das aktuelle Objekt angemeldet ist, sonst null.
      Returns:
      Die Ebene, an der das aktuelle Objekt angemeldet ist, sonst null.

    • remove

      public final Actor remove()
      Entfernt das aktuelle Objekt aus seiner aktuellen Ebene, falls das Objekt gerade einer Ebene zugeordnet ist.
      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).

    • listenerBundle

      @API @Getter public final EventListenerBundle listenerBundle()
      Returns:
      Liste der MouseClickListener.

    • keyStrokeListeners

      @API public final EventListeners<KeyStrokeListener> keyStrokeListeners()
      Specified by:
      keyStrokeListeners in interface KeyStrokeListenerRegistration
      Returns:
      Liste der KeyStrokeListener.

    • mouseClickListeners

      @API public final EventListeners<MouseClickListener> mouseClickListeners()
      Specified by:
      mouseClickListeners in interface MouseClickListenerRegistration
      Returns:
      Liste der MouseClickListener.

    • mouseScrollListeners

      @API public final EventListeners<MouseScrollListener> mouseScrollListeners()
      Specified by:
      mouseScrollListeners in interface MouseScrollListenerRegistration
      Returns:
      Liste der MouseScrollListener.

    • frameUpdateListeners

      @API public final EventListeners<FrameUpdateListener> frameUpdateListeners()
      Specified by:
      frameUpdateListeners in interface FrameUpdateListenerRegistration
      Returns:
      Liste der FrameUpdateListener.

    • rotationLocked

      @API @Setter public final Actor rotationLocked(boolean rotationLocked)
      Setzt, ob im Rahmen der physikalischen Simulation die Rotation dieses Objekts blockiert werden soll.

      Das Objekt kann in jedem Fall weiterhin über einen direkten Methodenaufruf rotiert werden. Der folgende Code ist immer wirksam, unabhängig davon, ob die Rotation im Rahmen der physikalischen Simulation blockiert ist:

      actor.getPosition.rotate(4.31);

      Parameters:
      rotationLocked - Ist dieser Wert true, rotiert sich dieses Objekts innerhalb der physikalischen Simulation nicht mehr. Ist dieser Wert false, rotiert sich dieses Objekt innerhalb der physikalischen Simulation.
      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).
      See Also:

    • lockRotation

      @API public final Actor lockRotation()
      Blockiert die Rotation im Rahmen der physikalischen Simulation.

      Das Objekt kann in jedem Fall weiterhin über einen direkten Methodenaufruf rotiert werden. Der folgende Code ist immer wirksam, unabhängig davon, ob die Rotation im Rahmen der physikalischen Simulation blockiert ist:

      actor.getPosition.rotate(4.31);

      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).
      Since:
      0.27.0
      See Also:

    • isRotationLocked

      @API public final boolean isRotationLocked()
      Gibt an, ob die Rotation dieses Objekts derzeit innerhalb der physikalischen Simulation blockiert ist.
      Returns:
      true, wenn die Rotation dieses Objekts derzeit innerhalb der physikalischen Simulation blockiert ist.
      See Also:

    • mass

      @API @Getter public final double mass()
      Gibt die aktuelle Masse des Ziel-Objekts aus. Die Form bleibt unverändert, daher ändert sich die Dichte in der Regel.
      Returns:
      Die Masse des Ziel-Objekts in [kg].

    • density

      @API @Setter public final Actor density(double density)
      Setzt die Dichte des Objekts neu. Die Form bleibt dabei unverändert, daher ändert sich die Masse in der Regel.
      Parameters:
      density - Die neue Dichte des Objekts in [kg/m^2].
      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).

    • density

      @API @Getter public final double density()
      Gibt die aktuelle Dichte des Objekts an.
      Returns:
      Die aktuelle Dichte des Objekts in [kg/m^2].

    • gravityScale

      @API @Setter public final Actor gravityScale(double factor)
      Setzt den Gravitationsfaktor, normalerweise im Bereich [0, 1].
      Parameters:
      factor - Der Gravitationsfaktor.
      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).

    • gravityScale

      @API @Getter public final double gravityScale()
      Gibt den aktuellen Gravitationsfaktor des Objekts an.
      Returns:
      Den Gravitationsfaktor.

    • friction

      @API @Setter public final Actor friction(double friction)
      Setzt den Reibungskoeffizient für das Objekt. Dieser hat Einfluss auf die Bewegung des Objekts.
      Parameters:
      friction - Der Reibungskoeffizient. In der Regel im Bereich [0; 1].
      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).
      See Also:

    • friction

      @API @Getter public final double friction()
      Gibt den Reibungskoeffizienten für dieses Objekt aus.
      Returns:
      Der Reibungskoeffizient des Objekts. Ist in der Regel (in der Realität) ein Wert im Bereich [0; 1].
      See Also:

    • angularDamping

      @API @Setter public final Actor angularDamping(double damping)
      Setzt die Dämpfung der Rotationsgeschwindigkeit.
      Parameters:
      damping - Die Dämpfung der Rotationsgeschwindigkeit.

    • angularDamping

      @API @Getter public final double angularDamping()
      Gibt die Dämpfung der Rotationsgeschwindigkeit zurück.
      Returns:
      Die Dämpfung der Rotationsgeschwindigkeit.

    • linearDamping

      @API @Setter public final Actor linearDamping(double damping)
      Setzt die Dämpfung der Geschwindigkeit.
      Parameters:
      damping - Die Dämpfung der Geschwindigkeit.
      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).

    • linearDamping

      @API @Getter public final double linearDamping()
      Gibt die Dämpfung der Geschwindigkeit zurück.
      Returns:
      Dämpfung der Geschwindigkeit

    • velocity

      @API @Setter public final Actor velocity(Vector velocity)
      Setzt die Geschwindigkeit „hart“ für dieses Objekt.

      Damit wird die aktuelle Bewegung (nicht aber die Rotation) des Objekts ignoriert und hart auf den übergebenen Wert gesetzt.

      Parameters:
      velocity - Die Geschwindigkeit, mit der sich dieses Objekt ab sofort bewegen soll. In [m / s]
      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).
      See Also:

    • velocity

      @API @Getter public final Vector velocity()
      Gibt die Geschwindigkeit aus, mit der sich dieses Objekt gerade (also in diesem Frame) bewegt.
      Returns:
      Die Geschwindigkeit, mit der sich dieses Objekt gerade (also in diesem Frame) bewegt. In [m / s]
      See Also:

    • angularVelocity

      @API @Getter public final double angularVelocity()
      Gibt die aktuelle Drehgeschwindigkeit aus.
      Returns:
      Die aktuelle Drehgeschwindigkeit.
      See Also:

    • angularVelocity

      @API @Setter public final Actor angularVelocity(double rotationsPerSecond)
      Setzt die Drehgeschwindigkeit "hart" für dieses Objekt. Damit wird die aktuelle Rotation des Objekts ignoriert und hart auf den übergebenen Wert gesetzt.
      Parameters:
      rotationsPerSecond - Die Geschwindigkeit, mit der sich dieses Objekt ab sofort bewegen soll. In [Umdrehnungen / s]
      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).
      See Also:

    • restitution

      @API @Setter public final Actor restitution(double restitution)
      Setzt die Stoßzahl bzw. den Restitutionskoeffizienten.

      Mit Hilfe der Stoßzahl bzw. des Restitutionskoeffizienten kann angegeben werden, wie „elastisch“ ein Objekt ist. Wie bei der Reibung liegt der Wertebereich zwischen 0 und 1, wobei 0 bedeutet, dass das Objekt überhaupt nicht zurückfedert, und 1, dass die gesamte Energie des Aufpralls erhalten bleibt. Bei Werte größer 1 prallt das Objekt bei jeder Kollision immer weiter ab. Wenn zwei Objekte aufeinander prallen, federt das Objekt mit dem höheren der beiden Stoßzahlen zurück. Soll ein Objekt nicht abprallen, so müssen beide Objekte auf 0 gesetzt werden.

      Parameters:
      restitution - Die Stoßzahl bzw. der Restitutionskoeffizient.
      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).
      See Also:
      JBox2D source code:
      dynamics/FixtureDef.java#L132-L137
      Box2D source code:
      b2_fixture.h#L335-L338

    • restitution

      @API @Getter public final double restitution()
      Gibt die Stoßzahl bzw. den Restitutionskoeffizienten zurück.

      Mit Hilfe der Stoßzahl bzw. des Restitutionskoeffizienten kann angegeben werden, wie „elastisch“ ein Objekt ist. Wie bei der Reibung liegt der Wertebereich zwischen 0 und 1, wobei 0 bedeutet, dass das Objekt überhaupt nicht zurück federt, und 1, dass die gesamte Energie des Aufpralls erhalten bleibt. Bei Werte größer 1 prallt das Objekt bei jeder Kollision immer weiter ab. Wenn zwei Objekte aufeinander prallen, federt das Objekt mit dem höheren der beiden Stoßzahlen zurück. Soll ein Objekt nicht abprallen, so müssen beide Objekte auf 0 gesetzt werden.

      Returns:
      Die Stoßzahl bzw. den Restitutionskoeffizienten.
      See Also:
      JBox2D source code:
      dynamics/FixtureDef.java#L125-L130
      Box2D source code:
      b2_fixture.h#L330-L333

    • applyTorque

      @API public final Actor applyTorque(double torque)
      Wirkt ein Drehmoment auf das Objekt.
      Parameters:
      torque - Drehmoment, der auf das Ziel-Objekt wirken soll. In [N×m]
      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).

    • applyRotationImpulse

      public final Actor applyRotationImpulse(double impulse)
      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).

    • applyForce

      @API public final Actor applyForce(Vector force)
      Wirkt eine Kraft auf den Schwerpunkt des Objekts.
      Parameters:
      force - Der Kraftvektor in [N].
      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).

    • applyForce

      @API public final Actor applyForce(double forceX, double forceY)
      Wirkt eine Kraft auf den Schwerpunkt des Objekts.
      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).

    • applyForce

      @API public final Actor applyForce(Vector force, Vector globalPoint)
      Wirkt eine Kraft auf einem bestimmten Punkt in der Welt.
      Parameters:
      force - Kraft in [N]
      globalPoint - Ort auf der Zeichenebene, an dem die Kraft wirken soll.
      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).

    • applyImpulse

      @API public final Actor applyImpulse(Vector impulse)
      Wirkt einen Impuls auf den Schwerpunkt des Objekts.

      Beispiele:

      • Hammer (300 g, 1 m/s): 0,3 Ns
      • Golfball (45 g, 80 m/s): 3,6 Ns
      • Pistolenkugel (9 g, 500 m/s): 4,5 Ns
      • Radfahrer (80 kg, 18 km/h): 400 Ns
      • Auto (2 t, 30 km/h): 16 000 Ns
      Parameters:
      impulse - Der Impuls in [Ns] [(kg * m) / s], der auf den Schwerpunkt wirken soll.
      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).

    • applyImpulse

      public final Actor applyImpulse(double impulseX, double impulseY)
      Wirkt einen Impuls auf den Schwerpunkt des Objekts.

      Beispiele:

      • Hammer (300 g, 1 m/s): 0,3 Ns
      • Golfball (45 g, 80 m/s): 3,6 Ns
      • Pistolenkugel (9 g, 500 m/s): 4,5 Ns
      • Radfahrer (80 kg, 18 km/h): 400 Ns
      • Auto (2 t, 30 km/h): 16 000 Ns
      Parameters:
      impulseX - Der Impuls in x-Richtung in [Ns] [(kg * m) / s], der auf den Schwerpunkt wirken soll.
      impulseY - Der Impuls in y-Richtung in [Ns] [(kg * m) / s], der auf den Schwerpunkt wirken soll.
      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).

    • applyImpulse

      @API public final Actor applyImpulse(Vector impulse, Vector globalPoint)
      Wirkt einen Impuls an einem bestimmten Punkt in der Welt.

      Beispiele:

      • Hammer (300 g, 1 m/s): 0,3 Ns
      • Golfball (45 g, 80 m/s): 3,6 Ns
      • Pistolenkugel (9 g, 500 m/s): 4,5 Ns
      • Radfahrer (80 kg, 18 km/h): 400 Ns
      • Auto (2 t, 30 km/h): 16 000 Ns
      Parameters:
      impulse - Der Impuls in [Ns].
      globalPoint - Der Ort auf der Zeichenebene, an dem der Impuls wirken soll.
      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).

    • resetMovement

      @API public final Actor resetMovement()
      Versetzt das Objekt - unabhängig von aktuellen Kräften und Geschwindigkeiten - in Ruhe.

      Damit werden alle (physikalischen) Bewegungen des Objektes zurückgesetzt. Sollte eine konstante Schwerkraft (oder etwas Vergleichbares) existieren, wird dieses Objekt jedoch möglicherweise aus der Ruhelage wieder in Bewegung versetzt.

      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).

    • isGrounded

      @API public final boolean isGrounded()
      Testet, ob das Objekt „steht“.

      Diese Funktion ist unter anderem hilfreich für die Entwicklung von Platformern (z.B. wenn der Spieler nur springen können soll, wenn er auf dem Boden steht).

      Diese Funktion ist eine Heuristik, sprich sie ist eine Annäherung. In einer Physik-Simulation ist die Definition von „stehen“ nicht unbedingt einfach. Hier bedeutet es Folgendes:

      Ein Objekt steht genau dann, wenn alle Eigenschaften erfüllt sind:
      • Es ist ein dynamisches Objekt.
      • Direkt unter der Mitte der minimalen AABB, die das gesamte Objekt umspannt, befindet sich ein statisches Objekt.
      Returns:
      true, falls das Objekt auf einem anderen Objekt steht, siehe Beschreibung.

    • createRevoluteJoint

      @API public final RevoluteJoint createRevoluteJoint(Actor other, Vector anchor)
      Erstellt einen Revolute-Joint zwischen dem zugehörigen Actor-Objekt und einem weiteren.

      Definition Revolute-Joint

      Verbindet zwei Actor-Objekte untrennbar an einem Anchor-Point. Die Objekte können sich ab sofort nur noch relativ zueinander drehen.

      Parameters:
      other - Das zweite Actor-Objekt, das ab sofort mit dem zugehörigen Actor-Objekt über einen RevoluteJoint verbunden sein soll.
      anchor - Der Ankerpunkt relativ zu diesem Actor. Es wird davon ausgegangen, dass beide Objekte bereits korrekt positioniert sind.
      Returns:
      Ein Joint-Objekt, mit dem der Joint weiter gesteuert werden kann.
      See Also:
      • RevoluteJoint

    • createRopeJoint

      @API public final RopeJoint createRopeJoint(Actor other, Vector anchorThis, Vector anchorOther, double ropeLength)
      Erstellt eine Seilverbindung zwischen diesem und einem weiteren Actor-Objekt.
      Parameters:
      other - Das zweite Actor-Objekt, das ab sofort mit dem zugehörigen Actor-Objekt über einen RopeJoint verbunden sein soll.
      anchorThis - Der Ankerpunkt für das zugehörige Actor-Objekt. Der erste Befestigungspunkt des Lassos. Die Angabe ist relativ zur Position des zugehörigen Objekts (linke untere Ecke).
      anchorOther - Der Ankerpunkt für das zweite Actor-Objekt, also other. Der zweite Befestigungspunkt des Lassos. Die Angabe ist relativ zur Position des zugehörigen Objekts (linke untere Ecke).
      ropeLength - Die Länge des Lassos. Dies ist ab sofort die maximale Länge, die die beiden Ankerpunkte der Objekte voneinader entfernt sein können.
      Returns:
      Ein Joint-Objekt, mit dem der Joint weiter gesteuert werden kann.
      See Also:
      • RopeJoint

    • createPrismaticJoint

      @API public final PrismaticJoint createPrismaticJoint(Actor other, Vector anchor, double axisAngle)
      Erstellt einen neuen PrismaticJoint zwischen zwei Objekten.
      Parameters:
      other - Objekt, das mit dem aktuellen verbunden werden soll
      anchor - Verbindungspunkt
      axisAngle - Winkel
      Returns:
      Objekt für die weitere Steuerung des Joints

    • createDistanceJoint

      @API public final DistanceJoint createDistanceJoint(Actor other, Vector anchorThis, Vector anchorOther)
      Erstellt eine Stabverbindung (DistanceJoint) zwischen diesem und einem weiteren Actor-Objekt.
      Parameters:
      other - Das zweite Actor-Objekt, das ab sofort mit dem zugehörigen Actor-Objekt über einen DistanceJoint verbunden sein soll.
      anchorThis - Der Ankerpunkt für das zugehörige Actor-Objekt. Der erste Befestigungspunkt des Joints. Die Angabe ist relativ zur Position des zugehörigen Objekts (linke untere Ecke).
      anchorOther - Der Ankerpunkt für das zweite Actor-Objekt, also other. Der zweite Befestigungspunkt des Joints. Die Angabe ist relativ zur Position des zugehörigen Objekts (linke untere Ecke).
      Returns:
      Ein DistanceJoint-Objekt, mit dem die Verbindung weiter gesteuert werden kann.
      See Also:
      • DistanceJoint

    • createWeldJoint

      @API public final WeldJoint createWeldJoint(Actor other, Vector anchorThis, Vector anchorOther)
      Erstellt eine Schweißnaht - besser einen Schweißpunkt - zwischen diesem und einem weiteren Actor-Objekt.
      Parameters:
      other - Das zweite Actor-Objekt, das ab sofort mit dem zugehörigen Actor-Objekt über eine Schweißnaht verbunden sein soll.
      anchorThis - Der Ankerpunkt für das zugehörige Actor-Objekt. Der erste Befestigungspunkt der Schweißnaht. Die Angabe ist relativ zur Position des zugehörigen Objekts (linke untere Ecke).
      anchorOther - Der Ankerpunkt für das zweite Actor-Objekt, also other. Der zweite Befestigungspunkt der Schweißnaht. Die Angabe ist relativ zur Position des zugehörigen Objekts (linke untere Ecke).
      Returns:
      Ein WeldJoint-Objekt, mit dem die Verbindung weiter gesteuert werden kann.
      See Also:
      • WeldJoint

    • position

      @API @Setter public final Actor position(double x, double y)
      Setzt die Position des Actor-Objektes gänzlich neu auf der Zeichenebene. Das Setzen ist technisch gesehen eine Verschiebung von der aktuellen Position an die neue.
      Parameters:
      x - Die neue x-Koordinate.
      y - Die neue y-Koordinate.
      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).
      See Also:

    • position

      @API @Setter public final Actor position(Vector position)
      Setzt die Position des Objektes gänzlich neu auf der Zeichenebene. Das Setzen ist technisch gesehen eine Verschiebung von der aktuellen Position an die neue.
      Parameters:
      position - Der neue Zielpunkt.
      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).
      See Also:

    • moveBy

      @API public final Actor moveBy(Vector vector)
      Verschiebt das Objekt ohne Bedingungen auf der Zeichenebene.
      Parameters:
      vector - Der Vektor, der die Verschiebung des Objekts angibt.
      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).
      See Also:

    • moveBy

      @API public final Actor moveBy(double dX, double dY)
      Verschiebt das Objekt.

      Hierbei wird nichts anderes gemacht, als moveBy(new Vector(dx, dy)) auszuführen. Insofern ist diese Methode dafür gut, sich nicht mit der Klasse Vector auseinandersetzen zu müssen.

      Parameters:
      dX - Die Verschiebung in Richtung X.
      dY - Die Verschiebung in Richtung Y.
      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).
      See Also:

    • center

      @API @Setter public final Actor center(double x, double y)
      Verschiebt die Actor-Figur so, dass ihr Mittelpunkt die angegebenen Koordinaten hat.

      Im Gegensatz zur center(Vector)-Methode muss hier kein neues Vector-Objekt erzeugt werden. Der Mittelpunkt ist durch zwei einzelne Werte, nämlich die x- und die y-Koordinate, anzugeben.

      Diese Methode ermittelt zuerst den aktuellen achsenparallelen Begrenzungsrahmen (axis-aligned bounding box (AABB)) der Figur. Von diesem Begrenzungsrahmen wird anschließend der Mittelpunkt bestimmt (center()). Die Methode berechnet schließlich den Differenzvektor zwischen dem aktuellen Mittelpunkt und dem gewünschten neuen Mittelpunkt und verschiebt die Figur mit Hilfe dieses Differenzvektors.

      Parameters:
      x - Die x-Koordinate des neuen Mittelpunktes der Figur.
      y - Die y-Koordinate des neuen Mittelpunktes der Figur.
      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).
      See Also:

    • center

      @API @Setter public final Actor center(Vector center)
      Verschiebt die Actor-Figur so, dass ihr Mittelpunkt die angegebenen Koordinaten hat.

      Diese Methode ermittelt zuerst den aktuellen achsenparallelen Begrenzungsrahmen (axis-aligned bounding box (AABB)) der Figur. Von diesem Begrenzungsrahmen wird anschließend der Mittelpunkt bestimmt (center()). Die Methode berechnet schließlich den Differenzvektor zwischen dem aktuellen Mittelpunkt und dem gewünschten neuen Mittelpunkt und verschiebt die Figur mit Hilfe dieses Differenzvektors.

      Parameters:
      center - Der neue Mittelpunkt der Figur.
      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).
      See Also:

    • x

      @API @Getter public final double x()
      Gibt die x-Koordinate der linken unteren Ecke zurück. Sollte das Raumobjekt nicht rechteckig sein, so wird die Position der linken unteren Ecke des umschließenden Rechtecks genommen.
      Returns:
      x-Koordinate
      See Also:

    • x

      @API @Setter public final Actor x(double x)
      Setzt die x-Koordinate der Position des Objektes gänzlich neu auf der Zeichenebene. Das Setzen ist technisch gesehen eine Verschiebung von der aktuellen Position an die neue.

      Achtung!
      Bei allen Objekten ist die eingegebene Position die linke, untere Ecke des Rechtecks, das die Figur optimal umfasst. Das heißt, dass dies bei Kreisen z.B. nicht der Mittelpunkt ist! Hierfür gibt es die Sondermethode center(double, double).

      Parameters:
      x - neue x-Koordinate
      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).
      See Also:

    • y

      @API @Getter public final double y()
      Gibt die y-Koordinate der linken unteren Ecke zurück. Sollte das Raumobjekt nicht rechteckig sein, so wird die Position der linken unteren Ecke des umschließenden Rechtecks genommen.
      Returns:
      Die y-Koordinate
      See Also:

    • y

      @API public final Actor y(double y)
      Setzt die y-Koordinate der Position des Objektes gänzlich neu auf der Zeichenebene. Das Setzen ist technisch gesehen eine Verschiebung von der aktuellen Position an die neue.

      Achtung!
      Bei allen Objekten ist die eingegebene Position die linke, untere Ecke des Rechtecks, das die Figur optimal umfasst. Das heißt, dass dies bei Kreisen z.B. nicht der Mittelpunkt ist! Hierfür gibt es die Sondermethode center(double, double).

      Parameters:
      y - neue y-Koordinate
      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).
      See Also:

    • center

      @API @Getter public final Vector center()
      Gibt den Mittelpunkt des Objektes in der Scene aus.
      Returns:
      Die Koordinaten des Mittelpunktes des Objektes.
      See Also:

    • centerRelative

      @API @Getter public final Vector centerRelative()
      Gibt die Position des Zentrums des Actor-Objekts relativ zu dessen Position (Anker links unten) an.
      Returns:
      Die Position des Zentrums des Actor-Objekts relativ zu dessen Position (Anker links unkten).

    • position

      @API @Getter public final Vector position()
      Gibt die Position dieses Actor-Objekts aus.
      Returns:
      Die aktuelle Position dieses Actor-Objekts.

    • positionformatted

      @Getter public final String positionformatted()
      Gibt die Position formatiert als Zeichenkette aus.
      Returns:
      Die Position als Zeichenkette im Format 0.0|0.0.

    • rotateBy

      @API public final Actor rotateBy(double angle)
      Rotiert das Objekt um den angegebenen Winkel.

      Positive Werte drehen die Figur gegen den Uhrzeigersinn, negative im Uhrzeigersinn.

      Parameters:
      angle - Der Winkel (in Grad), um den das Objekt rotiert werden soll.
      • Werte > 0 : Drehung gegen Uhrzeigersinn
      • Werte < 0 : Drehung im Uhrzeigersinn
      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).
      See Also:

    • rotation

      @API @Getter public final double rotation()
      Gibt den Winkel aus, um den das Objekt derzeit rotiert ist.
      Returns:
      Der Winkel (in Grad), um den das Objekt derzeit rotiert ist. Jedes Objekt ist bei Initialisierung nicht rotiert (rotation() gibt direkt ab Initialisierung 0 zurück).

    • rotation

      @API @Setter public final Actor rotation(double winkel)
      Setzt den Rotationswert des Objekts. Nach Erzeugung der Figur ist der Rotationswert 0. setRotation(90) dreht die Figur beispiels um 90 Grad gegen den Uhrzeigersinn, setRotation(-90) um 90 Grad im Uhrzeigersinn.
      Parameters:
      winkel - Der Winkel (in Grad), um den das Objekt von seiner Ausgangsposition bei Initialisierung rotiert werden soll.
      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).

    • isMounted

      @API public final boolean isMounted()
      Gibt wahr zurück, falls das Objekt einer Ebene zugeordnet ist.
      Returns:
      wahr, falls das Objekt einer Ebene zugeordnet ist, sonst falsch.

    • animateParticle

      @API public final ValueAnimator<Double> animateParticle(double lifetime)
      Setzt den BodyType auf PARTICLE und animiert das Partikel, sodass es ausblasst und nach der Lebenszeit komplett verschwindet.
      Parameters:
      lifetime - Die Lebenszeit in Sekunden.
      Returns:
      Das Objekt, das die Animation kontrolliert.

    • animateOpacity

      @API public final ValueAnimator<Double> animateOpacity(double time, double toOpacityValue)
      Animiert die Durchsichtigkeit dieses Actor-Objekts über einen festen Zeitraum: Beginnend von der aktuellen Durchsichtigkeit, ändert sie sich "smooth" (mit EaseInOutDouble-Interpolation) vom aktuellen Durchsichtigkeits-Wert (die Ausgabe von opacity()) bis hin zum angegebenen Durchsichtigkeitswert.
      Parameters:
      time - Die Animationszeit in Sekunden
      toOpacityValue - Der Durchsichtigkeit-Wert, zu dem innerhalb von time zu interpolieren ist.
      Returns:
      Ein ValueAnimator, der diese Animation ausführt. Der Animator ist bereits aktiv, es muss nichts an dem Objekt getan werden, um die Animation auszuführen.
      See Also:

    • awake

      public Actor awake()
      Weckt die Figur auf. Eine schlafende Figur hat sehr geringe CPU-Kosten, deshalb wird sie von der Physics-Engine in den Schlafzustand gesetzt, wenn sie zur Ruhe kommt.
      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).

    • sleep

      public Actor sleep()
      Versetzt die Figur in den Schlafzustand. Eine schlafende Figur hat sehr geringe CPU-Kosten.

      Das Versetzen in den Schlafzustand setzt die Geschwindigkeit und den Impuls der Figur auf null.

      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinander gekettete Setter festgelegt werden können, z. B. actor.color(..).postion(..).