> ## Documentation Index
> Fetch the complete documentation index at: https://docs.projectreal.gg/llms.txt
> Use this file to discover all available pages before exploring further.

# Drawing.new

> Cria um novo Drawing object do tipo solicitado e o adiciona a Real tracked Drawing object list. O type string deve ser um dos nomes exatos aceitos: "Line", "Text", "Circle", "Square", "Quad", "Triangle", "Image". Valores ausentes, non-string ou type values nao aceitos geram um Lua error. the Drawing API registra esta API somente quando the required rendering environment is active e true; quando essa verificacao e false, o initializer retorna antes de criar estes globals.

<div className="real-function-page">
  ```lua theme={null}
  Drawing.new(objectType: "Image" | "Line" | "Text" | "Circle" | "Square" | "Quad" | "Triangle"): DrawingObject
  ```

  ## Argumentos

  <ParamField path={"objectType"} type={"\"Image\" | \"Line\" | \"Text\" | \"Circle\" | \"Square\" | \"Quad\" | \"Triangle\""} required>
    Nome exato de Drawing type a criar. Os valores aceitos sao "Line", "Text", "Circle", "Square", "Quad", "Triangle", "Image".
  </ParamField>

  ## Retornos

  <ResponseField name={"object"} type={"DrawingObject"}>
    Drawing object criado com Drawing object type.
  </ResponseField>

  ## Exemplo

  Crie um quadrado visível e configure suas propriedades básicas de desenho.

  ```lua theme={null}
  local square = Drawing.new("Square")
  square.Position = Vector2.new(120, 120)
  square.Size = Vector2.new(220, 120)
  square.Color = Color3.fromRGB(120, 170, 255)
  square.Filled = true
  square.Visible = true
  ```
</div>