The darkroom view is where you develop a single image. The center area shows the picture currently being edited; the left panel holds peripheral tools (navigation, scopes, snapshots, history…), and the right panel holds the image-processing modules.

Open the darkroom from the lighttable by double-clicking a thumbnail, or by selecting an image and pressing Enter. Return to the lighttable with Escape (or the home button in the header). You can switch to another image without leaving the darkroom by enabling the filmstrip (Ctrl+Shift+F) and clicking a thumbnail in it.

How an image is processed is the subject of the pixelpipe and modules sections; this page and the darkroom layout page cover the view itself.

Zoom and pan

Middle-click the center area to step through fit to screen, 100%, 200%, 400% and 800%, then back to fit to screen.

Scroll with the mouse wheel to zoom gradually, from a third of the fit-to-screen size up to 1600%; the zoom stops on fit to screen as it passes it. Both the middle click and the scroll zoom around the point under the pointer. When zoomed in past the window, drag the image to pan.

From the keyboard, Ctrl+0 (⌘+0 on macOS) fits the image to the window, and Ctrl+1 (⌘+1 on macOS) shows it at 100%, both around the center of the view. They are the Zoom to fit and Zoom to 100% actions under Darkroom/Main image, which can be rebound in the shortcuts window.

Working with modules

The image-processing modules in the right panel are organized into workflow tabs that follow the order of the pixelpipe. The recommended way to edit is to move through the tabs from left to right, and through each module stack from bottom to top.

Modules and their controls are fully navigable from the keyboard, and any module or control can be reached directly through the global action search (Ctrl+P) or an assigned shortcut. The anatomy of a module page explains the common module controls (enable, reset, presets, multiple instances, masking & blending).

Picking colors on the image

Many modules have a color picker button next to the control it sets, and the scopes module holds the global color picker, which only reads values. All of them sample the image with the same gestures.

Click a picker’s button to turn it on, then, on the image:

  • Click: sample the point under the pointer.
  • Drag: draw a rectangle and sample the area inside it.
  • Drag a corner of the rectangle: resize the area.

The picker stays on, and every click or drag samples again, until you click its button a second time or turn on another picker. The next time it is turned on, it shows the point or the area it held last.

What a picker accepts depends on what its module does with the sample:

  • A picker that averages the sample takes a point or an area. This is the case in exposure, color calibration and drawing, for the left-hand picker of the curve and color zones graphs, and for the global color picker.
  • Other pickers always sample an area, among them all those that search the sample for its darkest or brightest pixel, like the white relative exposure and black relative exposure pickers of filmic. A click then leaves a small square around the pointer instead of a point.
  • A picker that reads a single color, like those of levels, takes a point only. A drag moves that point.

Picking with a modifier key

Hold Ctrl (⌘ on macOS) while the pointer is over the image to pick without going to a picker’s button. Whenever a color can be picked this way, the pointer becomes a cross: a click samples a point and a drag samples an area. The picker turns off when you release the key, and the pointer goes back to the tool it had before.

The sample goes to the picker displayed by the module that has the focus:

  • If the module displays one picker, that picker receives the sample. This sets the exposure in exposure, the illuminant on the CAT tab of color calibration, and the brush color in drawing.
  • If the module displays several pickers, as the scene tab of filmic does, the key does nothing because nothing tells which picker is meant. The pointer keeps its shape, and the pickers are used from their buttons.
  • If the module displays no picker, or if no module has the focus, the global color picker receives the sample, provided its Color picker section is unfolded in the scopes module. A module that uses clicks on the image for a tool of its own keeps them instead.

Only the pickers visible on screen count: a picker on another tab of the module, or in a folded section, is ignored. The two pickers of the parametric mask never count, so a module that has a mask still picks for its own control.

The key does not pick while a picker turned on from its button is active, since that picker keeps receiving the clicks, nor while the shapes of a drawn mask are displayed on the image, where the clicks belong to the shapes.

Autoset: auto-developing an image

Some modules can compute their own settings from the content of the image instead of relying on a fixed default. The autoset button in the bottom toolbar runs this automatic computation on several modules at once, giving you a sensible starting point that you then refine by hand.

Right-click the autoset button to open a list of the modules that support it, and tick the ones you want it to act on. Capable modules include:

flowchart LR
    A([Click autoset]) --> B{For each
ticked module} B --> C[Module analyzes
the image] C --> D[Module writes
its own settings] D --> E([Refine by hand])

Autoset runs in the background and processes the modules one after another (the button shows a busy state while it works). Each module’s result is recorded in the history like any other change, so you can undo it or tweak it afterwards.

On-image overlays and assessment

The bottom toolbar gives quick access to the visual assessment overlays: ISO 12646 color assessment, raw overexposed and clipping warnings, soft-proofing, gamut checking, and guides & overlays. The quick-access styles menu is also there.