Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Image

Tip

TL;DR + / - zoom, hjkl pans, f fits, z shows 1:1. [ / ] step through the layers; t tiles them. With several images open, n / p step between them and t tiles the images instead. Ctrl+click picks a pixel for the inspector.

Zoom and pan

+ / - or the mouse wheel zoom. f fits the image to the area the open panes leave; z shows it 1:1, one image pixel to one screen pixel. hjkl or the arrows pan, HJKL pan faster; right-drag (or middle-drag) pans with the mouse.

Keys

Viewer: Image

KeyDoes
[ / ]previous / next layer (AOV)
n / p (N)next / previous image (marked files)
diff: next / previous pair (A, B, |A - B|)
+ / - / wheelzoom
f / zfit / 1:1
hjkl ←↓↑→ HJKLpan (shift = faster)
right dragpan (middle button too; left on a still or tiles)
ttiles: all layers, or all marked images
+- wheel hjkltiles: zoom / pan the tiled view (f fit, z 1:1)
clickselect tile / focus pane
dragpane edges: width; files title: height
Enter (tile)open the selected tile
Tlayer name on the image (tiles: each tile’s;
tiled files numbered: [1] name, [2] name, …)
Ctrl+clickpick colour
[x, y] as in Nuke: from the bottom-left

Layers

An EXR’s channels group into layers (AOVs) by their prefix, up to the last dot: diffuse.R, diffuse.G, diffuse.B make the layer diffuse. Every channel without a prefix (R G B A, a Z, a lone Y) goes into the first layer, rgba; the other layers follow alphabetically. [ / ] step through them, and the top line shows which one is up (rgba (1/6)). T writes the layer’s name on the image.

t tiles every layer side by side: the quickest way to see what a render wrote. The top line names the selected tile; T writes each tile’s name on it. In the tiled view, + / - and the wheel zoom all the tiles together, hjkl or a drag pans, f fits and z goes 1:1. Click a tile to select it; Enter opens it on its own. t again, or q, goes back to one image.

The layers pane (5) lists them all.

Several images

Open several images (marked in the browser, or named on the command line) and n / p step between them. t tiles the images instead of the layers; there T numbers each name ([1] comp.exr, [2] comp.exr), for versions that differ only by folder. Small tiles keep the number and the end of the name, or just the number.

The files pane (3) lists what’s open: show, reorder or drop images there. To compare two versions, see Compare.

Picking a pixel

Ctrl+click a pixel to pick it: the inspector (4) lists every channel of the layer shown there. To read another layer, step to it ([ / ]) and pick again, or tile the layers (t) and Ctrl+click in a tile. Coordinates are [x, y] as in Nuke, counted from the bottom-left.

Labels

path:label=SLOT:TEXT on the command line puts a line of text on that image. See Labels from the command line.

Incomplete images

A render that’s still writing, or a file cut short, shows what’s there: the strips that were written, the rest black, and incomplete image in the top-right corner. Once the file is complete on disk, the viewer reloads it.