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.