# How to use the Drawing Tools

## Canvas Toolbar

* From your [<mark style="color:purple;">**Canvas**</mark>](https://www.canoa.supply/canvas) dashboard, either select one of your Canvas boards or click on + New Canvas.
* At the top is your toolbar is where you can access the drawing functions quickly.
* Click on the **Pen** icon and select either **Polyline,** **Rectangle** or **Circle**. As a shortcut, you can type `P` to draw a straight polyline, `R` to draw rectangles or `E` to draw a circle.

<figure><img src="/files/KoziBgWOplrBwl8H4TOp" alt=""><figcaption><p>The Drawing tools in the toolbar</p></figcaption></figure>

{% hint style="info" %}
A polyline is a straight line. Use polylines to draw custom shapes and accurate floor plans and layouts of your space!

An ellipse is a circle or oval. Hold down the `Shift Key`to draw a perfect circle.
{% endhint %}

## Drawing a Polyline

* Select either **Polyline** from the toolbar or type **`P`** and click on the area of your Canvas where you want to start your polyline.
* Holding down the `shift key` while drawing your polyline constrains the angle of the line you're creating and will allow you to draw a straight line in the direction you drag your cursor.
* Clicking your left mouse key will create a connected anchor point
* Click `Enter` to complete the polyline.
* Click `ESC` to start your drawing over.

<figure><img src="/files/7dhc7oYmAswdqi11MaVr" alt="" width="563"><figcaption><p>Drawing a straight, or constrained, line with polylines</p></figcaption></figure>

### Drawing a Precise Polyline

* You can draw lines with precise dimensions in Canvas. With the Polyline tool activated, type in your desired **length** in any format (ft, in, cm, etc.) into the designated box at the bottom of your screen.
* Clic&#x6B;**`Enter`** to accept your inputs.&#x20;
* Now place the end point of that line segment to your liking, knowing that it is now dimensioned to your desired measurement.
  * Remember, if you want a straight line, hold down the `Shift` key.
* A second polyline will automatically begin. To complete and exit your drawing, click **`Enter`**.

<figure><img src="/files/mbWFlHEOR131ozoxTZrP" alt="" width="563"><figcaption><p>Using precise polylines to create a layout of a 12' x 15' bedroom</p></figcaption></figure>

### Drawing a Freeform Custom Shape with Polylines

* Select either **Polyline** from the toolbar or type **`P`** and click on the area of your Canvas where you want to start your polyline.
* With each mouse click, an anchor point is placed.&#x20;
* To close your shape, click on your first anchor point.
* When your drawing is complete, click `Enter`.

<figure><img src="/files/Ch0sMow9TJOMEXIA4ldl" alt="" width="561"><figcaption><p>Drawing freeform shapes with polylines</p></figcaption></figure>

## Drawing a Rectangle

* Select **Rectangle** from the toolbar or type **`R`** and click on the area of your Canvas where you'd like to place your shape.
* Click once to start drawing your Rectangle. When you are done drawing, click a second time to complete your rectangle.

### Drawing Precise Rectangles:

* You can draw and edit squares and rectangles to precise dimensions in Canvas. With the Rectangle tool activated, type in your desired **width** and **height** in any format into the designated box at the bottom of your screen.
* Dimensions are automatically converted to **feet** and **inches**.&#x20;
* Use `Tab` to go between inputs, and `Tab` or **`Enter`** to accept your inputs.&#x20;

<figure><img src="/files/GXxj6CHybovO6PvhL3gb" alt="" width="449"><figcaption><p>Dimensions appear when actively drawing a Rectangle.</p></figcaption></figure>

You can also hold down `Shift` to maintain equal proportions of your rectangle.

## Drawing a Circle

* Select **Circle** from the toolbar or type **`E`** and click on the area of your Canvas where you'd like to place your shape.
* Hold the left mouse key and drag to create your ellipse, or circle. Holding the `shift` key while dragging will create a perfect circle. Let go of your mouse key when you're done.

### Drawing Precise Cirlces:

* You can draw and edit circles to precise dimensions in Canvas. With the Circle tool activated, type in your desired **width** and **height** in any format into the designated box at the bottom of your screen.
* Dimensions are automatically converted to **feet** and **inches**.&#x20;
* Use `Tab` to go between inputs, and `Tab` or `Enter` to accept your inputs.&#x20;

<figure><img src="/files/gKVOXP3IMY32T3pFIpPm" alt="" width="375"><figcaption><p>Dimensions appear when actively drawing an ellipse. </p></figcaption></figure>

## Resizing your Shape

* Click on your shape and hover along the corners or edges until the shape arrows are activated. Hold down your left mouse key and drag to resize.
* To resize with a fixed aspect ratio, hold down both your **`shift` key** and left mouse key and drag to resize.

## Formatting Shapes

* There are formatting options available for your shapes. Left mouse click and then drag-select to select your line or click on your shape to select your shape.
* When selected, the formatting icons will appear below your shape. You have the option to **set fill style** or **set stroke style**.
  * Fill = Inside the shape
  * Stroke = Border of the shape&#x20;

<div align="center"><figure><img src="/files/FEReGaVa79mxQyx8ifie" alt="" width="375"><figcaption><p>Set Fill Style menu.</p></figcaption></figure></div>

<div align="center"><figure><img src="/files/wGuzLKzrluco8gdPPD5h" alt="" width="375"><figcaption><p>Set the Stroke Style</p></figcaption></figure></div>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.canoa.supply/docs/design/how-to-use-the-drawing-tools.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
