# TRACE IMAGE

<figure><img src="/files/HJMkEkfFemzIxZJ3Wo4B" alt=""><figcaption></figcaption></figure>

If you need a reference image for your map, for example another map made by someone else, you can use the **Trace Image** tool to open that reference image as an overlay/background and use it as a guide for your work.

<figure><img src="/files/WOIIVCeiCGDpxTP82j3D" alt=""><figcaption><p>Tracing over a premade dungeon with the Building Tool (x3 speed)</p></figcaption></figure>

<figure><img src="/files/mDvcF1p37Hiw8CdT9bA0" alt=""><figcaption></figcaption></figure>

Choose your **reference image** by clicking on the folder icon (**Browse**). It will display a new browser window so you can select the image you want to use.

<figure><img src="/files/H7OUnRswJm6VOPls7Ti4" alt=""><figcaption></figcaption></figure>

If you want to **reset** the **Trace Image** and **delete** the reference file, click on the arrow icon (**Clear**).&#x20;

<figure><img src="/files/SCKb7xTxNnZQ0a8Wey7J" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
*If you can't see your image, sometimes using the **Clear** button and choosing the image again can fix the issue.*
{% endhint %}

Once your image is displayed on your map, you can:<br>

* **Move** it by holding **click** and **moving your mouse**.<br>

* **Reset its position** by clicking on the <kbd><mark style="color:blue;">**Center**<mark style="color:blue;"></kbd> button.<br>

  <figure><img src="/files/9RnCAffpyhkouGsHUTec" alt=""><figcaption></figcaption></figure>

* Change its **scale** by using the <kbd><mark style="color:blue;">**Scale slider**<mark style="color:blue;"></kbd> or the <kbd>Mouse Wheel</kbd>.

<figure><img src="/files/6OQgLv2EBK3KkZhUiSsB" alt=""><figcaption></figcaption></figure>

* Change its **opacity** with the <kbd><mark style="color:purple;">**Opacity slider**<mark style="color:purple;"></kbd>.

<figure><img src="/files/E7PfTg6jWzkXvFWGVojO" alt=""><figcaption></figcaption></figure>

## USEFUL INFO

{% hint style="warning" %}

### Good to know

* At any point in any other tool, you can **display** or **hide** the Trace Image by pressing <kbd>T</kbd> .
* The Trace Image will be displayed **over the Water Layer** (000) and **under the User Layer 1** (100). More info on Layers [here](/guide/general-info/layers-and-sorting.md).
* You **can't export** your **Trace Image** with your map. It's built to be used as a guide, not as a background.
* If your image isn't displayed, try to use the <kbd><mark style="color:blue;">**Clear**<mark style="color:blue;"></kbd> button and select it again. If that doesn't work, try to save it under a different name and/or format and select it again.&#x20;
* Dungeondraft is working in **256 ppi**, so it means each grid square is 256x256 pixels. If your trace image has a **different resolution** (for example **100 ppi**), you can do some simple maths to know the correct scale. For our example here: `256 ppi / 100 ppi = 2.56`. The scale slider of your image will need to be set at **2.56** to be corresponding to your map.
  {% endhint %}

***

{% hint style="info" %}

## Related Mods

* [Export Trace Image](/guide/custom-assets-and-mods/some-useful-mods/export-trace-image.md) allows you to export your trace image with your map (as a background for example)
* [Layered Trace Image](/guide/custom-assets-and-mods/some-useful-mods/layered-trace-image.md) lets you manage the layer where the trace image is displayed
  {% endhint %}


---

# 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://dungeondraft-encyclopaedia.gitbook.io/guide/all-the-tools/settings-tab/trace-image.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.