A scene in the game. More...

#include <gf/Scene.h>

Public Member Functions
	Scene (Vector2i initialSize)
	Constructor. More...

virtual	~Scene ()
	Destructor. More...

Game loop
void	processEvent (Event &event)
	Process an event. More...

void	handleActions (Window &window)
	Handle actions. More...

void	update (Time time)
	Update the scene. More...

void	render (RenderTarget &target, const RenderStates &states=RenderStates())
	Render the scene. More...

void	setFramebufferSize (gf::Vector2i size)
	Update the framebuffer size. More...

void	setClearColor (gf::Color4f color)
	Set the new clear color. More...

gf::Color4f	getClearColor () const
	Get the current clear color. More...

Scene properties
void	setActive (bool active=true)
	Change the active state of the scene. More...

bool	isActive () const
	Check if the scene is active. More...

void	pause ()
	Pause the scene. More...

void	resume ()
	Resume the scene. More...

bool	isPaused () const
	Check if the scene is paused. More...

void	hide ()
	Hide the scene. More...

void	show ()
	Show the scene. More...

bool	isHidden () const
	Check if the scene is hidden. More...

Scene content
void	addView (AdaptativeView &view)
	Add a view to the scene. More...

void	addAction (Action &action)
	Add an action to the scene. More...

void	addModel (Model &model)
	Add a model to the scene. More...

void	addWorldEntity (Entity &entity)
	Add a world entity to the scene. More...

Entity *	removeWorldEntity (Entity *entity)
	Remove a world entity from the scene. More...

void	addHudEntity (Entity &entity)
	Add a HUD entity to the scene. More...

Entity *	removeHudEntity (Entity *entity)
	Remove a HUD entity from the scene. More...

World view management
void	setWorldViewCenter (Vector2f center)
	Set the center of the world view. More...

void	setWorldViewSize (Vector2f size)
	Set the size of the world view. More...

Protected Member Functions
void	renderWorldEntities (RenderTarget &target, const RenderStates &states)
	Render the world entities. More...

void	renderHudEntities (RenderTarget &target, const RenderStates &states)
	Render the HUD entities. More...

View &	getWorldView ()
	Get the world view. More...

View &	getHudView ()
	Get the HUD view. More...

virtual bool	doEarlyProcessEvent (Event &event)
	Customization point for processEvent() More...

virtual void	doProcessEvent (Event &event)
	Customization point for processEvent() More...

virtual void	doHandleActions (Window &window)
	Customization point for handleActions() More...

virtual void	doUpdate (Time time)
	Customization point for update() More...

virtual void	doRender (RenderTarget &target, const RenderStates &states)
	Customization point for render() More...

virtual void	doPause ()
	Customization point for pause() More...

virtual void	doResume ()
	Customization point for resume() More...

virtual void	doHide ()
	Customization point for hide() More...

virtual void	doShow ()
	Customization point for show() More...

virtual void	onActivityChange (bool active)
	Callback when the scene becomes active or inactive. More...

Detailed Description

A scene in the game.

A scene is a set of entities that are handled together in the game. A scene is associated with a set of user actions. A scene is responsible for handling the steps of a game: handling the input (and the actions), updating the entities, rendering the entities.

A scene can be associated to a scene manager, with other scenes. A scene is active when it is the top scene on the stack of scenes. The scene manager is responsible for activating and desactivating the scenes.

A scene can be either paused or resumed. A paused scene is not updated. In other words, the update step is discarded. It is the user's responsability to pause or resume a scene. An active scene is always resumed when becoming active.

A scene can be either hidden or shown. A hidden scene is not rendererd. In other words, the render step is discarded. It is the user's responsability to hide or show a scene. An active scene is always shown when becoming active.

See also: gf::SceneManager

Constructor & Destructor Documentation

◆ Scene()

gf::Scene::Scene ( Vector2i initialSize )

Constructor.

At construction, a scene is paused, hidden and inactive.

Parameters

initialSize The initial screen size

See also: gf::ViewContainer::setInitialScreenSize()

◆ ~Scene()

virtual gf::Scene::~Scene ( )

virtual

Destructor.

Member Function Documentation

◆ addAction()

void gf::Scene::addAction ( Action & action )

inline

Add an action to the scene.

Parameters

action The action

◆ addHudEntity()

void gf::Scene::addHudEntity ( Entity & entity )

inline

Add a HUD entity to the scene.

Parameters

entity The entity

◆ addModel()

void gf::Scene::addModel ( Model & model )

inline

Add a model to the scene.

Parameters

model The model

◆ addView()

void gf::Scene::addView ( AdaptativeView & view )

inline

Add a view to the scene.

Parameters

view	A custom view

◆ addWorldEntity()

void gf::Scene::addWorldEntity ( Entity & entity )

inline

Add a world entity to the scene.

Parameters

entity The entity

◆ doEarlyProcessEvent()

virtual bool gf::Scene::doEarlyProcessEvent ( Event & event )

protectedvirtual

Customization point for processEvent()

Returns: True if the event should not be passed to the other actions

◆ doHandleActions()

virtual void gf::Scene::doHandleActions ( Window & window )

protectedvirtual

Customization point for handleActions()

◆ doHide()

virtual void gf::Scene::doHide ( )

protectedvirtual

Customization point for hide()

◆ doPause()

virtual void gf::Scene::doPause ( )

protectedvirtual

Customization point for pause()

◆ doProcessEvent()

virtual void gf::Scene::doProcessEvent ( Event & event )

protectedvirtual

Customization point for processEvent()

◆ doRender()

virtual void gf::Scene::doRender	(	RenderTarget &	target,
		const RenderStates &	states
	)

protectedvirtual

Customization point for render()

◆ doResume()

virtual void gf::Scene::doResume ( )

protectedvirtual

Customization point for resume()

◆ doShow()

virtual void gf::Scene::doShow ( )

protectedvirtual

Customization point for show()

◆ doUpdate()

virtual void gf::Scene::doUpdate ( Time time )

protectedvirtual

Customization point for update()

◆ getClearColor()

gf::Color4f gf::Scene::getClearColor ( ) const

inline

Get the current clear color.

Returns: The current clear color

See also: setClearColor();

◆ getHudView()

View& gf::Scene::getHudView ( )

inlineprotected

Get the HUD view.

◆ getWorldView()

View& gf::Scene::getWorldView ( )

inlineprotected

Get the world view.

◆ handleActions()

void gf::Scene::handleActions ( Window & window )

Handle actions.

This function must be customized with doHandleActions() in order to handle the actions that have been updated with the event processing.

At the end of this function, all the actions are resetted.

Parameters

window The current window

See also: gf::ActionContainer::reset()

◆ hide()

void gf::Scene::hide ( )

Hide the scene.

When a scene is hidden, the entities are not rendered.

See also: show(), isHidden()

◆ isActive()

bool gf::Scene::isActive ( ) const

Check if the scene is active.

Returns: True if the scene is active, and false otherwise

See also: setActive()

◆ isHidden()

bool gf::Scene::isHidden ( ) const

Check if the scene is hidden.

Returns: True if the scene is hidden

See also: hide(), show()

◆ isPaused()

bool gf::Scene::isPaused ( ) const

Check if the scene is paused.

Returns: True if the scene is paused, and false otherwise

See also: pause(), resume()

◆ onActivityChange()

virtual void gf::Scene::onActivityChange ( bool active )

protectedvirtual

Callback when the scene becomes active or inactive.

Parameters

active The new status of the scene

◆ pause()

void gf::Scene::pause ( )

Pause the scene.

When a scene is paused, the entities are not updated.

See also: resume(), isPaused()

◆ processEvent()

void gf::Scene::processEvent ( Event & event )

Process an event.

All the registered views and actions are updated with the event.

This function can be customized with doProcessEvent() that is called after all other event processing.

Parameters

event The event

See also: gf::ActionContainer::processEvent(), gf::ViewContainer::processEvent()

◆ removeHudEntity()

Entity* gf::Scene::removeHudEntity ( Entity * entity )

inline

Remove a HUD entity from the scene.

Parameters

entity The entity

◆ removeWorldEntity()

Entity* gf::Scene::removeWorldEntity ( Entity * entity )

inline

Remove a world entity from the scene.

Parameters

entity The entity

◆ render()

void gf::Scene::render	(	RenderTarget &	target,
		const RenderStates &	states = `RenderStates()`
	)

Render the scene.

This function render all the entities of the scene, if the scene is not hidden. It can be customized with doRender().

By default, it first renders the world entities (with a gf::ExtendView) through a call to renderWorldEntities() and then it renders the HUD entities (with a gf::ScreenView) through a call to renderHudEntities().

Parameters

target	The target to render the scene
states	The render states to use for drawing

See also: gf::EntityContainer::render()

◆ renderHudEntities()

void gf::Scene::renderHudEntities	(	RenderTarget &	target,
		const RenderStates &	states
	)

protected

Render the HUD entities.

◆ renderWorldEntities()

void gf::Scene::renderWorldEntities	(	RenderTarget &	target,
		const RenderStates &	states
	)

protected

Render the world entities.

◆ resume()

void gf::Scene::resume ( )

Resume the scene.

See also: pause(), isPaused()

◆ setActive()

void gf::Scene::setActive ( bool active = true )

Change the active state of the scene.

Parameters

active The new state of the scene

See also: isActive()

◆ setClearColor()

void gf::Scene::setClearColor ( gf::Color4f color )

inline

Set the new clear color.

Parameters

color The new clear color

See also: getClearColor()

◆ setFramebufferSize()

void gf::Scene::setFramebufferSize ( gf::Vector2i size )

Update the framebuffer size.

This function is called to update the views in the scene.

Parameters

size	The new size of the framebuffer

◆ setWorldViewCenter()

void gf::Scene::setWorldViewCenter ( Vector2f center )

Set the center of the world view.

Parameters

center The new center

◆ setWorldViewSize()

void gf::Scene::setWorldViewSize ( Vector2f size )

Set the size of the world view.

Parameters

size	The new size

◆ show()

void gf::Scene::show ( )

Show the scene.

See also: hide(), isHidden()

◆ update()

void gf::Scene::update ( Time time )

Update the scene.

This function updates all the models and entities of the scene, if the scene is not paused. It can be customized with doUpdate() that is called after all other updates.

Parameters

time	The time since the last frame

See also: gf::ModelContainer::update(), gf::EntityContainer::update()

Public Member Functions

Protected Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ Scene()

◆ ~Scene()

Member Function Documentation

◆ addAction()

◆ addHudEntity()

◆ addModel()

◆ addView()

◆ addWorldEntity()

◆ doEarlyProcessEvent()

◆ doHandleActions()

◆ doHide()

◆ doPause()

◆ doProcessEvent()

◆ doRender()

◆ doResume()

◆ doShow()

◆ doUpdate()

◆ getClearColor()

◆ getHudView()

◆ getWorldView()

◆ handleActions()

◆ hide()

◆ isActive()

◆ isHidden()

◆ isPaused()

◆ onActivityChange()

◆ pause()

◆ processEvent()

◆ removeHudEntity()

◆ removeWorldEntity()

◆ render()

◆ renderHudEntities()

◆ renderWorldEntities()

◆ resume()

◆ setActive()

◆ setClearColor()

◆ setFramebufferSize()

◆ setWorldViewCenter()

◆ setWorldViewSize()

◆ show()

◆ update()