# XR Pen

{% hint style="info" %}
**When to use XR Pen?**

1. **Visualize Complex Ideas**\
   Sketch or draw directly in VR to turn abstract concepts into clear visuals, making ideas easier to understand and share.
2. **Enhance Mind Maps**\
   Use XR Pen to add links and notes to your mind maps, helping you organize thoughts and build real-time connections.
3. **Annotate and Illustrate**\
   Enrich your notes with diagrams, charts, and illustrations using XR Pen, transforming plain text into engaging content.
   {% endhint %}

<figure><img src="https://3094266310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1AxQXJzsVFhLJTfrFw9q%2Fuploads%2F9tHwH0Ff3AOYBV8555pq%2Fpen%20usecase.png?alt=media&#x26;token=796be1d6-683c-4363-a047-a47dc190b873" alt=""><figcaption></figcaption></figure>

## Enter and Exit XR Pen Mode

The XR Pen mode can be entered and exited by pressing the B button on the right controller (or the Y button on the left controller for left-handed mode).

<figure><img src="https://3094266310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1AxQXJzsVFhLJTfrFw9q%2Fuploads%2FbxQ0zs19S0i0koNSTKGv%2Fpen%20enter%26exit.png?alt=media&#x26;token=3eeeb829-035b-45d7-9644-cc6dcc828d3e" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}

* The <mark style="color:red;">**XR Pen entry button appears when the PC is connected**</mark>. Once connected, the XR Pen objects will be loaded, and they will disappear when disconnected.
* Switching to left hand mode is not possible while in pen mode. it can only be done after exiting pen mode.
  {% endhint %}

## Drawing

Once XR Pen mode is activated, press the **trigger button** to start drawing.

<figure><img src="https://3094266310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1AxQXJzsVFhLJTfrFw9q%2Fuploads%2FvB4EXUoaZ0nP07yqJF7a%2Fpen%20drawing.png?alt=media&#x26;token=b95d100b-ee74-4777-a140-2b48f5cd6665" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3094266310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1AxQXJzsVFhLJTfrFw9q%2Fuploads%2F5dVYLxd4jhzOaP3qjGzR%2Fpen-drawing.gif?alt=media&#x26;token=c3d3713e-aa97-497c-a671-60536921d847" alt=""><figcaption></figcaption></figure>

### Size adjustment (Thumbstick up/down control)

* You can adjust the area size of the Pen, Eraser, and Select tools, with five levels of adjustment available.

### Undo/Redo (Thumbstick right/left control)

* Use the thumbstick to quickly undo or redo your last action.

### Straight line/circle gesture (Thumbstick press)

<figure><img src="https://3094266310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1AxQXJzsVFhLJTfrFw9q%2Fuploads%2FBaEiwH9AjLZdYkfffkAD%2Fpen%20adjust.png?alt=media&#x26;token=924abdce-3559-43ef-b756-8eabc1fb085e" alt=""><figcaption></figcaption></figure>

Hold the trigger button to draw a straight line. To draw a circle, extend the line to a certain length and then curve it back to the starting point to complete the shape.

<figure><img src="https://3094266310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1AxQXJzsVFhLJTfrFw9q%2Fuploads%2FcBJ0KVKaRmBjdU2qfae5%2Fstraight-circle.gif?alt=media&#x26;token=e5e994cd-72d7-40ea-8ccb-ba7d595b356d" alt=""><figcaption></figcaption></figure>

### Move pen object

You can grab the pen object with the grip button and move its position.

<figure><img src="https://3094266310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1AxQXJzsVFhLJTfrFw9q%2Fuploads%2F7F94zmPj4bjkQS1eLcPk%2Fmove%20grab.gif?alt=media&#x26;token=779f17e6-c2c6-4443-aefa-b20f76e44d85" alt=""><figcaption></figcaption></figure>

## Tools

Press and hold the Tools(A) button on the controller and move left or right to select the tool.

<figure><img src="https://3094266310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1AxQXJzsVFhLJTfrFw9q%2Fuploads%2FZIUwiqGuhqZ7ZalKSbvY%2Fpen%20tools.png?alt=media&#x26;token=52394b5f-665c-49a4-942c-b79cf6bdb6e0" alt=""><figcaption></figcaption></figure>

### Eraser

<figure><img src="https://3094266310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1AxQXJzsVFhLJTfrFw9q%2Fuploads%2FxWEjPayiBTO1akRDeEFI%2Feraser.gif?alt=media&#x26;token=c24d2977-1c8c-4060-9feb-c089daadf17c" alt=""><figcaption></figcaption></figure>

### Select

The Select tool allows you to choose one or more pen objects to move or group them together. If you want to deselect the objects, simply double-click the trigger button in empty space.

<figure><img src="https://3094266310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1AxQXJzsVFhLJTfrFw9q%2Fuploads%2FxscbKLDMSOq39YJmtJ58%2Fpen-select.gif?alt=media&#x26;token=16e4d3d0-9c8d-4981-b722-7bf3801de02a" alt=""><figcaption></figcaption></figure>

### Group / Ungroup (thumbstick press)

* When pen objects are selected, press the thumbstick to group them.
* For grouped objects, press again to ungroup.

<figure><img src="https://3094266310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1AxQXJzsVFhLJTfrFw9q%2Fuploads%2FOVnJjsQrKiojYcFPq8u2%2Fpen%20group.png?alt=media&#x26;token=acf1f397-327c-4022-8f16-54ae6f164c31" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3094266310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1AxQXJzsVFhLJTfrFw9q%2Fuploads%2FRsYfEWAwbH7X5h94Ie1X%2Fpen-group.gif?alt=media&#x26;token=a8e8d283-ac47-41e2-992f-d3882f921ed5" alt=""><figcaption></figcaption></figure>


---

# 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://overay-inc.gitbook.io/overaydesk/guide/desk-tools/xr-pen.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.
