Applies to v1.1.0+ 14 min read
02 / User Manual

Density Limits, Darkroom Printer Lights, Tone Curves, and Detail Enhancement

Mastering D-Min/D-Max physical density bounds, logarithmic printer light principles, monotonic spline curves, and high-frequency detail preservation.

# Film Modes, Auto Inversion, and Whole-Roll Batch Inversion

NexFilm's darkroom inversion engine physically decouples the unique chemistry of monochrome emulsions from multi-layer color couplers. Upon entering the Develop workspace, the mode selector and inversion controls at the top of the inspector govern how raw negative transmission data maps into positive print tones:

  • Color Mode: Engineered specifically for chromogenic color negative films featuring integral orange dye couplers. The engine engages a three-channel logarithmic decoupling pipeline: it calculates unexposed film base density, shifts this reference value to zero density, and reconstructs the positive image using spectral dye uncoupling matrices.
  • B&W Mode: Switching to B&W collapses three-channel RGB data into a unified, single-channel optical density representation, disabling color mask subtraction routines. Designed for authentic silver gelatin emulsions such as Ilford HP5 Plus, Kodak Tri-X, and Fomapan, this mode eliminates chromatic fringing and color staining on monochrome negatives.

The Actions panel provides three primary triggers:

  1. Auto Invert: Targets the active individual frame. The solver analyzes density distributions strictly within the designated Film Area, measures localized film base offsets, calculates optimal density boundaries, and commits all resulting color and curve parameters to the frame history.
  2. Auto Invert Roll: This option remains hidden or disabled by default. It unlocks exclusively after completing Calibrate Film Base / Leader within the Library grid. Because the active roll possesses authentic physical anchors for both the unexposed base and the exposed leader, Auto Invert Roll measures the brightest frame across the entire roll as a unified highlight anchor. It then processes all remaining frames under identical physical baselines, skipping calibration references to prevent intra-roll density shifts.
  3. Reset: Clears all color balancing, printer light offsets, tone curves, and detail parameters on the active frame, returning the preview to its raw negative state. Reset alters only color pipeline parameters, leaving your custom Film Area polygon and perspective crop untouched.

# Density Limits (D-Min / D-Max) Physical Meaning and Calibration

In classical sensitometry, optical density (DD) measures the logarithmic light-stopping power of an emulsion layer:

D=−log⁡10(T)D = -\log_{10}(T)

where TT represents optical transmittance. Clear, unexposed negative film base permits maximum light passage, defining minimum optical density (Dmin⁡D_{\min}). Conversely, heavily exposed and fully developed silver or dye clouds absorb substantial light, establishing maximum optical density (Dmax⁡D_{\max}). Inverted into a positive image, Dmin⁡D_{\min} governs deep shadow foundation density, while Dmax⁡D_{\max} defines the highlight ceiling.

The Density Limits module provides direct control over these physical endpoints:

  • Master D-Min (Range: -0.50 to +0.50): Controls the threshold of printable positive black. Advancing Master D-Min toward positive values shifts shadow density thresholds deeper into rich, solid blacks. Moving toward negative values lifts shadow compression, recovering subtle shadow details and analog texture.
  • Master D-Max (Range: -0.50 to +0.50): Regulates the highlight shoulder compression. Moving positive extends highlight dynamic capacity, safeguarding bright cloud textures from digital clipping. Compressing Master D-Max negative tightens overall print contrast, producing punchier tones.
  • Three-Channel Density Readouts: The digital indicators below the sliders display the actual measured physical densities across Red, Green, and Blue channels. Disparities among channel spans highlight emulsion aging or underexposure, allowing targeted per-channel endpoint corrections.

# Darkroom Printer Lights Logarithmic Color Balance Laws

In an optical darkroom, color printing utilizes dichroic filters inside an enlarger head—Cyan, Magenta, and Yellow—to modulate the color quality of light striking photographic paper. The Printer Lights module in NexFilm mathematically models this physical enlarger behavior within the digital density domain.

Unlike standard RGB linear gain sliders found in general photo editors, NexFilm's printer lights operate logarithmically on optical density. Adjusting printer lights mimics changing the exposure duration and filtration balance through dichroic glass filters.

The lookup table below outlines color cast diagnostics and printer light correction pathways:

Observed Positive Color CastUnderlying Physical ImbalanceRecommended Printer Light ActionDarkroom Enlarger Equivalent
Overall Cyan TintInsufficient red channel transmission density; red wavelength deficiency.Increase Red Printer Light (+)Reduce cyan filtration in enlarger head to admit more red light.
Overall Red TintExcessive red transmission; inadequate cyan absorption.Decrease Red Printer Light (-)Increase cyan filtration to absorb excess red wavelengths.
Overall Magenta TintGreen transmission obstructed; excess magenta couplers.Increase Green Printer Light (+)Reduce magenta filtration to inject more penetrating green exposure.
Overall Green TintExcess green transmission; magenta dye overcompensation.Decrease Green Printer Light (-)Increase magenta filtration to absorb surplus green light.
Overall Yellow TintBlue transmission attenuated; excess yellow dye baseline.Increase Blue Printer Light (+)Reduce yellow filtration to allow more blue exposure onto paper.
Overall Blue TintSurplus blue transmission; yellow component washed out.Decrease Blue Printer Light (-)Increase yellow filtration to absorb excess blue, warming the image.

The upper right corner houses the WB Dropper tool. Activating the dropper and clicking an area representing neutral grey (such as unshaded asphalt, weathered concrete, or neutral fabric) calculates the spectral deviation from neutrality. The engine converts this delta into exact logarithmic exposure offsets across Red, Green, and Blue channels, adjusting the printer light sliders without altering base calibration data.

# Tone Curves and Detail Enhancement

In the rendering sequence, Tone Curves and Detail occupy precise positions: curves operate downstream of printer lights and before global look adjustments, while detail enhancement operates at the end of the chain before final export serialization. Neither affects raw density calculations.

1. Four-Channel Monotonic Spline Curves

NexFilm features a complete four-channel curve editor consisting of a composite RGB Master Curve alongside independent Red, Green, and Blue Channel Curves.

  • Monotonic Spline Interpolation: Curves use monotonic cubic Hermite splines. Regardless of how close control points are placed, the curve remains strictly monotonic, eliminating artificial ripple artifacts, highlight dips, or out-of-gamut oscillations outside the 0.0 to 1.0 range.
  • Interaction Guidelines:
    • Click on empty curve space to insert a control point (up to 16 points per channel);
    • Right-click any control point to delete it;
    • Boundary endpoints are locked horizontally at 0 and 1, moving vertically to lift black points or compress highlight white points;
    • Dragging an endpoint horizontally across a threshold pulls out a new mobile intermediate control point;
    • The "Reset Channel" button restores the active channel to a linear diagonal;
    • A real-time histogram renders behind the curve grid to guide tone adjustments.

2. Aesthetic Look Adjustments

Provides standard creative adjustments:

  • Exposure: Shifts midtone brightness logarithmically across stops (EV);
  • Gamma & Contrast: Modulates midtone tone contrast while anchoring endpoints;
  • Highlights & Shadows: Mitigates specular highlight clipping and recovers dense shadow detail;
  • Saturation: Enhances color purity within a perceptually uniform color space to avoid clipping;
  • Temperature & Tint: Offers subtle warm-cool Kelvin balancing adjustments.

3. Detail and Spatial Frequency Sharpening

The detail module features sharpening and local contrast controls:

Control ParameterFunctional Description and Mathematical FormulationAdjustable Value Range
AmountTotal sharpening intensity. At 0, the sharpening pass is completely bypassed at the hardware level, passing raw pixels unsharpened.0 – 150 (Default: 40)
RadiusSpatial convolution kernel footprint. Controls edge transition width; smaller values enhance fine textures, while larger values delineate broad contours.0.5 – 3.0 px (Default: 1.0)
DetailFrequency weighting between micro-textures and primary edges. Low values confine sharpening to pronounced edges; high values emphasize film grain.0 – 100 (Default: 25)
MaskingEdge detection threshold. At 0, sharpening applies uniformly. At higher values, smooth skies and out-of-focus backgrounds are excluded to avoid magnifying scanner noise.0 – 100 (Default: 0)
TextureMid-frequency local contrast adjustment, ideal for rendering fabrics, foliage, and skin textures.-100 – +100
ClarityBroad-scale local contrast enhancement weighted toward midtones, avoiding shadow crushing.-100 – +100
DehazeDark-channel prior physical model estimating optical transmission to cut through lens flare and atmospheric haze.-100 – +100
Live Grayscale Masking via the Alt Key

Holding the Alt key while dragging sharpening sliders transforms the canvas into an analytical diagnostic view:

  • Dragging Amount, Radius, or Detail displays the isolated high-frequency edge signal on a neutral grey field;
  • Dragging Masking displays the binary edge detection mask (black areas receive no sharpening; white lines indicate protected sharpened edges). Releasing the key returns the canvas to standard color rendering without interrupting scopes or thumbnail caches.

All sharpening, texture, and clarity parameters standardize their physical convolution radii to an image long edge of 2560 px. Consequently, the sharpening balance viewed on the 2560 preview proxy translates with total pixel parity to multi-megapixel master exports.

# Scopes System and Highlight / Shadow Clipping Alerts

The scopes in the upper right corner provide real-time objective monitoring:

  • Histogram Mode: Shows pixel tone distribution from pure black (0) to white (255), illustrating channel overlaps;
  • Waveform Mode: Displays vertical luminance distribution across the horizontal image plane, pinpointing localized specular hotspots;
  • Channel Filters: Toggles between composite RGB, individual Red/Green/Blue channels, and pure Luminance Y;
  • Clipping Warning Handles: Exclamation point threshold handles illuminate when pixels exceed dynamic range boundaries, alerting you to highlight burnout or crushed blacks.

# Copy Settings, Paste Settings, and Batch Apply Boundaries

Managing color across dozens of roll captures requires clear operational boundaries between parameter replication tools:

DimensionBatch ApplyCopy Settings / Paste Settings
Interface LocationTop canvas geometry toolbar.Top of the right inspector.
Parameters TransferredFilm Area polygon coordinates and sprocket hole positions.Selected grading parameters: density, printer lights, curves, look, and detail.
Target Frame CalibrationRe-measures localized film base and light table transmission independently.Applies values directly without altering target film boundaries or base readings.
Ideal Use CaseRigid copy stand capture runs where negative positioning remains fixed across frames.Different exposures sharing identical lighting conditions requiring uniform print aesthetics.

Clicking Copy Settings loads all current parameters into the memory clipboard. When selecting Paste Settings on target frames, a selective paste dialog appears:

  • Quick presets include:
    1. All available settings: Commits all parameters across the board;
    2. Tone and color (Default): Synchronizes density limits, printer lights, look, and tone curves, excluding crop and detail sharpening;
    3. Geometry only: Applies rotation, flipping, straighten, and perspective corrections.
  • Users can selectively toggle 27 individual settings (including filmMode, printerLights, curve, sharpen, and lut) for precise control.

Avoid using Batch Apply across frames captured under varying lighting. For consistent lighting conditions, selective Paste Settings provides the most reliable darkroom results.