# Gizmos and shortcuts (https://docs.fuser.studio/docs/compositor/gizmos)

Every tool in the Compositor draws its own handles on the canvas: bounds around a layer, points along a path, a frame around a crop. They share one look, so once you know one you can read them all. Points are light and turn the accent color when selected, the handle you're dragging is the only one in the accent, and a small pill shows the exact value while you drag.

The demos below are live: drag them as you would on the canvas. Keys are shown with Mac symbols; on Windows and Linux, <kbd>⌘</kbd> is <kbd>Ctrl</kbd> and <kbd>⌥</kbd> is <kbd>Alt</kbd>.

## Transform [#transform]

With the [Select tool](https://docs.fuser.studio/docs/compositor/tools.md#select-v) (<kbd>V</kbd>), a selected layer gets the transform gizmo: drag the layer to move it, drag its corners and edges to resize it, and drag just outside a corner to rotate it.

### How to use [#how-to-use]

* **Move:** drag the layer. It snaps to the canvas center, other layers and the canvas edges, and a red guide shows what it lined up with. Hold <kbd>⇧</kbd> to lock the move to horizontal, vertical or 45°, or <kbd>⌘</kbd> to move without snapping.
* **Copy:** hold <kbd>⌥</kbd> as you start a move to drag a copy; the original stays where it was.
* **Resize:** drag a corner, or an edge capsule to move one side. Images, video, 3D and raster layers keep their ratio and <kbd>⇧</kbd> frees it; on shapes, paths and text <kbd>⇧</kbd> keeps it. Hold <kbd>⌥</kbd> to resize from the center.
* **Rotate:** drag just outside a corner, where the pointer turns into a curved arrow. Hold <kbd>⇧</kbd> for 15° steps, <kbd>⌘</kbd> to turn slowly for fine angles, or <kbd>⌥</kbd> to turn about the opposite corner.
* **Pivot:** drag the crosshair chip to rotate around another point. It snaps to the corners, edge midpoints and center; double-click it to put it back in the center.
* **Several layers:** <kbd>⇧</kbd>-click layers, or drag a box on empty canvas. The box around them scales them all from its corners: <kbd>⇧</kbd> keeps their ratios and <kbd>⌥</kbd> scales from the center.
* **Groups:** a group resizes from its corners only and keeps its ratio.

### Anatomy [#anatomy]

### Layer kinds [#layer-kinds]

Some layer kinds change what the gizmo can do.

### Moving [#moving]

### Resizing [#resizing]

A layer's own ratio rule decides what <kbd>⇧</kbd> does: it frees a kept ratio and keeps a free one.

### Rotating [#rotating]

### Hover and selection [#hover-and-selection]

What the pointer previews before a click, and which layer a click picks.

### Snapping [#snapping]

Snapping shows what snapped, to what, and by how much.

## Curve editing [#curve-editing]

Curve editing works on the points and handles of a path. Double-click a path layer, or select it and press <kbd>Enter</kbd>, to edit it.

### How to use [#how-to-use-1]

* **Select points**: click a point, or <kbd>⇧</kbd>-click to add it to the selection or take it out. Drag on empty canvas to draw a marquee, or <kbd>⌥</kbd>-drag (or hold <kbd>Q</kbd>) for a lasso.
* **Drag a point** to move it. Hold <kbd>⇧</kbd> to keep it horizontal, vertical or at 45°, <kbd>⌥</kbd> to move a copy, or <kbd>⌘</kbd> to turn snapping off.
* **Drag a handle** to shape the curve. Hold <kbd>⇧</kbd> to keep its angle or snap to 45°, <kbd>⌥</kbd> to break the pair and make the point a corner, or <kbd>⌘</kbd> for fine control.
* **Click a segment** to add a point there. <kbd>⌘</kbd>-drag a segment to bend it.
* <kbd>⌘</kbd>-drag a point that has no handles to pull out a smooth pair.
* <kbd>C</kbd>, or <kbd>⌥</kbd>-click a point, switches it between smooth and
  corner. <kbd>⇧</kbd>
  <kbd>C</kbd> cycles all four point types. <kbd>⌥</kbd>-click a handle to
  retract it.
* <kbd>Tab</kbd> moves the selection to the next point along the path,
  <kbd>⇧</kbd>
  <kbd>Tab</kbd> to the previous one. <kbd>⌘</kbd>
  <kbd>A</kbd> selects every point.
* Arrow keys nudge the selected points 1 px, or 10 px with <kbd>⇧</kbd>.
* <kbd>Delete</kbd> removes the selected points and joins their neighbors.
  <kbd>⌥</kbd>
  <kbd>Delete</kbd> breaks the path there instead.
* <kbd>⌘</kbd>
  <kbd>K</kbd> splits the path at the selected point. <kbd>⌘</kbd>
  <kbd>J</kbd> joins two selected end points, or closes an open path.
* <kbd>⇧</kbd>
  <kbd>R</kbd> reverses the path's direction. <kbd>⇧</kbd>
  <kbd>H</kbd> evens out the curvature at the selected smooth points.
* <kbd>Esc</kbd> clears the point selection, then leaves. <kbd>Enter</kbd> also
  leaves.

### Point types [#point-types]

The shape of a point tells you how its handles behave.

### Handle arms [#handle-arms]

The arms show whether a point's handles are linked before you drag one.

### Points [#points]

### Handles [#handles]

### The path [#the-path]

What the path shows: which part you're on, which way it runs and what a click will do.

### Selecting points [#selecting-points]

### Commands [#commands]

### Modifiers and cursors [#modifiers-and-cursors]

A held modifier shows beside the pointer, and the hint strip lists what each one does to the current drag.

## Pen [#pen]

The pen draws a vector path point by point: click for corners, drag for curves. Press <kbd>P</kbd> to pick it. Before you click, the cursor shows what the next click will do.

### How to use [#how-to-use-2]

* **Click** to place a corner point. **Drag** more than 4 px to pull out mirrored handles and make a curve.
* Hold <kbd>⇧</kbd> to snap a new point to 45° from the last one, or the handle you drag to 45° steps.
* Hold <kbd>⌥</kbd> while you drag to move only the out handle. The point becomes a corner.
* Hold <kbd>Space</kbd> while you drag to move the point instead of its handles, or <kbd>⌘</kbd> to move the handle at a quarter of the speed.
* **Click the first point** to close the path. While you draw, **click another open path's end** to join the two.
* With no path in progress, **click an open path's end** to keep drawing from it. Clicking its first point reverses the path first.
* <kbd>↵</kbd> finishes the path and keeps the pen. <kbd>Esc</kbd>, or switching
  tools, finishes it and selects it.
* <kbd>⌫</kbd> or <kbd>⌘</kbd>
  <kbd>Z</kbd> removes the last point. A path needs two points: finishing with
  one removes it.

### Before the first click [#before-the-first-click]

What the pen shows when no path is in progress.

### Placing points [#placing-points]

### Closing and joining [#closing-and-joining]

### Finishing [#finishing]

## Text [#text]

Text layers are edited in place, on the canvas. Double-click a text layer, or select it and press <kbd>Enter</kbd>, to type into it. The box outline stays while you type; the resize handles come back when you stop.

### How to use [#how-to-use-3]

* **Double-click a text layer** to edit it with the caret where you clicked. Select it and press <kbd>Enter</kbd> to edit it with all its text selected.
* <kbd>Esc</kbd>, or a click anywhere else, stops editing.
* **Drag a side handle** (out of editing) to set the box's width; the text wraps inside it. A box that grew with its text becomes fixed width and wraps. Hold <kbd>⌥</kbd> to resize from the center.
* <kbd>⌥</kbd>
  <kbd>←</kbd> and <kbd>⌥</kbd>
  <kbd>→</kbd> kern the character before the caret by 20 a press, or 100 with
  <kbd>⌘</kbd>.
* **With the text tool** (<kbd>T</kbd>), click empty canvas for a new text layer. It grows with what you type and starts wrapping once it reaches the canvas edge.

### Starting to edit [#starting-to-edit]

### Caret and selection [#caret-and-selection]

### Box modes [#box-modes]

While you type, a chip under the box names its mode: **Auto width**, **Fixed width, wraps** or **Fixed size**.

### Leaving [#leaving]

## Crop [#crop]

Crop picks which part of an image or video layer shows, without changing how big the image is on the canvas. Double-click an image or video layer, or select it and press <kbd>Enter</kbd>, to crop it.

### How to use [#how-to-use-4]

* **Drag a corner or an edge** to crop. The image stays where it is on the canvas, and the pill under the frame shows the crop's size in source pixels. A crop can't go below 10 pixels.
* **Drag inside the frame** to slide the image under it. The frame stays where it is.
* Hold <kbd>⇧</kbd> while you drag a corner to keep the crop's ratio, or <kbd>⌥</kbd> to resize about the center.
* <kbd>Delete</kbd> or <kbd>⌫</kbd> resets the crop to the full image.
* Click **Done**, press <kbd>Enter</kbd> or <kbd>Esc</kbd>, or double-click to finish. Your crop is kept either way.

### The crop frame [#the-crop-frame]

### Shift, Alt and sliding [#shift-alt-and-sliding]

### Around the frame [#around-the-frame]

## Ink and brushes [#ink-and-brushes]

An ink stroke is a filled shape around a spine, with a width at each point. Double-click an ink layer, or select it and press <kbd>Enter</kbd>, to edit its strokes one at a time.

### How to use [#how-to-use-5]

* **Drag a point** to move it. Hold <kbd>⇧</kbd> to keep it on an axis or 45°, or <kbd>⌘</kbd> to move it at a quarter of the speed.
* **Drag a width handle** on the selected point to change the width there. <kbd>⌘</kbd> gives fine control, <kbd>⇧</kbd> changes every selected point, <kbd>⌥</kbd> the whole stroke.
* **Click the spine** to add a point, and keep dragging to place it.
* **Double-click or <kbd>⌥</kbd>-click a point**, or press <kbd>C</kbd>, to switch it between smooth and corner.
* **Select points**: <kbd>⇧</kbd>-click adds a point to the selection or takes it out, <kbd>⌘</kbd><kbd>A</kbd> selects them all, and <kbd>Tab</kbd> steps along the stroke.
* <kbd>1</kbd>–<kbd>9</kbd> set the selected points' opacity to 10–90%,
  <kbd>0</kbd> to 100%.
* Arrow keys nudge the selected points 1 px, or 10 px with <kbd>⇧</kbd>. With no point selected they move the whole stroke.
* <kbd>Delete</kbd> removes the selected points, or the stroke when none is
  selected.
* <kbd>Esc</kbd> deselects the points, then leaves. <kbd>Enter</kbd> or a click
  on empty canvas also leaves.

### Editing a stroke [#editing-a-stroke]

### Ink commands [#ink-commands]

### Brush and eraser [#brush-and-eraser]

With the brush, eraser or ink tool, the ring is the cursor. It shows the size, hardness and opacity, and the eraser's restore mode.

### Ink tool [#ink-tool]

Drawing a new ink stroke, freehand or by clicking points.

### Shape tool [#shape-tool]

The preview while you drag out a rectangle or ellipse, and what each modifier does to it.

## 3D mesh [#3d-mesh]

Select a 3D layer and its gizmo appears on the canvas: one ring per axis, at most 110 px across and always inside the layer's frame. Scale and move handles appear when you bring the pointer to the center.

### How to use [#how-to-use-6]

* **Drag a ring** to turn the mesh about that axis. Hold <kbd>⇧</kbd> to turn in 15° steps, or <kbd>⌘</kbd> to turn at a quarter of the speed.
* **Drag the thin outer circle** to roll the mesh on screen. It shows when the rings are set to **Local**.
* **Drag inside the rings** to tumble the mesh freely. Hold <kbd>⇧</kbd> to keep it horizontal or vertical.
* **Press <kbd>R</kbd> twice** to tumble with no button held. Click or press <kbd>Enter</kbd> to keep it; press <kbd>Esc</kbd> or right-click to put it back.
* **Bring the pointer to the center** and a scale stalk per axis and the move disc fade in. Drag a stalk to scale that axis, or hold <kbd>⇧</kbd> to scale all three. Drag the disc to move the layer; <kbd>⇧</kbd> locks the axis.
* **Local · Global**, the chip in the frame's corner, sets the rings on the mesh's own axes or the world's. Scale always follows the mesh's own axes.
* **Double-click** a ring to reset that axis, the roll circle to reset the rotation, or a stalk to reset its scale. Hold <kbd>⇧</kbd> to reset every axis. Double-click the move disc to center the layer on the canvas.
* **Drag a frame corner** to resize the layer. It keeps its proportions unless you hold <kbd>⇧</kbd>.
* Press <kbd>Esc</kbd> to cancel any drag.

Hovering a handle shows a pill with what it does and its current value.

### Shading and light [#shading-and-light]

The **3D Mesh** section of the properties panel sets how the mesh is shaded. Try it beside the preview:

* **Lit** lights the mesh with an environment. Pick one of six skies, then set **Light intensity** and **Light rotation** to change how bright the light is and where it comes from. Sunset is a full HDR sky: it loads the first time you pick it, with a spinner on its tile. The other five skies are ready at once.
* **Matcap** shades the mesh from one of eight material balls, such as clay, chrome or gold. They don't depend on any light.
* **Flat** uses one light from the upper left and one tone per face, so you can read how the mesh is built.
* **Normals** colors each face by the way it points: red for X, green for Y, blue for Z. Use it to spot flipped or broken faces.

## Keys and modifiers [#keys-and-modifiers]

Press <kbd>?</kbd> in the Compositor to see the keys for the mode you're in.

### Editor [#editor]

### While dragging [#while-dragging]

### Modifiers by drag [#modifiers-by-drag]

### Edit modes and tools [#edit-modes-and-tools]

These keys apply while you edit a layer's points, crop or text, paint, place a pen path, or have a 3D layer selected.

### Hints on screen [#hints-on-screen]

A strip above the toolbar lists the modifiers for the drag in progress and lights up the ones you're holding. Between drags it shows what the current mode offers. Turn it off from the shortcut list (<kbd>?</kbd>).

## What's Next? [#whats-next]

  - [Tools](https://docs.fuser.studio/docs/compositor/tools.md): Each tool's settings and what it creates.

  - [Layers](https://docs.fuser.studio/docs/compositor/layers.md): Layer types, groups, masks and blend modes.