Package de.pirckheimer_gymnasium.engine_pi

Class Scene

java.lang.Object

de.pirckheimer_gymnasium.engine_pi.Scene

All Implemented Interfaces:

ActorAdder, FrameUpdateListenerRegistration, KeyStrokeListenerRegistration, MouseClickListenerRegistration, MouseScrollListenerRegistration

Direct Known Subclasses:

MainAnimation

public class Scene
extends Object
implements KeyStrokeListenerRegistration, MouseClickListenerRegistration, MouseScrollListenerRegistration, FrameUpdateListenerRegistration, ActorAdder

Mithilfe von Szenen können verschiedene Ansichten eines Spiels erstellt werden, ohne beim Szenenwechsel alle grafischen Objekte entfernen und wieder neu erzeugen zu müssen.

Constructor Summary

Constructors

Constructor	Description
Scene()

Method Summary

Modifier and Type	Method	Description
final void	add(Actor... actors)	Fügt einen oder mehrere Actor-Objekte der Szene hinzu.
final void	addLayer(Layer layer)
Color	getBackgroundColor()	Gibt die Hintergrundfarbe zurück.
final Camera	getCamera()
EventListeners<FrameUpdateListener>	getFrameUpdateListeners()
Vector	getGravity()	Gibt die Schwerkraft, die momentan auf die Hauptebene wirkt, als Vektor in [N] bzw.
EventListeners<KeyStrokeListener>	getKeyStrokeListeners()
Layer	getMainLayer()	Gibt die Hauptebene dieser Szene aus.
EventListeners<MouseClickListener>	getMouseClickListeners()
final Vector	getMousePosition()	Gibt die Position der Maus in der Szene als Vektor in Meter relativ zum Koordinatensystem zurück.
EventListeners<MouseScrollListener>	getMouseScrollListeners()
Scene	getScene()
Bounds	getVisibleArea(Vector gameSizeInPixels)	Gibt die sichtbare Fläche auf dem Hauptebene aus.
final WorldHandler	getWorldHandler()	Gibt den WorldHandler der Hauptebene aus.
final void	invokeFrameUpdateListeners(double pastTime)
boolean	isPhysicsPaused()	Gibt an, ob die Physik dieser Szene pausiert ist.
final void	remove(Actor... actors)	Entferne einen oder mehrere Actor-Objekte aus der Szene.
final void	removeLayer(Layer layer)
final void	render(Graphics2D g, int width, int height)
void	setBackgroundColor(Color color)	Setzt die Hintergrundfarbe.
void	setBackgroundColor(String color)	Setzt die Hintergrundfarbe als Zeichenkette.
void	setGravity(double gravityX, double gravityY)	Setzt die Schwerkraft durch zwei Eingabeparameter für die x- und y-Richtung, die auf alle Objekte innerhalb der Hauptebene der Szene wirkt.
void	setGravity(Vector gravity)	Setzt die Schwerkraft als Vektor, die auf alle Objekte innerhalb der Hauptebene der Szene wirkt.
void	setGravityOfEarth()	Setzt die Schwerkraft, die auf der Erde wirkt: 9.81 [N] bzw.
void	setPhysicsPaused(boolean worldPaused)	Setzt, ob die Engine-Physics für diese Szene pausiert sein soll.
final void	step(double pastTime, Function<Runnable,Future<?>> invoker)	Führt auf allen Ebenen parallelisiert den World-Step aus.

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.actor.ActorAdder

addCircle, addCircle, addCircle, addCircle, addCircle, addHexagon, addHexagon, addHexagon, addHexagon, addHexagon, addImage, addImage, addPentagon, addPentagon, addPentagon, addRectangle, addRectangle, addRectangle, addRegularPolygon, addRegularPolygon, addRegularPolygon, addRegularPolygon, addText, addText, addText, addText, addTriangle, addTriangle, addTriangle, addTriangle, addTriangle

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

Scene

public Scene()

Method Details

getScene

public Scene getScene()

Specified by:

getScene in interface ActorAdder

getMainLayer

@API
public Layer getMainLayer()

Gibt die Hauptebene dieser Szene aus.

Returns:

Die Hauptebene dieser Szene.

step

@Internal
public final void step(double pastTime,
 Function<Runnable,Future<?>> invoker)
                throws InterruptedException

Führt auf allen Ebenen parallelisiert den World-Step aus.

Parameters:

pastTime - Die Echtzeit, die seit dem letzten World-Step vergangen ist.

Throws:

InterruptedException

render

@Internal
public final void render(Graphics2D g,
 int width,
 int height)

addLayer

@API
public final void addLayer(Layer layer)

removeLayer

@API
public final void removeLayer(Layer layer)

getVisibleArea

@API
public Bounds getVisibleArea(Vector gameSizeInPixels)

Gibt die sichtbare Fläche auf dem Hauptebene aus.

Returns:

Die sichtbare Fläche auf der Hauptebene

See Also:

• Game.getWindowSize()

getCamera

@API
public final Camera getCamera()

getWorldHandler

@Internal
public final WorldHandler getWorldHandler()

Gibt den WorldHandler der Hauptebene aus.

Returns:

WorldHandler der Hauptebene.

getGravity

public Vector getGravity()

Gibt die Schwerkraft, die momentan auf die Hauptebene wirkt, als Vektor in [N] bzw. [m/s^2] zurück.

Returns:

Die Schwerkraft, die momentan auf die Hauptebene wirkt, als Vektor in [N] bzw. [m/s^2].

setGravity

@API
public void setGravity(Vector gravity)

Setzt die Schwerkraft als Vektor, die auf alle Objekte innerhalb der Hauptebene der Szene wirkt.

Parameters:

gravity - Die neue Schwerkraft als Vector. Die Einheit ist [N].

See Also:

• setGravity(double, double)
• Layer.setGravity(Vector)
• Layer.setGravity(double, double)

jbox2d source code:

dynamics/World.java#L997-L1004

box2d source code:

b2_world.h#L312-L315

setGravity

@API
public void setGravity(double gravityX,
 double gravityY)

Setzt die Schwerkraft durch zwei Eingabeparameter für die x- und y-Richtung, die auf alle Objekte innerhalb der Hauptebene der Szene wirkt.

Parameters:

gravityX - Die neue Schwerkraft, die in X-Richtung wirken soll. Die Einheit ist [N].

gravityY - Die neue Schwerkraft, die in Y-Richtung wirken soll. Die Einheit ist [N].

See Also:

• setGravity(Vector)
• Layer.setGravity(Vector)
• Layer.setGravity(double, double)

jbox2d source code:

dynamics/World.java#L997-L1004

box2d source code:

b2_world.h#L312-L315

setGravityOfEarth

@API
public void setGravityOfEarth()

Setzt die Schwerkraft, die auf der Erde wirkt: 9.81 [N] bzw. [m/s^2] nach unten (x: 0, y: -9.81).

See Also:

• Layer.setGravityOfEarth()

setPhysicsPaused

@API
public void setPhysicsPaused(boolean worldPaused)

Setzt, ob die Engine-Physics für diese Szene pausiert sein soll.

Parameters:

worldPaused - false: Die Engine-Physik läuft normal. true: Die Engine-Physik läuft nicht. Das bedeutet u.A. keine Collision-Detection, keine Physik-Simulation etc., bis die Physik wieder mit setPhysicsPaused(true) aktiviert wird.

See Also:

• isPhysicsPaused()

isPhysicsPaused

@API
public boolean isPhysicsPaused()

Gibt an, ob die Physik dieser Szene pausiert ist.

Returns:

true: Die Physik ist pausiert. false: Die Physik ist nicht pausiert.

See Also:

• setPhysicsPaused(boolean)

add

@API
public final void add(Actor... actors)

Fügt einen oder mehrere Actor-Objekte der Szene hinzu.

Parameters:

actors - Ein oder mehrere Actor-Objekte.

remove

@API
public final void remove(Actor... actors)

Entferne einen oder mehrere Actor-Objekte aus der Szene.

Parameters:

actors - Ein oder mehrere Actor-Objekte.

getKeyStrokeListeners

@API
public EventListeners<KeyStrokeListener> getKeyStrokeListeners()

Specified by:

getKeyStrokeListeners in interface KeyStrokeListenerRegistration

getMouseClickListeners

@API
public EventListeners<MouseClickListener> getMouseClickListeners()

Specified by:

getMouseClickListeners in interface MouseClickListenerRegistration

getMouseScrollListeners

@API
public EventListeners<MouseScrollListener> getMouseScrollListeners()

Specified by:

getMouseScrollListeners in interface MouseScrollListenerRegistration

getFrameUpdateListeners

@API
public EventListeners<FrameUpdateListener> getFrameUpdateListeners()

Specified by:

getFrameUpdateListeners in interface FrameUpdateListenerRegistration

Returns:

Liste der FrameUpdateListener

invokeFrameUpdateListeners

@Internal
public final void invokeFrameUpdateListeners(double pastTime)

getMousePosition

@API
public final Vector getMousePosition()

Gibt die Position der Maus in der Szene als Vektor in Meter relativ zum Koordinatensystem zurück.

Der Positions-Vektor ist in der Einheit Meter angegeben und bezieht sich auf einen Punkt des zu Grunde liegenden Koordinatensystems.

Returns:

Die Position der Maus in der Szene als Vektor in Meter.

See Also:

• Game.getMousePosition()

getBackgroundColor

public Color getBackgroundColor()

Gibt die Hintergrundfarbe zurück.

Returns:

Die Hintergrundfarbe.

setBackgroundColor

public void setBackgroundColor(Color color)

Setzt die Hintergrundfarbe.

Parameters:

color - Die Hintergrundfarbe.

setBackgroundColor

public void setBackgroundColor(String color)

Setzt die Hintergrundfarbe als Zeichenkette.

Parameters:

color - Ein Farbname, ein Farbalias (siehe Auflistung) oder eine Farbe in hexadezimaler Codierung (z. B. #ff0000).

See Also:

• ColorContainer.get(String)