Layers and cameras Reference

Each scene can be composed of multiple layers. These conditions and actions allow to manipulate them during the game. In particular, you can move the camera of a layer to center it on an object or a position. Read more explanations about it.

Actions

Center the camera on an object
Center the camera on the specified object.

See parameters

• Parameter 1: 👾 Object
• Parameter 2 (❓ Yes or No): Anticipate the movement of the object (yes by default)
• Parameter 3: 🔤 Layer name (String)
• Parameter 4 (🔢 Number): Camera number

Technical note: parameter 0 are internal parameters handled by GDevelop.

Layer time scale
Change the time scale applied to the objects of the layer.

See parameters

• Parameter 1: 🔤 Layer name (String)
• Parameter 2 (🔢 Number): Scale (1: Default, 2: 2x faster, 0.5: 2x slower...)

Technical note: parameter 0 are internal parameters handled by GDevelop.

Enforce camera boundaries
Enforce camera boundaries by moving the camera back inside specified boundaries.

See parameters

• Parameter 1 (🔢 Number): Left bound X Position
• Parameter 2 (🔢 Number): Top bound Y Position
• Parameter 3 (🔢 Number): Right bound X Position
• Parameter 4 (🔢 Number): Bottom bound Y Position
• Parameter 5: 🔤 Layer name (String)
• Parameter 6 (🔢 Number): Camera number

Technical note: parameter 0 are internal parameters handled by GDevelop.

Enable layer effect
Enable an effect on a layer

See parameters

• Parameter 1: 🔤 Layer name (String)
• Parameter 2: 🔤 Layer Effect Name (String)
• Parameter 3 (❓ Yes or No): Enable

Technical note: parameter 0 are internal parameters handled by GDevelop.

Hide a layer
Hide a layer.

See parameters

• Parameter 1: 🔤 Layer name (String)

Technical note: parameter 0 are internal parameters handled by GDevelop.

Angle of a camera of a layer
Change the angle of rotation of a camera (in degrees).

See parameters

• Parameter 1: 🟰 Operator
• Parameter 2 (🔢 Number): Value
• Parameter 3: 🔤 Layer name (String)
• Parameter 4 (🔢 Number): Camera number

Technical note: parameter 0 are internal parameters handled by GDevelop.

Camera center X position
Change the X position of the center of a camera.

See parameters

• Parameter 1: 🟰 Operator
• Parameter 2 (🔢 Number): Value
• Parameter 3: 🔤 Layer name (String)
• Parameter 4 (🔢 Number): Camera number

Technical note: parameter 0 are internal parameters handled by GDevelop.

Camera center Y position
Change the Y position of the center of a camera.

See parameters

• Parameter 1: 🟰 Operator
• Parameter 2 (🔢 Number): Value
• Parameter 3: 🔤 Layer name (String)
• Parameter 4 (🔢 Number): Camera number

Technical note: parameter 0 are internal parameters handled by GDevelop.

Ambient light color
Set the ambient light color of the lighting layer in format "R;G;B" string.

See parameters

• Parameter 1: 🔤 Layer name (String)
• Parameter 2: color

Technical note: parameter 0 are internal parameters handled by GDevelop.

Layer default Z order
Change the default Z order set to objects when they are created on a layer.

See parameters

• Parameter 1: 🔤 Layer name (String)
• Parameter 2 (🔢 Number): New default Z order

Technical note: parameter 0 are internal parameters handled by GDevelop.

Effect property (enable or disable)
Enable or disable a property of an effect.
You can find the property names (and change the effect names) in the effects window.

See parameters

• Parameter 1: 🔤 Layer name (String)
• Parameter 2: 🔤 Layer Effect Name (String)
• Parameter 3: 🔤 Layer Effect Property Name (String)
• Parameter 4 (❓ Yes or No): Enable this property

Technical note: parameter 0 are internal parameters handled by GDevelop.

Effect property (number)
Change the value of a property of an effect.
You can find the property names (and change the effect names) in the effects window.

See parameters

• Parameter 1: 🔤 Layer name (String)
• Parameter 2: 🔤 Layer Effect Name (String)
• Parameter 3: 🔤 Layer Effect Property Name (String)
• Parameter 4 (🔢 Number): New value

Technical note: parameter 0 are internal parameters handled by GDevelop.

Effect property (string)
Change the value (string) of a property of an effect.
You can find the property names (and change the effect names) in the effects window.

See parameters

• Parameter 1: 🔤 Layer name (String)
• Parameter 2: 🔤 Layer Effect Name (String)
• Parameter 3: 🔤 Layer Effect Property Name (String)
• Parameter 4 (string): New value

Technical note: parameter 0 are internal parameters handled by GDevelop.

Show a layer
Show a layer.

See parameters

• Parameter 1: 🔤 Layer name (String)

Technical note: parameter 0 are internal parameters handled by GDevelop.

Camera zoom
Change camera zoom.

See parameters

• Parameter 1 (🔢 Number): Value (1:Initial zoom, 2:Zoom x2, 0.5:Unzoom x2...)
• Parameter 2: 🔤 Layer name (String)
• Parameter 3 (🔢 Number): Camera number

Technical note: parameter 0 are internal parameters handled by GDevelop.

Conditions

Angle of a camera of a layer
Compare the angle of rotation of a camera (in degrees).

See parameters

• Parameter 1: 🟰 Relational operator
• Parameter 2 (🔢 Number): Value to compare
• Parameter 3: 🔤 Layer name (String)
• Parameter 4 (🔢 Number): Camera number

Technical note: parameter 0 are internal parameters handled by GDevelop.

Camera bottom border position
Compare the position of the bottom border of a camera.

See parameters

• Parameter 1: 🔤 Layer name (String)
• Parameter 2 (🔢 Number): Camera number
• Parameter 3: 🟰 Relational operator
• Parameter 4 (🔢 Number): Value to compare

Technical note: parameter 0 are internal parameters handled by GDevelop.

Camera left border position
Compare the position of the left border of a camera.

See parameters

• Parameter 1: 🔤 Layer name (String)
• Parameter 2 (🔢 Number): Camera number
• Parameter 3: 🟰 Relational operator
• Parameter 4 (🔢 Number): Value to compare

Technical note: parameter 0 are internal parameters handled by GDevelop.

Camera right border position
Compare the position of the right border of a camera.

See parameters

• Parameter 1: 🔤 Layer name (String)
• Parameter 2 (🔢 Number): Camera number
• Parameter 3: 🟰 Relational operator
• Parameter 4 (🔢 Number): Value to compare

Technical note: parameter 0 are internal parameters handled by GDevelop.

Camera top border position
Compare the position of the top border of a camera.

See parameters

• Parameter 1: 🔤 Layer name (String)
• Parameter 2 (🔢 Number): Camera number
• Parameter 3: 🟰 Relational operator
• Parameter 4 (🔢 Number): Value to compare

Technical note: parameter 0 are internal parameters handled by GDevelop.

Camera center X position
Compare the X position of the center of a camera.

See parameters

• Parameter 1: 🟰 Relational operator
• Parameter 2 (🔢 Number): Value to compare
• Parameter 3: 🔤 Layer name (String)
• Parameter 4 (🔢 Number): Camera number

Technical note: parameter 0 are internal parameters handled by GDevelop.

Camera center Y position
Compare the Y position of the center of a camera.

See parameters

• Parameter 1: 🟰 Relational operator
• Parameter 2 (🔢 Number): Value to compare
• Parameter 3: 🔤 Layer name (String)
• Parameter 4 (🔢 Number): Camera number

Technical note: parameter 0 are internal parameters handled by GDevelop.

Height of a camera
Compare the height of a camera of a layer.

See parameters

• Parameter 1: 🔤 Layer name (String)
• Parameter 2 (🔢 Number): Camera number
• Parameter 3: 🟰 Relational operator
• Parameter 4 (🔢 Number): Value to compare

Technical note: parameter 0 are internal parameters handled by GDevelop.

Width of a camera
Compare the width of a camera of a layer.

See parameters

• Parameter 1: 🔤 Layer name (String)
• Parameter 2 (🔢 Number): Camera number
• Parameter 3: 🟰 Relational operator
• Parameter 4 (🔢 Number): Value to compare

Technical note: parameter 0 are internal parameters handled by GDevelop.

Camera zoom
Compare the zoom of a camera of a layer.

See parameters

• Parameter 1: 🔤 Layer name (String)
• Parameter 2 (🔢 Number): Camera number
• Parameter 3: 🟰 Relational operator
• Parameter 4 (🔢 Number): Zoom

Technical note: parameter 0 are internal parameters handled by GDevelop.

Layer default Z order
Compare the default Z order set to objects when they are created on a layer.

See parameters

• Parameter 1: 🔤 Layer name (String)
• Parameter 2: 🟰 Relational operator
• Parameter 3 (🔢 Number): Value to compare

Technical note: parameter 0 are internal parameters handled by GDevelop.

Layer effect is enabled
The effect on a layer is enabled

See parameters

• Parameter 1: 🔤 Layer name (String)
• Parameter 2: 🔤 Layer Effect Name (String)

Technical note: parameter 0 are internal parameters handled by GDevelop.

Layer time scale
Compare the time scale applied to the objects of the layer.

See parameters

• Parameter 1: 🔤 Layer name (String)
• Parameter 2: 🟰 Relational operator
• Parameter 3 (🔢 Number): Time scale (1 by default)

Technical note: parameter 0 are internal parameters handled by GDevelop.

Visibility of a layer
Test if a layer is set as visible.

See parameters

• Parameter 1: 🔤 Layer name (String)

Technical note: parameter 0 are internal parameters handled by GDevelop.

Expressions

Expression	Description
CameraAngle(layer name, number)	Return the angle of rotation of a camera (in degrees).
	🔤 Layer name (String)	Layer Optional.
	🔢 Number	Camera number (default : 0) Optional.
CameraBorderBottom(layer name, number)	Return the position of the bottom border of a camera.
	🔤 Layer name (String)	Layer Optional.
	🔢 Number	Camera number Optional.
CameraBorderLeft(layer name, number)	Return the position of the left border of a camera.
	🔤 Layer name (String)	Layer Optional.
	🔢 Number	Camera number Optional.
CameraBorderRight(layer name, number)	Return the position of the right border of a camera.
	🔤 Layer name (String)	Layer Optional.
	🔢 Number	Camera number Optional.
CameraBorderTop(layer name, number)	Return the position of the top border of a camera.
	🔤 Layer name (String)	Layer Optional.
	🔢 Number	Camera number Optional.
CameraCenterX(layer name, number)	Return the X position of the center of a camera.
	🔤 Layer name (String)	Layer Optional.
	🔢 Number	Camera number (default : 0) Optional.
CameraCenterY(layer name, number)	Return the Y position of the center of a camera.
	🔤 Layer name (String)	Layer Optional.
	🔢 Number	Camera number (default : 0) Optional.
CameraHeight(layer name, number)	Return the height of a camera of a layer.
	🔤 Layer name (String)	Layer Optional.
	🔢 Number	Camera number Optional.
CameraWidth(layer name, number)	Return the width of a camera of a layer.
	🔤 Layer name (String)	Layer Optional.
	🔢 Number	Camera number Optional.
CameraZoom(layer name, number)	Zoom of a camera of a layer
	🔤 Layer name (String)	Layer Optional.
	🔢 Number	Camera number (default : 0) Optional.
LayerDefaultZOrder(layer name)	Default Z Order for a layer
	🔤 Layer name (String)	Layer
LayerTimeScale(layer name)	Returns the time scale of the specified layer.
	🔤 Layer name (String)	Layer

---

The Layers and cameras extension is always installed in all GDevelop projects: there is no need to add it from the Project Manager.

This page is an auto-generated reference page about the Layers and cameras feature of GDevelop, the open-source, cross-platform game engine designed for everyone. Learn more about all GDevelop features here.