# Pencil tool

Click and drag in the viewport to draw with the Pencil.&#x20;

{% hint style="info" %}
A single Shape can contain more more than one Path. Select your Shape and hold `ctrl/cmd` as you draw to add to an existing path.
{% endhint %}

### Tool settings

**Stroke Width** - set the width of the Stroke.

**Cap Style** - set the appearance of caps (each end of the stroke) for open paths.

* **Flat** - a flat end that terminates at the end point.
* **Round** - a hemispherical end with the end point at its centre.
* **Projecting** - a flat end that projects half the Width beyond the end point.

**Accuracy** - determine how closely your resulting shape resembles your cursor movements. A higher setting will result in a more accurate shape but will create more points.

**Close Distance** - if you end your line within this value of the start point a closed path will be created. Note - this value is independent of the Viewport scale.

### Beta

We've started work on a **redraw** feature which allows you to redraw pencil paths. To try it out:

1. Draw an open path with the **Pencil**.
2. Hold `r` and hover over the path. A preview line should appear.
3. `click` and start drawing.

The end of the path will be removed and replaced with the one you draw in step 3.


---

# 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://scenegroup.gitbook.io/cavalry/user-interface/menus/tool-menu/pencil-tool.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.
