Package de.pirckheimer_gymnasium.engine_pi

Class Scene

java.lang.Object

de.pirckheimer_gymnasium.engine_pi.Scene

All Implemented Interfaces:

ActorCreator, FrameUpdateListenerRegistration, KeyStrokeListenerRegistration, MouseClickListenerRegistration, MouseScrollListenerRegistration

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

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()
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 deltaSeconds)
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 deltaSeconds, 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.ActorCreator

createCircle, createCircle, createCircle, createCircle, createHexagon, createHexagon, createHexagon, createHexagon, createHexagon, createImage, createImage, createPentagon, createPentagon, createPentagon, createRectangle, createRectangle, createRectangle, createRegularPolygon, createRegularPolygon, createRegularPolygon, createRegularPolygon, createText, createText, createText, createText, createTriangle, createTriangle, createTriangle, createTriangle

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

addFrameUpdateListener, defer, delay, removeFrameUpdateListener, 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 ActorCreator

getMainLayer

@API
public Layer getMainLayer()

Gibt die Hauptebene dieser Szene aus.

Returns:

Die Hauptebene dieser Szene.

step

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

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

Parameters:

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

getMousePosition

@API
public final Vector 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)