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, FrameUpdateListenerContainer, KeyListenerContainer, MouseClickListenerContainer, MouseWheelListenerContainer

@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

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 deltaSeconds)	Diese Methode wird bei einem (angemeldeten) Objekt bei jeden Einzelbild erneut aufgerufen.
void	render(Graphics2D g, double pixelPerMeter)	Rendert das Objekt am Ursprung.

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, contains, createDistanceJoint, createPrismaticJoint, createRevoluteJoint, createRopeJoint, createWeldJoint, getAngularDamping, getAngularVelocity, getBodyType, getCenter, getCenterRelative, getCollisions, getDensity, getElasticity, getFrameUpdateListeners, getFriction, getGravityScale, getKeyListeners, getLayer, getLayerPosition, getLinearDamping, getMass, getMouseClickListeners, getMouseWheelListeners, getOpacity, getPhysicsHandler, getPosition, 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, setDensity, setElasticity, setFixture, setFixtures, setFixtures, setFriction, setGravityScale, setLayerPosition, setLinearDamping, setOpacity, setPhysicsHandler, setPosition, setPosition, setRotation, setRotationLocked, setVelocity, setVisible, setX, setY

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.FrameUpdateListenerContainer

addFrameUpdateListener, defer, delay, removeFrameUpdateListener, repeat

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

addKeyListener, removeKeyListener

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

addMouseClickListener, removeMouseClickListener

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

addMouseWheelListener, removeMouseWheelListener

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 deltaSeconds)

Description copied from interface: FrameUpdateListener

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

Specified by:

onFrameUpdate in interface FrameUpdateListener

Parameters:

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

render

public void render(Graphics2D g,
 double pixelPerMeter)

Description copied from class: Actor

Rendert das Objekt am Ursprung.

• Die Position ist (0|0).
• Die Roation ist 0.

Specified by:

render in class Actor

Parameters:

g - Das zeichnende Graphics-Objekt

pixelPerMeter - Pixel pro Meter.

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)