Dark Room (All) gathers the adjustments a photographer makes to a picture in one panel: the light (exposure, contrast, highlights, shadows, whites, blacks and a tone curve), the color (white balance, vibrance, saturation, a color mixer, point color and color grading), the effects (texture, clarity, dehaze, vignette and grain), a calibration of the primaries, and the lens corrections (chromatic aberration, distortion and vignetting). A histogram above the controls follows every change, and a live preview shows the result on the image before Apply.

Categories
  • Image Adjustments
Keywords
  • dark room
  • image adjustments
  • develop
  • adjustments
  • exposure
  • contrast
  • highlights
  • shadows
  • whites
  • blacks
  • tone curve
  • white balance
  • temperature
  • tint
  • vibrance
  • saturation
  • color mixer
  • point color
  • color grading
  • texture
  • clarity
  • dehaze
  • vignette
  • grain
  • calibration
  • chromatic aberration
  • distortion
  • black and white
  • histogram
  • HDR

1Introduction

Dark Room (All) is made for stretched images, the kind we look at: the controls act on the values as they are, the way a photo editor acts on a picture. A linear image still goes through it, but it is very dark, and the panel says so. We stretch it first, with Hyperbolic Stretch, Arcsinh Stretch or Histogram, and develop it afterwards.

Every control is at no change by default, and a control that is at its default does nothing, not even a rounding: with all of them at their defaults the image comes out exactly as it went in. Mono and color images both work; on a gray image the color controls do nothing and the Log says so. The alpha channels are not touched.

1.1One section at a time

Each section of the panel but Profile and the tone curve is also a process of its own in Process > Image Adjustments, with the histogram above its controls: Color Grading, Color Light, Color Mixer, Grain, Local Contrast, Manual Color Calibration, Optics, Point Color, Vignette and White Balance. Each runs the same engine with the other sections at no change, so its result is what this panel gives with the same settings, and its settings have the same ids, so a value means the same in both.

1.2The order of the work

The stages always run in this order, whatever order we touched the controls in:

  1. White balance and exposure. A gain for each channel: the gains of Temp and Tint, or of Auto, and the gain of Exposure.
  2. Tone. One function for each channel: Whites and Blacks set the white and the black point, a smooth curve through knots moved by Contrast, Shadows and Highlights follows, then the tone curve of the three channels together, and the curve of the channel.
  3. Color. The calibration (the primaries and the shadows tint), then Vibrance and Saturation, the Color Mixer and Point Color, and last the Color Grading. The Black & White profile replaces all of it but the grading with the gray mix of the Color Mixer's Luminance sliders.
  4. Effects. Texture, Clarity and Dehaze, which look at the neighbors of each pixel, then the Vignette.
  5. Optics. The chromatic aberration fit and Distortion in one resampling of the image, then the lens Vignetting.
  6. Grain. Last, so that the grain is not changed by anything else.

The sizes of Texture, Clarity and Dehaze follow the size of the whole image, so the live preview of a part of the image, and of the image reduced in the window, shows what Apply gives there. What the whole image decides, the Auto white balance, the haze level of Dehaze and the chromatic aberration fit, is measured once on the whole image.

The Dark Room (All) panel
The Dark Room (All) panel above its sections, with the histogram, the buttons and the tone curve.

2Quick Start

  1. Open a stretched image and choose Process > Image Adjustments > Dark Room (All).
  2. Click Auto: the panel sets the light from the image's levels. Turn on the live preview (the eye) to see it on the image.
  3. Open Color Light and White Balance and move the sliders. A slider and its value change together, and a value can be typed.
  4. Open the other sections for the effects, the color mixer and the lens corrections.
  5. Click Apply. The result is one history step that Undo takes back.

3Interface & Parameters

Above the sections there is the histogram of the image as the controls would make it, in red, green, blue and in the luminance, and four buttons. The sections are the ones below; each folds away with the arrow beside its title, and the panel remembers which are open. The system bar along the bottom has the usual commands.

Auto: Sets Exposure, Contrast, Highlights, Shadows, Whites, Blacks and Vibrance from the levels of the image: the exposure that brings the middle gray to the middle of the range, the white and black points at the ends of the levels, the shadows and highlights opened if they are crowded, and a little vibrance for a pale image. The other controls are left as they are.

B&W: Switches the Profile to Black & White.

HDR: A preset: Shadows 60, Highlights -60, Clarity 25 and Dehaze 15. The other controls are left as they are.

Reset: Puts every control back to no change: the sliders, the curves and the picked colors.

Each section also has a small reset button at the right of its title. It puts only that section's controls back to their defaults, leaves the other sections as they are, and is dimmed while the section is at its defaults.

3.1Profile

Profile: Color keeps the colors. Black & White makes the image gray. Each pixel keeps its luminance, changed by the Color Mixer's Luminance sliders for the range its color is in: with Red Luminance raised the reds are lighter in the gray, as with a red filter. In this profile Vibrance, Saturation, the Hue and Saturation of the Color Mixer, Point Color and the calibration do nothing.

3.2Color Light

Exposure: Brightens or darkens the whole image, from -5 to 5 stops, 0 by default. A stop is a doubling of the light of an image with a 2.2 gamma, so +1 multiplies every value by about 1.37. Values pushed past white are clipped unless Whites gives them room.

Contrast: From -100 to 100. Positive darkens the darker tones and brightens the brighter ones around the middle; negative flattens them.

Highlights: From -100 to 100. Positive brightens the bright tones, negative recovers them, leaving the dark ones.

Shadows: From -100 to 100. Positive brightens the dark tones, negative deepens them, leaving the bright ones.

Whites: From -100 to 100. Moves the white point. Positive makes the brightest tones white sooner (+100: everything from 0.75 up); negative gives them room, so that tones pushed past white by Exposure come back.

Blacks: From -100 to 100. Moves the black point. Positive lifts the darkest tones; negative makes them black sooner (-100: everything up to 0.15).

The tone is a smooth, rising function of the value: whatever the five sliders say, a darker value never comes out lighter than a brighter one.

3.3Tone curve

The curve editor of the program, in a section of its own: a button for the three channels together (RGB) and one each for red, green and blue. A click on the curve adds a point, a drag moves it, a double-click or Del removes it, and the fields below take exact values. Reset Curve puts the curve on the diagonal again. The histogram of the image shows behind it.

Tone curve: The points of the curve of the three channels together, from (0,0) to (1,1) for no change. It applies after the sliders above.

Red curve: The points of the red channel's curve, applied after the tone curve.

Green curve: The points of the green channel's curve.

Blue curve: The points of the blue channel's curve.

Curve interpolation: How the curves go through their points: Akima subspline (the default; a curve of fewer than four points is a cubic spline), Cubic spline or Linear. All four curves use the same.

A gray image takes the curve of the three channels together alone.

3.4White Balance

White balance: As Shot leaves the colors as they are. Auto balances them to a gray average, measured on the whole image over the pixels that are neither black nor white; the brightness is kept. Custom uses Temp and Tint. Choosing As Shot or Auto sets Temp and Tint back to 0, and moving Temp or Tint under As Shot makes the white balance Custom. Under Auto, Temp and Tint adjust the automatic result.

Temp: From -100 to 100. Positive warms the image (more red, less blue), negative cools it.

Tint: From -100 to 100. Positive moves the image toward magenta, negative toward green.

Pick Neutral, under the histogram, takes a neutral point from the image: we click a gray or white place of the image and the white balance becomes Custom, with the Temp and Tint that make it neutral. It samples 5 by 5 pixels, so one noisy pixel does not decide. A gray image has no color to balance and the button is off.

Vibrance: From -100 to 100. Changes the saturation of the muted colors more than that of the vivid ones, so a pale image gains color without the strong colors going garish.

Saturation: From -100 to 100. Changes the saturation of every color alike; -100 makes the image gray. The luminance is kept.

3.5Color Mixer

Eight ranges of color: red, orange, yellow, green, aqua, blue, purple and magenta, centered on those hues, with soft edges, so a color between two ranges is moved by both. Grays are not moved, however strong the sliders are.

Red Hue: From -100 to 100. Turns the colors of the red range toward the next color on either side, up to 30 degrees.

Orange Hue: From -100 to 100. Turns the colors of the orange range toward the next color on either side, up to 30 degrees.

Yellow Hue: From -100 to 100. Turns the colors of the yellow range toward the next color on either side, up to 30 degrees.

Green Hue: From -100 to 100. Turns the colors of the green range toward the next color on either side, up to 30 degrees.

Aqua Hue: From -100 to 100. Turns the colors of the aqua range toward the next color on either side, up to 30 degrees.

Blue Hue: From -100 to 100. Turns the colors of the blue range toward the next color on either side, up to 30 degrees.

Purple Hue: From -100 to 100. Turns the colors of the purple range toward the next color on either side, up to 30 degrees.

Magenta Hue: From -100 to 100. Turns the colors of the magenta range toward the next color on either side, up to 30 degrees.

Red Saturation: From -100 to 100. Changes the saturation of the colors of the red range.

Orange Saturation: From -100 to 100. Changes the saturation of the colors of the orange range.

Yellow Saturation: From -100 to 100. Changes the saturation of the colors of the yellow range.

Green Saturation: From -100 to 100. Changes the saturation of the colors of the green range.

Aqua Saturation: From -100 to 100. Changes the saturation of the colors of the aqua range.

Blue Saturation: From -100 to 100. Changes the saturation of the colors of the blue range.

Purple Saturation: From -100 to 100. Changes the saturation of the colors of the purple range.

Magenta Saturation: From -100 to 100. Changes the saturation of the colors of the magenta range.

Red Luminance: From -100 to 100. Brightens or darkens the colors of the red range. With the Black & White profile it is how much of this color goes into the gray.

Orange Luminance: From -100 to 100. Brightens or darkens the colors of the orange range. With the Black & White profile it is how much of this color goes into the gray.

Yellow Luminance: From -100 to 100. Brightens or darkens the colors of the yellow range. With the Black & White profile it is how much of this color goes into the gray.

Green Luminance: From -100 to 100. Brightens or darkens the colors of the green range. With the Black & White profile it is how much of this color goes into the gray.

Aqua Luminance: From -100 to 100. Brightens or darkens the colors of the aqua range. With the Black & White profile it is how much of this color goes into the gray.

Blue Luminance: From -100 to 100. Brightens or darkens the colors of the blue range. With the Black & White profile it is how much of this color goes into the gray.

Purple Luminance: From -100 to 100. Brightens or darkens the colors of the purple range. With the Black & White profile it is how much of this color goes into the gray.

Magenta Luminance: From -100 to 100. Brightens or darkens the colors of the magenta range. With the Black & White profile it is how much of this color goes into the gray.

3.6Point Color

A shift for one color of the image and the colors near it. Pick Color, under the histogram, takes the color from the image: we click it (a mean of 5 by 5 pixels), the swatch beside the button shows it, and the shifts below apply to it. Clear forgets it, and Point Color does nothing.

Point color: Whether a color has been picked. It is set by Pick Color and Clear.

Picked red: The red of the picked color, from 0 to 1.

Picked green: The green of the picked color, from 0 to 1.

Picked blue: The blue of the picked color, from 0 to 1.

Hue shift: From -100 to 100. Turns the picked color, up to 30 degrees.

Saturation shift: From -100 to 100. Changes the saturation of the picked color.

Luminance shift: From -100 to 100. Brightens or darkens the picked color.

Range: From 0 to 100, 50 by default. How far from the picked color, in hue, saturation and brightness, the shifts reach. Small keeps to that color; large takes in its neighbors, with a soft edge.

3.7Color Grading

A tint and a brightness for the shadows, the midtones and the highlights, and one for the whole image. The three tone ranges are cut from the luminance of the pixel and run into each other.

Shadows Hue: The hue of the tint of the shadows, from 0 to 360 degrees.

Shadows Saturation: How strong the tint of the shadows is, from 0 to 100, 0 by default (no tint).

Shadows Luminance: Brightens or darkens the shadows, from -100 to 100.

Midtones Hue: The hue of the tint of the midtones, from 0 to 360 degrees.

Midtones Saturation: How strong the tint of the midtones is, from 0 to 100, 0 by default (no tint).

Midtones Luminance: Brightens or darkens the midtones, from -100 to 100.

Highlights Hue: The hue of the tint of the highlights, from 0 to 360 degrees.

Highlights Saturation: How strong the tint of the highlights is, from 0 to 100, 0 by default (no tint).

Highlights Luminance: Brightens or darkens the highlights, from -100 to 100.

Global Hue: The hue of the tint of the whole image, from 0 to 360 degrees.

Global Saturation: How strong the tint of the whole image is, from 0 to 100, 0 by default (no tint).

Global Luminance: Brightens or darkens the whole image, from -100 to 100.

Blending: From 0 to 100, 50 by default. How softly the three ranges run into each other.

Balance: From -100 to 100. Moves the boundary between the shadows and the highlights: positive gives the shadows more of the tones, negative gives more to the highlights.

3.8Local Contrast

Texture, Clarity and Dehaze work on the luminance and add the change to all the channels, so the colors do not shift.

Texture: From -100 to 100. Strengthens (positive) or smooths (negative) the fine detail, which is the difference between each pixel and its neighborhood of a few pixels. Strong edges are limited, so they do not ring.

Clarity: From -100 to 100. Strengthens or softens the contrast of the larger structures, over a neighborhood of about one percent of the image, mostly in the midtones.

Dehaze: From -100 to 100. Positive removes haze: the haze level is read from the brightest of the dark channel of the whole image, the veil is estimated over a neighborhood of about two percent of the image, and what it adds is taken away. Negative adds a uniform veil of that level.

3.9Vignette

Style: How the vignette is made. Highlight blends the edges toward black (or toward white when the amount is positive) and can keep the bright tones, as Highlights says. Color scales the three channels by the same amount, so the colors keep their proportions. Paint blends black or white over the image with the overlay blend.

Vignette: From -100 to 100. Negative darkens the edges, positive lightens them. The vignette is centered on the image's frame, and the center is not changed.

Midpoint: From 0 to 100, 50 by default. How far from the center the vignette starts; lower starts it nearer the center. It is off while Vignette is 0.

Feather: From 0 to 100, 50 by default. How softly the vignette fades in. It is off while Vignette is 0.

Roundness: From -100 to 100. The shape of the vignette: 0 follows the frame's ellipse, positive goes toward a circle, negative toward a rectangle. It is off while Vignette is 0.

Highlights: From 0 to 100, 0 by default. How much of the bright tones the Highlight style keeps from the vignette. It is off while Vignette is 0.

3.10Grain

The grain is the same wherever it is drawn: it depends on the position in the image and on the seed, so the live preview, a part of the image and Apply show the same grain, and it is the same every time.

Amount: From 0 to 100, 0 by default. How strong the grain is. The grain is the same in the three channels and is stronger in the midtones than in the darkest and the brightest tones.

Size: From 0 to 100, 25 by default. How large the grain is, from single pixels to about six pixels.

Roughness: From 0 to 100, 50 by default. How uneven the grain is: smooth at 0, with the crisp single-pixel component at 100.

Seed: The pattern of the grain. The same seed gives the same grain.

3.11Manual Color Calibration

Shadows Tint: From -100 to 100. Moves the shadows toward magenta (positive) or green (negative), more where the image is darker.

Red Primary Hue: From -100 to 100. Turns the red primary toward the next color on either side, so every color made with red moves with it. A gray stays gray.

Red Primary Saturation: From -100 to 100. Makes the red primary more or less pure.

Green Primary Hue: From -100 to 100. Turns the green primary toward the next color on either side, so every color made with green moves with it. A gray stays gray.

Green Primary Saturation: From -100 to 100. Makes the green primary more or less pure.

Blue Primary Hue: From -100 to 100. Turns the blue primary toward the next color on either side, so every color made with blue moves with it. A gray stays gray.

Blue Primary Saturation: From -100 to 100. Makes the blue primary more or less pure.

3.12Optics

The lens corrections here are the ones we can make from the image itself. There is no lens database in the program, so there is no Enable Lens Corrections that looks the lens up: Distortion and Vignetting are set by hand.

Remove Chromatic Aberration: Off by default. Fits the color fringes of a lens across the whole image: the red and the blue channel are each a little larger or smaller than the green one, more toward the corners, and the fit finds by how much from the edges of the image (the correlation of the edges of the channels over the outer part of the image, to a few hundredths of a percent). It then resamples the red and the blue channel onto the green one. When the image has no such fringes the fit finds none and the image is not touched.

Distortion: From -100 to 100. Positive bulges the image outward (barrel), negative pulls it in (pincushion); at 100 the corners move by 15 percent of the distance from the center to a corner. The corners may then show the edge pixels stretched, which a crop takes away.

Vignetting: From -100 to 100. Positive lightens the corners, to correct a lens's vignetting; negative darkens them.

Midpoint: From 0 to 100, 50 by default. How far from the center the vignetting correction starts. It is off while Vignetting is 0.

3.13Apply, Preview and Instance

Live preview (the eye): At the end of the Applies to row; Preview in the system bar is the same switch. The image shows the result on the part in view, with the banner "PREVIEW only, nothing applied". Texture, Clarity, Dehaze, the vignettes, Distortion and the chromatic aberration are computed with a margin around the part, so at 100 percent and above the preview is what Apply gives there.

Applies to: The image the process works on, chosen in a list of the open images. It shows the image in front, and follows it as we bring other images to the front.

Apply: Adjusts the image named in Applies to, in one history step that Undo takes back, through the image's mask if it has one and within its selection. Integer images are written back inside their range.

Instance: Shows the process as the panel has it now, as text, a DSPX process (.dsproc). Copy puts the text on the clipboard; Save... saves it as a file and puts it on the Process Shelf. The tone curve and the picked colors are saved with the rest. Dark Room (All) is our own process, so it has no equivalent in PixInsight and no PixInsight icon.

Reset: Puts every setting back to its default.

4Usage Tips and Tricks

Stretch first. The controls are made for the values of a stretched image. The panel says when the image looks linear.

Start with Auto, then change one thing at a time. The histogram follows each change, so a slider that is pushing the levels against the ends shows it at once.

Whites and Blacks before Highlights and Shadows. The two points set the ends of the range; the other two shape what is between them.

A cast in the background. Pick Neutral on a patch of sky that should be gray, then look at the color of the rest. Color Calibration does the same job with the stars as the reference, on a linear image.

Several looks. The panel's settings are a process: we save one, put it on the Process Shelf and drop it on other images, or put it in a process container with other steps.

Grain after the last resize. Grain is drawn at the pixels of the image it runs on, so we add it as the last step, after any resampling.

The processes of one section each, in Process > Image Adjustments: Color Grading, Color Light, Color Mixer, Grain, Local Contrast, Manual Color Calibration, Optics, Point Color, Vignette and White Balance.

Curves: curves for the channels, the lightness, the chroma, the hue and the saturation, with no sliders.

Histogram: the black point, the midtones and the white point by hand, and the stretch of a linear image.

Saturation: a saturation curve over the hue.

SCNR: removes a green cast.

HDR Compression: a stronger way to bring a very wide range into view.

Clarity: local contrast of the larger structures, with the controls of a sharpening process.