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

Viewer

Tip

TL;DR Enter on an image in the browser, or rega render.exr, opens the viewer. Its keys come in groups: Image (zoom, layers, several images), Compare, Sequence (playback) and Display (channels, exposure). 2-6 open the panes. ? lists every key, q goes back to the browser, Q quits.

rega render.exr                 # one image
rega 'shot.####.exr'            # a sequence (quote the #s)
rega a.exr b.exr c.exr          # several: n / p step between them
rega --diff v1.exr v2.exr       # A, B and |A − B|

The screen

┌ [1] shot.1042.exr  rgba (1/6)  RGBA  960×540  🔍 fit ─────────────┐
│ layers ┐                                         ┌ inspector      │
│ colour │                the image                │ metadata       │
│ files  ┘                                         └                │
├ 1001 ───────────────▲──────────────────── 1100    24.00  24.0 fps ┤
└ space play  [ ] layer  2 meta  3 files  ? help  q back ───────────┘
  • Top line: which open image ([1], its number in the files pane) and its name, the layer shown, its channels, the resolution and the zoom (🔍 fit, 🔍 200%).
  • The image, fitted to the terminal at first.
  • Panes, when open: layers, colour and files on the left; inspector and metadata on the right. See Panes.
  • Playbar, for a sequence: frame numbers, the playhead, in and out points and the playback rate. See Sequence.
  • Bottom line: the keys that matter most right now.

Sequences on the command line

To open a sequence, give a pattern instead of one frame. Put it in single quotes so the shell passes it to rega unchanged:

PatternMatches
'shot.####.exr'shot.1001.exr … (each # one digit)
'shot.#.exr'any padding: a lone # finds it
shot.*.exr* works too, unquoted: the shell lists the frames for rega

A plain frame path (shot.1001.exr) opens just that frame.

Leaving

Viewer: Leaving the viewer

KeyDoes
q / Escback to browser
Qquit rega