Package pi.actor

Class Image

java.lang.Object

pi.actor.Actor

pi.actor.Image

All Implemented Interfaces:

FrameUpdateListenerRegistration, KeyStrokeListenerRegistration, MouseClickListenerRegistration, MouseScrollListenerRegistration

Direct Known Subclasses:

Image, ImageFontText

public class Image
extends Actor

Ein Bild als grafische Repräsentation einer Bilddatei, die gezeichnet werden kann.

Author:

Michael Andonie, Josef Friedrich

Field Summary

Fields inherited from class pi.actor.Actor

color, physics

Constructor Summary

Constructors

Constructor	Description
Image(BufferedImage image)	Erzeugt ein Bild durch Angabe eines bereits im Speicher vorhandenen Bilds vom Datentyp BufferedImage.
Image(String image)	Erzeugt ein Bild durch Angabe des Verzeichnispfads.

Method Summary

Modifier and Type	Method	Description
double	aspectRatio()	Berechnet das Seitenverhältnis des Bildes.
boolean	flippedHorizontally()	Gibt an, ob das Bild horizontal gespiegelt, das heißt an der verticalen Achse gespiegelt ist.
Image	flippedHorizontally(boolean flippedHorizontally)	Setzt, ob dieses Bild horizontal gespiegelt werden soll.
boolean	flippedVertically()	Gibt an, ob das Bild vertikal gespiegelt ist, das heißt an der horizontaler Achse gespiegelt ist.
Image	flippedVertically(boolean flippedVertically)	Setzt, ob das Bild vertikal gespiegelt werden sollen.
double	height()	Gibt die Höhe des Bilds in Meter.
Image	height(double height)	Setzt die Höhe des Bilds in Meter.
BufferedImage	image()	Gibt das BufferedImage, das dieses Bild darstellt.
Image	image(BufferedImage image)	Setzt oder ersetzt das Bild.
Image	image(String image)	Setzt oder ersetzt das Bild.
double	pixelPerMeter()	Gibt den Umrechnungsfaktor von Pixel zu Meter zurück.
Image	pixelPerMeter(double pixelPerMeter)	Setzt den Umrechnungsfaktor von Pixel zu Meter.
Image	reset()	Setzt alle Bildeinstellungen auf ihre Standardwerte zurück.
Image	size(double width, double height)	Setzt die Größe des Bildes innerhalb der Physik neu.
boolean	toggleFlipHorizontally()	Spiegelt das Bild in horizontaler Richtung.
boolean	toggleFlipVertically()	Spiegelt das Bild in vertikaler Richtung.
double	width()	Gibt die Breite des Bilds in Meter.
Image	width(double width)	Setzt die Breite des Bilds in Meter.

Methods inherited from class pi.actor.Actor

addCollisionListener, addCollisionListener, addCollisionListener, addMountListener, addUnmountListener, anchor, anchor, anchor, anchorformatted, angularDamping, angularDamping, angularVelocity, angularVelocity, animateColor, animateOpacity, animateParticle, applyForce, applyForce, applyForce, applyImpulse, applyImpulse, applyImpulse, applyRotationImpulse, applyTorque, awake, bodyType, bodyType, center, center, center, centerRelative, collisions, color, color, color, complementaryColor, contains, createDistanceJoint, createPrismaticJoint, createRevoluteJoint, createRopeJoint, createWeldJoint, density, density, fixture, fixtures, fixtures, frameUpdateListeners, friction, friction, gravityScale, gravityScale, hide, isGrounded, isMounted, isRotationLocked, isVisible, keyStrokeListeners, layer, layerPosition, layerPosition, linearDamping, linearDamping, listenerBundle, lockRotation, makeDynamic, makeKinematic, makeParticle, makeSensor, makeStatic, mass, mouseClickListeners, mouseScrollListeners, moveBy, moveBy, opacity, opacity, overlaps, remove, removeMountListener, removeUnmountListener, resetMovement, restitution, restitution, rotateBy, rotation, rotation, rotationLocked, show, sleep, toggleVisible, toStringFormatter, velocity, velocity, visible, x, x, y, y

Methods inherited from class java.lang.Object

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

Methods inherited from interface pi.event.FrameUpdateListenerRegistration

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

Methods inherited from interface pi.event.KeyStrokeListenerRegistration

addKeyStrokeListener, removeKeyStrokeListener

Methods inherited from interface pi.event.MouseClickListenerRegistration

addMouseClickListener, removeMouseClickListener

Methods inherited from interface pi.event.MouseScrollListenerRegistration

addMouseScrollListener, removeMouseScrollListener

Constructor Details

Image

@API
public Image(String image)

Erzeugt ein Bild durch Angabe des Verzeichnispfads.

Parameters:

image - Der Verzeichnispfad des Bilds, das geladen werden soll.

Image

@API
public Image(BufferedImage image)

Erzeugt ein Bild durch Angabe eines bereits im Speicher vorhandenen Bilds vom Datentyp BufferedImage.

Parameters:

image - Ein bereits im Speicher vorhandenes Bild vom Datentyp BufferedImage.

Method Details

image

@API
@Getter
public BufferedImage image()

Gibt das BufferedImage, das dieses Bild darstellt.

Returns:

Das BufferedImage, das dieses Bild darstellt.

image

@API
@Setter
@ChainableMethod
public Image image(BufferedImage image)

Setzt oder ersetzt das Bild.

Parameters:

image - Ein bereits im Speicher vorhandenes Bild vom Datentyp BufferedImage.

image

@API
@Setter
@ChainableMethod
public Image image(String image)

Setzt oder ersetzt das Bild.

Parameters:

image - Der Verzeichnispfad des Bildes, das geladen werden soll.

width

@API
@Getter
public double width()

Gibt die Breite des Bilds in Meter.

Returns:

Die Breite des Bilds in Meter.

width

@API
@Setter
@ChainableMethod
public Image width(double width)

Setzt die Breite des Bilds in Meter.

Der vorher durch die Methode pixelPerMeter(double) gesetzte Umrechnungsfaktor von Pixel zu Meter wird durch diese Methode zurückgesetzt und ist somit unwirksam.

Parameters:

width - Die Breite des Bilds in Meter.

height

@API
@Getter
public double height()

Gibt die Höhe des Bilds in Meter.

Returns:

Die Höhe des Bilds in Meter.

height

@API
@Setter
@ChainableMethod
public Image height(double height)

Setzt die Höhe des Bilds in Meter.

Der vorher durch die Methode pixelPerMeter(double) gesetzte Umrechnungsfaktor von Pixel zu Meter wird durch diese Methode zurückgesetzt und ist somit unwirksam.

Parameters:

height - Die Höhe des Bilds in Meter.

pixelPerMeter

@API
@Getter
public double pixelPerMeter()

Gibt den Umrechnungsfaktor von Pixel zu Meter zurück.

Ist der Umrechnungsfaktor bisher noch nicht gesetzt worden, wird der konfigurierte Wert GraphicsConfig.pixelPerMeter() verwenden.

Returns:

pixelPerMeter

@API
@Setter
@ChainableMethod
public Image pixelPerMeter(double pixelPerMeter)

Setzt den Umrechnungsfaktor von Pixel zu Meter. Wenn das Bild beispielsweise 300 Pixel breit und 200 Pixel hoch ist und der Umrechnungsfaktor 100 Pixel pro Meter beträgt, wird es mit einer Größe von 3 x 2 Metern dargestellt.

Die Größe des Bildobjekts wird so geändert, dass sie dem angegebenen Umrechnungsfaktor entspricht. Dies hat auch Auswirkungen auf die physikalischen Eigenschaften des Bildes.

Die vorher durch die Methoden width(double) height(double) oder size(double, double) gesetzte Breite und Höhe des Bilds werden durch diese Methode zurückgesetzt und sind somit unwirksam.

Parameters:

pixelPerMeter - Wie viele Pixel ein Meter misst.

flippedHorizontally

@API
@Getter
public boolean flippedHorizontally()

Gibt an, ob das Bild horizontal gespiegelt, das heißt an der verticalen Achse gespiegelt ist.

Returns:

true, wenn das Objekt gerade horizontal gespiegelt ist. Sonst false.

flippedHorizontally

@API
@Setter
@ChainableMethod
public Image flippedHorizontally(boolean flippedHorizontally)

Setzt, ob dieses Bild horizontal gespiegelt werden soll.

Hiermit lassen sich zum Beispiel Bewegungsrichtungen (links/rechts) einfach umsetzen.

Parameters:

flippedHorizontally - Ob das Bild horizontal gespiegelt dargestellt werden soll.

See Also:

• flippedVertically(boolean)

toggleFlipHorizontally

@API
public boolean toggleFlipHorizontally()

Spiegelt das Bild in horizontaler Richtung.

Es wird an der vertikalen Achse gespiegelt.

Returns:

Wahr, wenn es horizontale gespiegelt wurde, falsch, wenn es im Originalzustand angezeigt wird.

Since:

0.24.0

flippedVertically

@API
@Getter
public boolean flippedVertically()

Gibt an, ob das Bild vertikal gespiegelt ist, das heißt an der horizontaler Achse gespiegelt ist.

Returns:

true, wenn das Objekt gerade vertikal gekippt ist. Sonst false.

flippedVertically

@API
@Setter
@ChainableMethod
public Image flippedVertically(boolean flippedVertically)

Setzt, ob das Bild vertikal gespiegelt werden sollen.

Parameters:

flippedVertically - Ob die Animation horizontal geflippt dargestellt werden soll.

See Also:

• flippedVertically(boolean)

toggleFlipVertically

@API
public boolean toggleFlipVertically()

Spiegelt das Bild in vertikaler Richtung.

Es wird an der horizontaler Achse gespiegelt.

Returns:

Wahr, wenn es in horizontaler Richtung gekippt wurde, falsch, wenn es im Originalzustand angezeigt wird.

Since:

0.24.0

size

@API
@Setter
@ChainableMethod
public Image size(double width,
 double height)

Setzt die Größe des Bildes innerhalb der Physik neu.

Ändert die physikalischen Eigenschaften. Das Bild füllt die neuen Maße und wird ggf. verzerrt.

Entsprechen die Eingabeparameter für Breite und Höhe nicht den Abmessungen des Bildes, dann wird das Bild verzerrt dargestellt.

*

Der vorher durch die Methode pixelPerMeter(double) gesetzte Umrechnungsfaktor von Pixel zu Meter wird durch diese Methode zurückgesetzt und ist somit unwirksam.

Parameters:

width - Die neue Breite des Bilds in Meter.

height - Die neue Höhe des Bild in Meter.

See Also:

• pixelPerMeter(double)

aspectRatio

@API
public double aspectRatio()

Berechnet das Seitenverhältnis des Bildes.

Returns:

Das Seitenverhältnis als Quotient von Breite und Höhe

Throws:

IllegalArgumentException - wenn die Breite oder Höhe kleiner oder gleich 0 ist

reset

@API
@ChainableMethod
public Image reset()

Setzt alle Bildeinstellungen auf ihre Standardwerte zurück.