Package de.pirckheimer_gymnasium.engine_pi.actor

Class Actor

java.lang.Object
de.pirckheimer_gymnasium.engine_pi.actor.Actor
All Implemented Interfaces:
FrameUpdateListenerContainer, KeyListenerContainer, MouseClickListenerContainer, MouseWheelListenerContainer
Direct Known Subclasses:
Animation, Geometry, Grid, Image, StatefulAnimation, TileContainer
public abstract class Actor extends Object implements KeyListenerContainer, MouseClickListenerContainer, MouseWheelListenerContainer, FrameUpdateListenerContainer
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

  • 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 void addMountListener(Runnable listener)
      Fügt einen Beobachter hinzu, der ausgeführt wird, sobald das Objekt angemeldet wurde.
      Parameters:
      listener - Beobachter-Implementierung

    • removeMountListener

      @API public final void removeMountListener(Runnable listener)
      Entfernt einen Beobachter, der ausgeführt wird, sobald das Objekt angemeldet wurde.
      Parameters:
      listener - Beobachter-Implementierung

    • addUnmountListener

      @API public final void addUnmountListener(Runnable listener)
      Fügt einen Beobachter hinzu, der ausgeführt wird, sobald das Objekt abgemeldet wurde.
      Parameters:
      listener - Beobachter-Implementierung

    • removeUnmountListener

      @API public final void removeUnmountListener(Runnable listener)
      Entfernt einen Beobachter, der ausgeführt wird, sobald das Objekt abgemeldet wurde.
      Parameters:
      listener - Beobachter-Implementierung

    • setLayerPosition

      @API public final void setLayerPosition(int position)
      Setzt die Ebenenposition dieses Objekts. Je größer, desto weiter vorne wird das Objekt gezeichnet.
      Parameters:
      position - Der Ebenen-Index.
      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 void 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.
      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 void setOpacity(double opacity)
      Setzt die Durchsichtigkeit des Objekts.
      Parameters:
      opacity -
      • 0.0 entspricht einem komplett durchsichtigen (transparenten) Objekt.
      • 1.0 entspricht einem undurchsichtigem Objekt.

    • 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 void 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.
      See Also:

    • makeStatic

      @API public final void 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.

      See Also:

    • makeDynamic

      @API public final void 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.

      See Also:

    • makeKinematic

      @API public final void 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.

      See Also:

    • makeSensor

      @API public final void 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.

      See Also:

    • makeParticle

      @API public final void 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.

      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 void setFixtures(String shapeCode)
      Setzt den Umriss für dieses Objekt neu. Hat Einfluss auf die Physik (Kollisionen, Masse, etc.)
      Parameters:
      shapeCode - der Shape-Code
      See Also:

    • setFixture

      @API public final void 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.
      See Also:

    • setFixtures

      @API public final void 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.
      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 zeichnende Graphics-Objekt.
      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 - Pixel pro Meter.

    • 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> void 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.
      See Also:

    • addCollisionListener

      @API public final <E extends Actor> void 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.
      See Also:

    • addCollisionListener

      @API public final void 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.
      See Also:

    • render

      @Internal public abstract void render(Graphics2D g, double pixelPerMeter)
      Rendert das Objekt am Ursprung.
      • Die Position ist (0|0).
      • Die Roation ist 0.
      Parameters:
      g - Das zeichnende Graphics-Objekt
      pixelPerMeter - Pixel pro Meter.

    • setPhysicsHandler

      @Internal public final void 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 void remove()
      Entfernt das aktuelle Objekt aus seiner aktuellen Ebene, falls das Objekt gerade einer Ebene zugeordnet ist.

    • getKeyListeners

      @API public final EventListeners<KeyListener> getKeyListeners()
      Specified by:
      getKeyListeners in interface KeyListenerContainer
      Returns:
      Liste der KeyListener.

    • getMouseClickListeners

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

    • getMouseWheelListeners

      @API public final EventListeners<MouseWheelListener> getMouseWheelListeners()
      Specified by:
      getMouseWheelListeners in interface MouseWheelListenerContainer
      Returns:
      Liste der MouseWheelListener.

    • getFrameUpdateListeners

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

    • setRotationLocked

      @API public final void 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.
      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 void 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].

    • 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 void setGravityScale(double factor)
      Setzt den Gravitationsfaktor, normalerweise im Bereich [0, 1].
      Parameters:
      factor - Der Gravitationsfaktor.

    • getGravityScale

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

    • setFriction

      @API public final void 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].
      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 void 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 void setLinearDamping(double damping)
      Setzt die Dämpfung der Geschwindigkeit.
      Parameters:
      damping - Die Dämpfung der Geschwindigkeit.

    • getLinearDamping

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

    • setVelocity

      @API public final void 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]
      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 void 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]
      See Also:

    • setElasticity

      @API public final void 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.
      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 void applyTorque(double torque)
      Wirkt ein Drehmoment auf das Objekt.
      Parameters:
      torque - Drehmoment, der auf das Ziel-Objekt wirken soll. In [N*m]

    • applyRotationImpulse

      public final void applyRotationImpulse(double impulse)

    • applyForce

      @API public final void applyForce(Vector force)
      Wirkt eine Kraft auf den Schwerpunkt des Objekts.
      Parameters:
      force - Der Kraftvektor in [N].

    • applyForce

      public final void applyForce(double forceX, double forceY)

    • applyForce

      @API public final void 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.

    • applyImpulse

      @API public final void 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.

    • applyImpulse

      public final void 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.

    • applyImpulse

      @API public final void 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.

    • resetMovement

      @API public final void 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.

    • 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 einen 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 einen 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 void 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.
      See Also:

    • setPosition

      @API public final void 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.
      See Also:

    • moveBy

      @API public final void moveBy(Vector vector)
      Verschiebt das Objekt ohne Bedingungen auf der Zeichenebene.
      Parameters:
      vector - Der Vektor, der die Verschiebung des Objekts angibt.
      See Also:

    • moveBy

      @API public final void 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.
      See Also:

    • setCenter

      @API public final void 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
      See Also:

    • setCenter

      @API public final void 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
      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 void 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
      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 void 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
      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 Zentrum des Actor-Objekts relativ zu dessen Position (Anker links unten) an.
      Returns:
      Die Position des Zentrum 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.

    • rotateBy

      @API public final void rotateBy(double degree)
      Rotiert das Objekt.
      Parameters:
      degree - Der Winkel (in Grad), um den das Objekt rotiert werden soll.
      • Werte > 0 : Drehung gegen Uhrzeigersinn
      • Werte < 0 : Drehung im Uhrzeigersinn

    • 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 void setRotation(double degree)
      Setzt den Rotationswert des Objekts.
      Parameters:
      degree - Der Winkel (in Grad), um den das Objekt von seiner Ausgangsposition bei Initialisierung rotiert werden soll.

    • 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: