Package de.pirckheimer_gymnasium.engine_pi.actor

Class Actor

java.lang.Object
de.pirckheimer_gymnasium.engine_pi.actor.Actor
All Implemented Interfaces:
FrameUpdateListenerRegistration, KeyStrokeListenerRegistration, MouseClickListenerRegistration, MouseScrollListenerRegistration
Direct Known Subclasses:
Animation, Geometry, Grid, Image, StatefulAnimation, TileRegistration
public abstract class Actor extends Object implements KeyStrokeListenerRegistration, MouseClickListenerRegistration, MouseScrollListenerRegistration, FrameUpdateListenerRegistration
Jedes Objekt 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.

  • Constructor Details

    • Actor

      public Actor(Supplier<FixtureData> defaultFixtureSupplier)
      Erstellt ein neues Objekt.
      Parameters:
      defaultFixtureSupplier - Ein Supplier, der die Default-Shape für dieses Objekt generiert. Die ist in der Regel ein optimal gelegtes Rechteck parallel zu den Axen bei Rotationswinkel 0.

  • 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 aneinandergekettete Setter festgelegt werden können, z. B. actor.setColor(..).setPostion(..).

    • 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 aneinandergekettete Setter festgelegt werden können, z. B. actor.setColor(..).setPostion(..).

    • 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 aneinandergekettete Setter festgelegt werden können, z. B. actor.setColor(..).setPostion(..).

    • 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 aneinandergekettete Setter festgelegt werden können, z. B. actor.setColor(..).setPostion(..).

    • setLayerPosition

      @API public final Actor setLayerPosition(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 aneinandergekettete Setter festgelegt werden können, z. B. actor.setColor(..).setPostion(..).
      See Also:

    • getLayerPosition

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

    • setVisible

      @API public final Actor setVisible(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 aneinandergekettete Setter festgelegt werden können, z. B. actor.setColor(..).setPostion(..).
      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:

    • getOpacity

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

    • setOpacity

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

    • getColor

      public Color getColor()
      Gibt die Farbe der Figur zurück.
      Returns:
      Die Farbe der Figur.

    • getComplementaryColor

      public Color getComplementaryColor()
      Gibt die Komplementärfarbe der Figur zurück.
      Returns:
      Die Komplementärfarbe der Figur.

    • setColor

      @API public Actor setColor(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 aneinandergekettete Setter festgelegt werden können, z. B. actor.setColor(..).setPostion(..).

    • setColor

      @API public Actor setColor(String color)
      Setzt die Farbe der Figur auf eine bestimmte Farbe, die als Zeichkette 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 aneinandergekettete Setter festgelegt werden können, z. B. actor.setColor(..).setPostion(..).
      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:

    • getCollisions

      public final List<CollisionEvent<Actor>> getCollisions()
      Git eine List bestehend aus Kollisionsereignissen zurück.
      Returns:
      Eine Liste aus Kollisionsereignissen.

    • setBodyType

      @API public final Actor setBodyType(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 aneinandergekettete Setter festgelegt werden können, z. B. actor.setColor(..).setPostion(..).
      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 aneinandergekettete Setter festgelegt werden können, z. B. actor.setColor(..).setPostion(..).
      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 aneinandergekettete Setter festgelegt werden können, z. B. actor.setColor(..).setPostion(..).
      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 aneinandergekettete Setter festgelegt werden können, z. B. actor.setColor(..).setPostion(..).
      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 aneinandergekettete Setter festgelegt werden können, z. B. actor.setColor(..).setPostion(..)
      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 aneinandergekettete Setter festgelegt werden können, z. B. actor.setColor(..).setPostion(..).
      See Also:

    • getBodyType

      @API public final BodyType getBodyType()
      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:

    • setFixtures

      @API public final Actor setFixtures(String shapeCode)
      Setzt den Umriss für dieses Objekt neu. Hat Einfluss auf die Physik (Kollisionen, Masse, etc.)
      Parameters:
      shapeCode - der Shape-Code
      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinandergekettete Setter festgelegt werden können, z. B. actor.setColor(..).setPostion(..).
      See Also:

    • setFixture

      @API public final Actor setFixture(Supplier<FixtureData> fixtureSupplier)
      Ändert die Fixture des Actors neu in eine einzige alternative Fixture.
      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 aneinandergekettete Setter festgelegt werden können, z. B. actor.setColor(..).setPostion(..).
      See Also:

    • setFixtures

      @API public final Actor setFixtures(Supplier<List<FixtureData>> fixturesSupplier)
      Ändert die Umrisse 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 aneinandergekettete Setter festgelegt werden können, z. B. actor.setColor(..).setPostion(..).
      See Also:

    • renderBasic

      @Internal public final void renderBasic(Graphics2D g, Bounds r, double pixelPerMeter)
      Die Basiszeichenmethode.

      Sie schließt eine Fallabfrage zur Sichtbarkeit ein.

      Parameters:
      g - Das Graphics2D-Objekt, in das gezeichnet werden soll.
      r - Das Bounds, dass die Kameraperspektive repräsentiert.
      Hierbei soll zunächst getestet werden, ob das Objekt innerhalb der Kamera liegt, und erst dann gezeichnet werden.
      pixelPerMeter - Gibt an, wie viele Pixel ein Meter misst.

    • getPhysicsHandler

      @Internal public final PhysicsHandler getPhysicsHandler()
      Gibt den aktuellen, internen Physics-Handler aus.
      Returns:
      der aktuellen, internen Physics-Handler aus.

    • 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 aneinandergekettete Setter festgelegt werden können, z. B. actor.setColor(..).setPostion(..).
      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 aneinandergekettete Setter festgelegt werden können, z. B. actor.setColor(..).setPostion(..).
      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 aneinandergekettete Setter festgelegt werden können, z. B. actor.setColor(..).setPostion(..).
      See Also:

    • render

      @Internal public abstract void render(Graphics2D g, double pixelPerMeter)
      Zeichnet die Figur an der Position (0|0) mit der Rotation 0.
      Parameters:
      g - Das Graphics2D-Objekt, in das gezeichnet werden soll.
      pixelPerMeter - Gibt an, wie viele Pixel ein Meter misst.

    • setPhysicsHandler

      @Internal public final Actor setPhysicsHandler(PhysicsHandler handler)

    • getLayer

      public final Layer getLayer()
      Returns:
      Gibt die Ebene zurück, 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 aneinandergekettete Setter festgelegt werden können, z. B. actor.setColor(..).setPostion(..).

    • getListenerBundle

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

    • getKeyStrokeListeners

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

    • getMouseClickListeners

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

    • getMouseScrollListeners

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

    • getFrameUpdateListeners

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

    • setRotationLocked

      @API public final Actor setRotationLocked(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 physikalsichen Simulation.
      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinandergekettete Setter festgelegt werden können, z. B. actor.setColor(..).setPostion(..).
      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:

    • getMass

      @API public final double getMass()
      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].

    • setDensity

      @API public final Actor setDensity(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 aneinandergekettete Setter festgelegt werden können, z. B. actor.setColor(..).setPostion(..).

    • getDensity

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

    • setGravityScale

      @API public final Actor setGravityScale(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 aneinandergekettete Setter festgelegt werden können, z. B. actor.setColor(..).setPostion(..).

    • getGravityScale

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

    • setFriction

      @API public final Actor setFriction(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 aneinandergekettete Setter festgelegt werden können, z. B. actor.setColor(..).setPostion(..).
      See Also:

    • getFriction

      @API public final double getFriction()
      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:

    • setAngularDamping

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

    • getAngularDamping

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

    • setLinearDamping

      @API public final Actor setLinearDamping(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 aneinandergekettete Setter festgelegt werden können, z. B. actor.setColor(..).setPostion(..).

    • getLinearDamping

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

    • setVelocity

      @API public final Actor setVelocity(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 aneinandergekettete Setter festgelegt werden können, z. B. actor.setColor(..).setPostion(..).
      See Also:

    • getVelocity

      @API public final Vector getVelocity()
      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:

    • getAngularVelocity

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

    • setAngularVelocity

      @API public final Actor setAngularVelocity(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 aneinandergekettete Setter festgelegt werden können, z. B. actor.setColor(..).setPostion(..).
      See Also:

    • setElasticity

      @API public final Actor setElasticity(double elasticity)
      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:
      elasticity - 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 aneinandergekettete Setter festgelegt werden können, z. B. actor.setColor(..).setPostion(..).
      See Also:
      jbox2d source code:
      https://github.com/jbox2d/jbox2d/blob/94bb3e4a706a6d1a5d8728a722bf0af9924dde84/jbox2d-library/src/main/java/org/jbox2d/dynamics/FixtureDef.java#L132-L137
      box2d source code:
      https://github.com/erincatto/box2d/blob/411acc32eb6d4f2e96fc70ddbdf01fe5f9b16230/include/box2d/b2_fixture.h#L335-L338

    • getElasticity

      @API public final double getElasticity()
      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ü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.

      Returns:
      Die Stoßzahl bzw. den Restitutionskoeffizienten.
      See Also:
      jbox2d source code:
      https://github.com/jbox2d/jbox2d/blob/94bb3e4a706a6d1a5d8728a722bf0af9924dde84/jbox2d-library/src/main/java/org/jbox2d/dynamics/FixtureDef.java#L125-L130
      box2d source code:
      https://github.com/erincatto/box2d/blob/411acc32eb6d4f2e96fc70ddbdf01fe5f9b16230/include/box2d/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 aneinandergekettete Setter festgelegt werden können, z. B. actor.setColor(..).setPostion(..).

    • 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 aneinandergekettete Setter festgelegt werden können, z. B. actor.setColor(..).setPostion(..).

    • 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 aneinandergekettete Setter festgelegt werden können, z. B. actor.setColor(..).setPostion(..).

    • applyForce

      public final Actor applyForce(double forceX, double forceY)
      Returns:
      Eine Referenz auf die eigene Instanz der Figur, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Figur durch aneinandergekettete Setter festgelegt werden können, z. B. actor.setColor(..).setPostion(..).

    • 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 aneinandergekettete Setter festgelegt werden können, z. B. actor.setColor(..).setPostion(..).

    • 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 aneinandergekettete Setter festgelegt werden können, z. B. actor.setColor(..).setPostion(..).

    • 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 x-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 aneinandergekettete Setter festgelegt werden können, z. B. actor.setColor(..).setPostion(..).

    • 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 aneinandergekettete Setter festgelegt werden können, z. B. actor.setColor(..).setPostion(..).

    • 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, wo 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 aneinandergekettete Setter festgelegt werden können, z. B. actor.setColor(..).setPostion(..).

    • 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

    • setPosition

      @API public final Actor setPosition(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 aneinandergekettete Setter festgelegt werden können, z. B. actor.setColor(..).setPostion(..).
      See Also:

    • setPosition

      @API public final Actor setPosition(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 aneinandergekettete Setter festgelegt werden können, z. B. actor.setColor(..).setPostion(..).
      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 aneinandergekettete Setter festgelegt werden können, z. B. actor.setColor(..).setPostion(..).
      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 aneinandergekettete Setter festgelegt werden können, z. B. actor.setColor(..).setPostion(..).
      See Also:

    • setCenter

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

      Diese Methode arbeitet nach dem Mittelpunkt des das Objekt abdeckenden Bounding-Rechtecks durch den Aufruf der Methode setCenter(double, double).

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

    • setCenter

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

      Diese Methode arbeitet mit dem Mittelpunkt des das Objekt abdeckenden Bounding-Rechtecks durch den Aufruf der Methode getCenter().

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

    • getX

      @API public final double getX()
      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:

    • setX

      @API public final Actor setX(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 setCenter(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 aneinandergekettete Setter festgelegt werden können, z. B. actor.setColor(..).setPostion(..).
      See Also:

    • getY

      @API public final double getY()
      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:

    • setY

      @API public final Actor setY(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 setCenter(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 aneinandergekettete Setter festgelegt werden können, z. B. actor.setColor(..).setPostion(..).
      See Also:

    • getCenter

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

    • getCenterRelative

      @API public final Vector getCenterRelative()
      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).

    • getPosition

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

    • getPositionformatted

      public final String getPositionformatted()
      Gibt die Position formatiert als Zeichenkette aus.
      Returns:
      Die Position als Zeichenkette im Format 0.00|0.00.

    • rotateBy

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

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

      Parameters:
      degree - 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 aneinandergekettete Setter festgelegt werden können, z. B. actor.setColor(..).setPostion(..).
      See Also:

    • getRotation

      @API public final double getRotation()
      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 (getRotation() gibt direkt ab Initialisierung 0 zurück).

    • setRotation

      @API public final Actor setRotation(double degree)
      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:
      degree - 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 aneinandergekettete Setter festgelegt werden können, z. B. actor.setColor(..).setPostion(..).

    • 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 getOpacity()) 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 aneinandergekettete Setter festgelegt werden können, z. B. actor.setColor(..).setPostion(..).

    • 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 aneinandergekettete Setter festgelegt werden können, z. B. actor.setColor(..).setPostion(..).