Shape painter Reference

An object that can be used to draw arbitrary 2D shapes on the screen using events. Read more explanations about it.

Shape painter

Allows to draw simple 2D shapes on the screen using the events.

Object actions

Arc
Draw an arc on screen. If "Close path" is set to yes, a line will be drawn between the start and end point of the arc, closing the shape.

See parameters

Parameter 0 (👾 Object): Shape Painter object
Parameter 1 (🔢 Number): X position of center
Parameter 2 (🔢 Number): Y position of center
Parameter 3 (🔢 Number): Radius (in pixels)
Parameter 4 (🔢 Number): Start angle of the arc (in degrees)
Parameter 5 (🔢 Number): End angle of the arc (in degrees)
Parameter 6 (❓ Yes or No): Anticlockwise
Parameter 7 (❓ Yes or No): Close path

Begin fill path
Begin to draw a simple one-color fill. Subsequent actions, such as "Path line" (in the Advanced category) can be used to draw. Be sure to use "End fill path" action when you're done drawing the shape.

See parameters

Parameter 0 (👾 Object): Shape Painter object
Parameter 1 (🔢 Number): Start drawing x
Parameter 2 (🔢 Number): Start drawing y

Bezier curve
Draw a bezier curve on screen

See parameters

Parameter 0 (👾 Object): Shape Painter object
Parameter 1 (🔢 Number): X position of start point
Parameter 2 (🔢 Number): Y position of start point
Parameter 3 (🔢 Number): First control point x
Parameter 4 (🔢 Number): First control point y
Parameter 5 (🔢 Number): Second Control point x
Parameter 6 (🔢 Number): Second Control point y
Parameter 7 (🔢 Number): Destination point x
Parameter 8 (🔢 Number): Destination point y

Chamfer Rectangle
Draw a chamfer rectangle on screen

See parameters

Parameter 0 (👾 Object): Shape Painter object
Parameter 1 (🔢 Number): Left X position
Parameter 2 (🔢 Number): Top Y position
Parameter 3 (🔢 Number): Right X position
Parameter 4 (🔢 Number): Bottom Y position
Parameter 5 (🔢 Number): Chamfer (in pixels)

Circle
Draw a circle on screen

See parameters

Parameter 0 (👾 Object): Shape Painter object
Parameter 1 (🔢 Number): X position of center
Parameter 2 (🔢 Number): Y position of center
Parameter 3 (🔢 Number): Radius (in pixels)

Clear between frames
Activate (or deactivate) the clearing of the rendered shape at the beginning of each frame.

See parameters

Parameter 0 (👾 Object): Shape Painter object
Parameter 1 (❓ Yes or No): Clear between each frame

Clear shapes
Clear the rendered shape(s). Useful if not set to be done automatically.

See parameters

Parameter 0 (👾 Object): Shape Painter object

Ellipse
Draw an ellipse on screen

See parameters

Parameter 0 (👾 Object): Shape Painter object
Parameter 1 (🔢 Number): X position of center
Parameter 2 (🔢 Number): Y position of center
Parameter 3 (🔢 Number): The width of the ellipse
Parameter 4 (🔢 Number): The height of the ellipse

End fill path
Finish the filling drawing in an advanced path

See parameters

Parameter 0 (👾 Object): Shape Painter object

Fill color
Change the color used when filling

See parameters

Parameter 0 (👾 Object): Shape Painter object
Parameter 1 (color): Fill color

Fill opacity
Modify the opacity level used when filling future drawings.

See parameters

Parameter 0 (👾 Object): Shape Painter object
Parameter 1: 🟰 Operator
Parameter 2 (🔢 Number): Opacity (0-255)

Fillet Rectangle
Draw a fillet rectangle on screen

See parameters

Parameter 0 (👾 Object): Shape Painter object
Parameter 1 (🔢 Number): Left X position
Parameter 2 (🔢 Number): Top Y position
Parameter 3 (🔢 Number): Right X position
Parameter 4 (🔢 Number): Bottom Y position
Parameter 5 (🔢 Number): Fillet (in pixels)

Line
Draw a line on screen

See parameters

Parameter 0 (👾 Object): Shape Painter object
Parameter 1 (🔢 Number): X position of start point
Parameter 2 (🔢 Number): Y position of start point
Parameter 3 (🔢 Number): X position of end point
Parameter 4 (🔢 Number): Y position of end point
Parameter 5 (🔢 Number): Thickness (in pixels)

Move path drawing position
Move the drawing position for the current path

See parameters

Parameter 0 (👾 Object): Shape Painter object
Parameter 1 (🔢 Number): X position of start point
Parameter 2 (🔢 Number): Y position of start point

Outline color
Modify the color of the outline of future drawings.

See parameters

Parameter 0 (👾 Object): Shape Painter object
Parameter 1: color

Outline opacity
Modify the opacity of the outline of future drawings.

See parameters

Parameter 0 (👾 Object): Shape Painter object
Parameter 1: 🟰 Operator
Parameter 2 (🔢 Number): Opacity (0-255)

Outline size
Modify the size of the outline of future drawings.

See parameters

Parameter 0 (👾 Object): Shape Painter object
Parameter 1: 🟰 Operator
Parameter 2 (🔢 Number): Value

Path arc
Add to a path an arc to a position. The origin comes from the previous action or from "Begin fill path" or "Move path drawing position". By default, the start position will be the object's position.

See parameters

Parameter 0 (👾 Object): Shape Painter object
Parameter 1 (🔢 Number): Center x of circle
Parameter 2 (🔢 Number): Center y of circle
Parameter 3 (🔢 Number): Radius (in pixels)
Parameter 4 (🔢 Number): Start angle
Parameter 5 (🔢 Number): End angle
Parameter 6 (❓ Yes or No): Anticlockwise

Path bezier curve
Add to a path a bezier curve to a position. The origin comes from the previous action or from "Begin fill path" or "Move path drawing position". By default, the start position will be the object's position.

See parameters

Parameter 0 (👾 Object): Shape Painter object
Parameter 1 (🔢 Number): First control point x
Parameter 2 (🔢 Number): First control point y
Parameter 3 (🔢 Number): Second Control point x
Parameter 4 (🔢 Number): Second Control point y
Parameter 5 (🔢 Number): Destination point x
Parameter 6 (🔢 Number): Destination point y

Path line
Add to a path a line to a position. The origin comes from the previous action or from "Begin fill path" or "Move path drawing position". By default, the start position will be the object's position.

See parameters

Parameter 0 (👾 Object): Shape Painter object
Parameter 1 (🔢 Number): X position of start point
Parameter 2 (🔢 Number): Y position of start point

Path quadratic curve
Add to a path a quadratic curve to a position. The origin comes from the previous action or from "Begin fill path" or "Move path drawing position". By default, the start position will be the object's position.

See parameters

Parameter 0 (👾 Object): Shape Painter object
Parameter 1 (🔢 Number): Control point x
Parameter 2 (🔢 Number): Control point y
Parameter 3 (🔢 Number): Destination point x
Parameter 4 (🔢 Number): Destination point y

Quadratic curve
Draw a quadratic curve on screen

See parameters

Parameter 0 (👾 Object): Shape Painter object
Parameter 1 (🔢 Number): X position of start point
Parameter 2 (🔢 Number): Y position of start point
Parameter 3 (🔢 Number): Control point x
Parameter 4 (🔢 Number): Control point y
Parameter 5 (🔢 Number): Destination point x
Parameter 6 (🔢 Number): Destination point y

Rectangle
Draw a rectangle on screen

See parameters

Parameter 0 (👾 Object): Shape Painter object
Parameter 1 (🔢 Number): Left X position
Parameter 2 (🔢 Number): Top Y position
Parameter 3 (🔢 Number): Right X position
Parameter 4 (🔢 Number): Bottom Y position

Regular Polygon
Draw a regular polygon on screen

See parameters

Parameter 0 (👾 Object): Shape Painter object
Parameter 1 (🔢 Number): X position of center
Parameter 2 (🔢 Number): Y position of center
Parameter 3 (🔢 Number): Number of sides of the polygon (minimum: 3)
Parameter 4 (🔢 Number): Radius (in pixels)
Parameter 5 (🔢 Number): Rotation (in degrees)

Rounded rectangle
Draw a rounded rectangle on screen

See parameters

Parameter 0 (👾 Object): Shape Painter object
Parameter 1 (🔢 Number): Left X position
Parameter 2 (🔢 Number): Top Y position
Parameter 3 (🔢 Number): Right X position
Parameter 4 (🔢 Number): Bottom Y position
Parameter 5 (🔢 Number): Radius (in pixels)

Anti-aliasing
Anti-aliasing

See parameters

Parameter 0: 👾 Object
Parameter 1 (🔤 String): Anti-aliasing quality level (one of: "none", "low", "medium", "high")

Collision Mask
Change the collision mask of an object to a rectangle relatively to the object origin.

See parameters

Parameter 0: 👾 Object
Parameter 1 (🔢 Number): Left X position
Parameter 2 (🔢 Number): Top Y position
Parameter 3 (🔢 Number): Right X position
Parameter 4 (🔢 Number): Bottom Y position

Center of rotation
Change the center of rotation of an object relatively to the object origin.

See parameters

Parameter 0: 👾 Object
Parameter 1 (🔢 Number): X position
Parameter 2 (🔢 Number): Y position

Star
Draw a star on screen

See parameters

Parameter 0 (👾 Object): Shape Painter object
Parameter 1 (🔢 Number): X position of center
Parameter 2 (🔢 Number): Y position of center
Parameter 3 (🔢 Number): Number of points of the star (minimum: 2)
Parameter 4 (🔢 Number): Radius (in pixels)
Parameter 5 (🔢 Number): Inner radius (in pixels, half radius by default)
Parameter 6 (🔢 Number): Rotation (in degrees)

Torus
Draw a torus on screen

See parameters

Parameter 0 (👾 Object): Shape Painter object
Parameter 1 (🔢 Number): X position of center
Parameter 2 (🔢 Number): Y position of center
Parameter 3 (🔢 Number): Inner Radius (in pixels)
Parameter 4 (🔢 Number): Outer Radius (in pixels)
Parameter 5 (🔢 Number): Start Arc (in degrees)
Parameter 6 (🔢 Number): End Arc (in degrees)

Use relative coordinates
Set if the object should use relative coordinates (by default) or not. It's recommended to use relative coordinates.

See parameters

Parameter 0 (👾 Object): Shape Painter object
Parameter 1 (❓ Yes or No): Use relative coordinates?

Close Path
Close the path of the advanced shape. This closes the outline between the last and the first point.

See parameters

Parameter 0 (👾 Object): Shape Painter object

Object conditions

Relative coordinates
Check if the coordinates of the shape painter is relative.

See parameters

Parameter 0 (👾 Object): Shape Painter object

Anti-aliasing type
Checks the selected type of anti-aliasing

See parameters

Parameter 0: 👾 Object
Parameter 1 (🔤 String): Type of anti-aliasing to check the object against (one of: "none", "low", "medium", "high")

Clear between frames
Check if the rendered image is cleared between frames.

See parameters

Parameter 0 (👾 Object): Shape Painter object

Fill opacity
Test the value of the opacity level used when filling.

See parameters

Parameter 0 (👾 Object): Shape Painter object
Parameter 1: 🟰 Relational operator
Parameter 2 (🔢 Number): Opacity to compare to (0-255)

Outline opacity
Test the opacity of the outline.

See parameters

Parameter 0 (👾 Object): Shape Painter object
Parameter 1: 🟰 Relational operator
Parameter 2 (🔢 Number): Opacity to compare to (0-255)

Outline size
Test the size of the outline.

See parameters

Parameter 0 (👾 Object): Shape Painter object
Parameter 1: 🟰 Relational operator
Parameter 2 (🔢 Number): Value to compare

Object expressions

Expression	Description
`Object.Antialiasing()`	Returns the type of anti-aliasing in use: none, low, medium, or high.
`Object.FillColorBlue()`	Filing color blue component
`Object.FillColorGreen()`	Filing color green component
`Object.FillColorRed()`	Filing color red component
`Object.FillOpacity()`	Filling opacity
`Object.OutlineColorBlue()`	Outline color blue component
`Object.OutlineColorGreen()`	Outline color green component
`Object.OutlineColorRed()`	Outline color red component
`Object.OutlineOpacity()`	Outline opacity
`Object.OutlineSize()`	Outline size
`Object.ToDrawingX(number, number)`	X drawing coordinate of a point from the scene
	🔢 Number	X scene position
	🔢 Number	Y scene position
`Object.ToDrawingY(number, number)`	Y drawing coordinate of a point from the scene
	🔢 Number	X scene position
	🔢 Number	Y scene position
`Object.ToSceneX(number, number)`	X scene coordinate of a point from the drawing
	🔢 Number	X drawing position
	🔢 Number	Y drawing position
`Object.ToSceneY(number, number)`	Y scene coordinate of a point from the drawing
	🔢 Number	X drawing position
	🔢 Number	Y drawing position

The Shape painter 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 Shape painter feature of GDevelop, the open-source, cross-platform game engine designed for everyone. Learn more about all GDevelop features here.