> ## Documentation Index > Fetch the complete documentation index at: https://docs.atlanta.gg/llms.txt > Use this file to discover all available pages before exploring further. # Draw > A comprehensive module containing functions for low-level graphical rendering, allowing scripts to draw shapes, text, images, and gradients directly to the screen within the draw event. *** You **must** call all functions within the `draw` table (e.g., `draw.rect_filled()`, `draw.text()`) exclusively inside an **`EventType.Draw`** callback function registered with the `event` module. Calling draw functions from any other event or context will result in an immediate error. *** ## Access All draw C++ functions are exposed to your Lua script via a single global table named **`draw`**. You access individual values by using the dot (`.`) or bracket (`[]`) operator on this table. ```lua Draw Usage Example theme={null} event.set(EventType.Draw, function() draw.line(Rect.new(10, 10, 200, 250), Color4.new(1, 0, 0, 1)); -- Dot Operator draw["rect_filled"](Rect.new(Vector2.new(20, 30), Vector2.new(150, 215)), Color4.new(0, 0, 1, 1), 2.5); -- Bracket Operator end); ``` *** ## Functions This section lists all available C++ functions exposed within the global **`draw`** table. These functions provide low-level access to the graphics engine, enabling direct rendering of various elements like shapes, lines, text, and images to the screen. *** ### line Draws a line between two points defined by a Rect. ```lua theme={null} line(Rect: rect, Color4: color, number?: thickness): void ``` The Rect defining the line's start (low) and end (high) points. The color of the line. The thickness of the line in pixels. Defaults to `1`. ### rect Draws a rectangle outline. ```lua theme={null} rect(Rect: rect, Color4: color, number?: rounding, number?: thickness): void ``` The Rect defining the rectangle's position and size. The color of the rectangle outline. The corner rounding radius. Defaults to `0`. The thickness of the outline in pixels. Defaults to `1`. ### rect\_filled Draws a filled rectangle. ```lua theme={null} rect_filled(Rect: rect, Color4: color, number?: rounding): void ``` The Rect defining the rectangle's position and size. The fill color of the rectangle. The corner rounding radius. Defaults to `0`. ### rect\_gradient Draws a filled rectangle with a gradient. ```lua theme={null} rect_gradient(Rect: rect, Color4: top, Color4: bottom, boolean?: inverse): void ``` The Rect defining the rectangle's position and size. The color at the top of the gradient. The color at the bottom of the gradient. Whether to inverse the gradient direction. Defaults to `false`. ### quad Draws a quadrilateral outline defined by four points. ```lua theme={null} quad(Vector2: p1, Vector2: p2, Vector2: p3, Vector2: p4, Color4: color, number?: thickness): void ``` The first corner point of the quadrilateral. The second corner point of the quadrilateral. The third corner point of the quadrilateral. The fourth corner point of the quadrilateral. The color of the quadrilateral outline. The thickness of the outline in pixels. Defaults to `1`. ### quad\_filled Draws a filled quadrilateral defined by four points. ```lua theme={null} quad_filled(Vector2: p1, Vector2: p2, Vector2: p3, Vector2: p4, Color4: color): void ``` The first corner point of the quadrilateral. The second corner point of the quadrilateral. The third corner point of the quadrilateral. The fourth corner point of the quadrilateral. The fill color of the quadrilateral. ### triangle Draws a triangle outline defined by three points. ```lua theme={null} triangle(Vector2: p1, Vector2: p2, Vector2: p3, Color4: color, number?: thickness): void ``` The first corner point of the triangle. The second corner point of the triangle. The third corner point of the triangle. The color of the triangle outline. The thickness of the outline in pixels. Defaults to `1`. ### triangle\_filled Draws a filled triangle defined by three points. ```lua theme={null} triangle_filled(Vector2: p1, Vector2: p2, Vector2: p3, Color4: color): void ``` The first corner point of the triangle. The second corner point of the triangle. The third corner point of the triangle. The fill color of the triangle. ### circle Draws a circle outline. ```lua theme={null} circle(Vector2: pos, Color4: color, number: radius, number?: segments, number?: thickness): void ``` The center position of the circle. The color of the circle outline. The radius of the circle. The number of segments used to draw the circle. Defaults to `0` (auto). The thickness of the outline in pixels. Defaults to `1`. ### circle\_filled Draws a filled circle. ```lua theme={null} circle_filled(Vector2: pos, Color4: color, number: radius, number?: segments): void ``` The center position of the circle. The fill color of the circle. The radius of the circle. The number of segments used to draw the circle. Defaults to `0` (auto). ### text Draws text at the specified position. ```lua theme={null} text(Vector2: pos, Color4: color, string: text, number?: font, number?: font_size, number?: outline, Color4?: outline_color): void ``` The position where the text will be drawn. The color of the text. The text string to draw. The font identifier. Defaults to `0` (default font). The size of the font. Defaults to `0` (default size). The outline thickness. Defaults to `3`. The color of the text outline. Defaults to black `(0, 0, 0, 1)`. ### text\_size Calculates and returns the size of text as it would be rendered. Returns a Vector2 containing the width and height of the text. ```lua theme={null} text_size(string: text, number?: font, number?: font_size): Vector2 ``` The text string to measure. The font identifier. Defaults to `0` (default font). The size of the font. Defaults to `0` (default size).