Engine
engine.draw_circle
Client
Draws a filled circle on the canvas
Syntax
local status = engine.draw_circle(
position,
radius,
color = {1, 1, 1, 1},
stroke = 0,
stroke_color = {1, 1, 1, 1},
rotation = 0,
pivot = {0, 0}
)Must be called within the vital.sandbox:draw event. Invoking this function outside of that event will have no effect.
- Inside the event — executes as expected, rendering the filled circle to the canvas each frame
- Outside the event — the call will be silently ignored and nothing will be drawn
- Recommended usage — register a handler via
network:fetch("vital.sandbox:draw", true):on(...)and place all canvas draw calls inside it
Parameters
| Type | Name | Description |
|---|---|---|
vector2 | position | Center point of the circle |
float | radius | Radius of the circle in pixels |
color | color | Fill color of the circle |
float | stroke | Outline thickness in pixels — set to 0 to disable |
color | stroke_color | Color of the outline |
float | rotation | Rotation angle in radians |
vector2 | pivot | Pivot point for rotation, relative to the circle's position |
Returns
| Type | Name | Description |
|---|---|---|
bool | status | true on successful execution, or false on failure |
Examples
network:fetch("vital.sandbox:draw", true):on(function()
--Draw a plain white circle
engine.draw_circle({200, 200}, 50)
--Draw a filled red circle with a dark outline
engine.draw_circle({200, 200}, 50, {1, 0, 0, 1}, 3, {0.2, 0, 0, 1})
--Draw a semi-transparent circle
engine.draw_circle({200, 200}, 80, {0, 0.5, 1, 0.5})
end)