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

First run: the tutorial

Tip

TL;DR rega --tutorial renders sample images into ~/.cache/rega/tutorial and opens them with a guide card in the corner. F1 hides the card, F2 skips a step, F3 goes back one. Q quits.

rega --tutorial

The first run renders the images (a few seconds); later runs open them straight away. In the window, the start screen’s Tutorial does the same. rega opens in the browser, on the tutorial folder. A card in the bottom-right corner gives one step at a time. Each step names its keys; they turn green as you press them, and the step ticks off when all of them are done.

The steps go: move in the browser, open and play the sequence, step and scrub, set in and out points, step through the layers, tile them, switch channels, change exposure, read a pixel, go back to the browser, then the HDR sky, the broken render and several images at once.

KeyDoes
F1hide / show the card
F2skip a step
F3back one step
Qquit rega

On a Mac keyboard, the F keys may need Fn. The card starts from the first step each time.

The images

Every image explains itself in its comments attribute: open the metadata pane (2) to read it. The same list is in README.txt next to them.

FileWhat it showsTry
shot.####.exrframes 1001-1100 at 24 fps; layers rgba (R G B A, plus depth Z), N, albedo, diffuse, mask, specularspace to play, [ ], t
wip.####.exra render still being written: frames 1006-1008 and 1015 missing, the last one cut shortopen it, space to play, G
chart.exra colour chart over a linear grey wedgeCtrl+click a patch
chart-v2.exrthe chart with two patches changedin the browser, space on chart.exr and on this one, then d
hdr-sky.exrvalues far above 1E to stop down
luma-ramp.exra single channel (Y)y / Y gamma, s view transform off
beachball.exra data window (a box around a beach ball) inside the display windoww
nan-inf.exrNaN and inf pixels!

Every clip in this guide uses these images, so you can follow along.