DrawingImmediate.
Draw an unfilled circle around a screen position. Radius sets its size; thickness controls the outline. Use it for a ring or circular outline without covering its interior.
Luau
DrawingImmediate.Circle(
position: Vector2,
radius: number,
color: Color3,
opacity: number,
numSides: number,
thickness: number
) -> ()Parameters
| Parameter | Type | Description |
|---|---|---|
position | Vector2 | Center of the circle in screen pixels. |
radius | number | Circle radius in pixels. |
color | Color3 | Color3 used for the primitive or text. |
opacity | number | Opacity from 0 (invisible) to 1 (opaque). |
numSides | number | Number of segments used to approximate the circle. |
thickness | number | Stroke thickness for an unfilled primitive. |
Returns
()This function returns no values.
Usage notes
Immediate drawings last for one paint cycle. Call this function again from a GetPaint listener to keep the drawing visible; there is no object handle to update or remove.
Example
Luau
local color = Color3.fromRGB(240, 150, 190)
local paint = DrawingImmediate.GetPaint()
local connection = paint:Connect(function()
DrawingImmediate.Circle(Vector2.new(100, 100), 30, color, 1, 24, 2)
end)
task.wait(3)
connection:Disconnect() -- stop drawing this example