# Transforming Layers on the Canvas

In Fater's **Image Editor**, you can directly manipulate the size and position of your image layers on the main **Inpaint Canvas** using interactive controls. This allows you to arrange elements precisely for your composition.

Remember, for these transformations to be possible, the layer needs to be **unlocked**.

***

### Moving Layers

Move a layer to reposition its content on the canvas:

1. Ensure you are **not** using an active tool (like the Mask Brush or Pencil). Click the currently active tool again in the **Inpaint Toolbar** to deselect it (or press **Escape**).
2. Ensure the layer you want to move is **unlocked** and **visible**.
3. Click and **drag the layer** directly on the main **Inpaint Canvas**.
4. Release the mouse button when the layer is in the desired position.

As you drag, the layer's position (`x` and `y` coordinates) is updated. The layer's position in the **Layer Stack** (its front-to-back order) does **not** change when you move it on the canvas – that's controlled by reordering in the Layers Tab.

***

### Resizing Layers (Scaling)

Resize a layer to change its size and the size of its content on the canvas. This changes the layer's `scale`.

1. Ensure the layer you want to resize is **unlocked** and **visible**.
2. Ensure you are **not** using an active tool (like the Mask Brush or Pencil). Deselect any active tool if necessary.
3. When a layer is selected and unlocked, **resize handles** will appear around it on the canvas. These are small interactive points, often located on the corners or edges of the layer's bounding box. *(Placeholder: Add screenshot)*
4. Click and **drag one of the resize handles**.
5. Release the mouse button when the layer is the desired size.

Dragging a handle changes the layer's `scale` property, making its content larger or smaller on the canvas.

***

### Important Notes on Transforming Layers:

* **Selection & Lock:** Layers must be **unlocked** to be moved or resized on the canvas.
* **Saving:** Any changes to a layer's position or scale via these canvas transformations **automatically trigger the background auto-save**.
* **Canvas vs. Layer Size:** These actions change the layer's *visual position and scale* on the canvas. They do **not** change the layer's underlying original pixel dimensions (`imageData.width`, `imageData.height`). 

Mastering these canvas transformations allows you to precisely place and size all the elements in your composition.


---

# 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://fater.gitbook.io/fater-ai-docs/working-with-layers/transforming-layers-on-the-canvas.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.