Package de.pirckheimer_gymnasium.engine_pi.actor

Class Animation

java.lang.Object

de.pirckheimer_gymnasium.engine_pi.actor.Actor

de.pirckheimer_gymnasium.engine_pi.actor.Animation

All Implemented Interfaces:

FrameUpdateListener, FrameUpdateListenerRegistration, KeyStrokeListenerRegistration, MouseClickListenerRegistration, MouseScrollListenerRegistration

@API
public class Animation
extends Actor
implements FrameUpdateListener

Eine Animation ist ein Actor-Objekt, das aus mehreren Frames besteht. Frames können auf verschiedene Arten aus Bilddateien eingeladen werden:

• Animierte GIFs
• Spritesheets
• Einzelne Bilddateien

Author:

Michael Andonie

Field Summary

Fields inherited from class de.pirckheimer_gymnasium.engine_pi.actor.Actor

color

Constructor Summary

Constructors

Constructor	Description
Animation(Animation animation)	Copy-Konstruktor, damit Vererbung genutzt werden kann.

Method Summary

Modifier and Type	Method	Description
void	addOnCompleteListener(Runnable listener)	Fügt einen Listener hinzu.
static Animation	createFromAnimatedGif(String filepath, double width, double height)
static Animation	createFromImages(double frameDuration, double width, double height, String... filepaths)
static Animation	createFromImagesPrefix(double frameDuration, double width, double height, String directoryPath, String prefix)	Lädt alle Bilddateien mit einem bestimmten Präfix in einem bestimmten Verzeichnis in eine Animation.
static Animation	createFromSpritesheet(double frameDuration, String filepath, int x, int y, double width, double height)
AnimationFrame[]	getFrames()	Gibt die Frames dieser Animation aus.
double	getHeight()	Gibt die Höhe der Animation in Metern aus.
double	getWidth()	Gibt die Breite der Animation in Metern aus.
void	onFrameUpdate(double pastTime)	Diese Methode wird bei einem (angemeldeten) Objekt bei jedem Einzelbild erneut aufgerufen.
void	render(Graphics2D g, double pixelPerMeter)	Zeichnet die Figur an der Position (0|0) mit der Rotation 0.

Methods inherited from class de.pirckheimer_gymnasium.engine_pi.actor.Actor

addCollisionListener, addCollisionListener, addCollisionListener, addMountListener, addUnmountListener, animateOpacity, animateParticle, applyForce, applyForce, applyForce, applyImpulse, applyImpulse, applyImpulse, applyRotationImpulse, applyTorque, awake, contains, createDistanceJoint, createPrismaticJoint, createRevoluteJoint, createRopeJoint, createWeldJoint, getAngularDamping, getAngularVelocity, getBodyType, getCenter, getCenterRelative, getCollisions, getColor, getComplementaryColor, getDensity, getElasticity, getFrameUpdateListeners, getFriction, getGravityScale, getKeyStrokeListeners, getLayer, getLayerPosition, getLinearDamping, getListenerBundle, getMass, getMouseClickListeners, getMouseScrollListeners, getOpacity, getPhysicsHandler, getPosition, getPositionformatted, getRotation, getVelocity, getX, getY, isGrounded, isMounted, isRotationLocked, isVisible, makeDynamic, makeKinematic, makeParticle, makeSensor, makeStatic, moveBy, moveBy, overlaps, remove, removeMountListener, removeUnmountListener, renderBasic, resetMovement, rotateBy, setAngularDamping, setAngularVelocity, setBodyType, setCenter, setCenter, setColor, setColor, setDensity, setElasticity, setFixture, setFixtures, setFixtures, setFriction, setGravityScale, setLayerPosition, setLinearDamping, setOpacity, setPhysicsHandler, setPosition, setPosition, setRotation, setRotationLocked, setVelocity, setVisible, setX, setY, sleep

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface de.pirckheimer_gymnasium.engine_pi.event.FrameUpdateListenerRegistration

addFrameUpdateListener, defer, delay, removeFrameUpdateListener, repeat, repeat, repeat, repeat, repeat

Methods inherited from interface de.pirckheimer_gymnasium.engine_pi.event.KeyStrokeListenerRegistration

addKeyStrokeListener, removeKeyStrokeListener

Methods inherited from interface de.pirckheimer_gymnasium.engine_pi.event.MouseClickListenerRegistration

addMouseClickListener, removeMouseClickListener

Methods inherited from interface de.pirckheimer_gymnasium.engine_pi.event.MouseScrollListenerRegistration

addMouseScrollListener, removeMouseScrollListener

Constructor Details

Animation

public Animation(Animation animation)

Copy-Konstruktor, damit Vererbung genutzt werden kann.

Parameters:

animation - Animation.

Method Details

getFrames

@Internal
public AnimationFrame[] getFrames()

Gibt die Frames dieser Animation aus.

Returns:

Die Frames dieser Animation.

getWidth

@API
public double getWidth()

Gibt die Breite der Animation in Metern aus.

Returns:

Die Breite der Animation in Pixel.

See Also:

• getHeight()

getHeight

@API
public double getHeight()

Gibt die Höhe der Animation in Metern aus.

Returns:

Die Höhe der Animation in Pixel

See Also:

• getWidth()

addOnCompleteListener

@API
public void addOnCompleteListener(Runnable listener)

Fügt einen Listener hinzu. Die run()-Methode wird immer wieder ausgeführt, sobald der letzte Zustand der Animation abgeschlossen wurde.

Parameters:

listener - Ein Runnable, dessen run-Methode ausgeführt werden soll, sobald die Animation abgeschlossen ist (wird ausgeführt, bevor der Loop von Vorne beginnt).

onFrameUpdate

@Internal
public void onFrameUpdate(double pastTime)

Description copied from interface: FrameUpdateListener

Diese Methode wird bei einem (angemeldeten) Objekt bei jedem Einzelbild erneut aufgerufen.

Specified by:

onFrameUpdate in interface FrameUpdateListener

Parameters:

pastTime - Die Zeit in Sekunden, die seit der letzten Aktualisierung vergangen ist.

render

public void render(Graphics2D g,
 double pixelPerMeter)

Zeichnet die Figur an der Position (0|0) mit der Rotation 0.

Specified by:

render in class Actor

Parameters:

g - Das Graphics2D-Objekt, in das gezeichnet werden soll.

pixelPerMeter - Gibt an, wie viele Pixel ein Meter misst.

createFromSpritesheet

@API
public static Animation createFromSpritesheet(double frameDuration,
 String filepath,
 int x,
 int y,
 double width,
 double height)

createFromImages

@API
public static Animation createFromImages(double frameDuration,
 double width,
 double height,
 String... filepaths)

createFromImagesPrefix

@API
public static Animation createFromImagesPrefix(double frameDuration,
 double width,
 double height,
 String directoryPath,
 String prefix)

Lädt alle Bilddateien mit einem bestimmten Präfix in einem bestimmten Verzeichnis in eine Animation.

Parameters:

frameDuration - Die Dauer (ms), die ein Frame aktiv bleibt.

directoryPath - Der Pfad zum Verzeichnis, in dem die einzuladenden Bilder liegen.

prefix - Das Pfad-Präfix. Diese Funktion sucht alle Dateien mit dem gegebenen Präfix (im angegebenen Ordner) und fügt sie in aufsteigender Reihenfolge der Animation hinzu.

Returns:

Eine Animation aus allen Dateien, die mit dem Pfadpräfix beginnen.

createFromAnimatedGif

@API
public static Animation createFromAnimatedGif(String filepath,
 double width,
 double height)