# 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:
- 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.
- 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.
- 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 () measures the logarithmic light-stopping power of an emulsion layer:
where represents optical transmittance. Clear, unexposed negative film base permits maximum light passage, defining minimum optical density (). Conversely, heavily exposed and fully developed silver or dye clouds absorb substantial light, establishing maximum optical density (). Inverted into a positive image, governs deep shadow foundation density, while 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 Cast | Underlying Physical Imbalance | Recommended Printer Light Action | Darkroom Enlarger Equivalent |
|---|---|---|---|
| Overall Cyan Tint | Insufficient red channel transmission density; red wavelength deficiency. | Increase Red Printer Light (+) | Reduce cyan filtration in enlarger head to admit more red light. |
| Overall Red Tint | Excessive red transmission; inadequate cyan absorption. | Decrease Red Printer Light (-) | Increase cyan filtration to absorb excess red wavelengths. |
| Overall Magenta Tint | Green transmission obstructed; excess magenta couplers. | Increase Green Printer Light (+) | Reduce magenta filtration to inject more penetrating green exposure. |
| Overall Green Tint | Excess green transmission; magenta dye overcompensation. | Decrease Green Printer Light (-) | Increase magenta filtration to absorb surplus green light. |
| Overall Yellow Tint | Blue transmission attenuated; excess yellow dye baseline. | Increase Blue Printer Light (+) | Reduce yellow filtration to allow more blue exposure onto paper. |
| Overall Blue Tint | Surplus 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 Parameter | Functional Description and Mathematical Formulation | Adjustable Value Range |
|---|---|---|
| Amount | Total sharpening intensity. At 0, the sharpening pass is completely bypassed at the hardware level, passing raw pixels unsharpened. | 0 – 150 (Default: 40) |
| Radius | Spatial 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) |
| Detail | Frequency weighting between micro-textures and primary edges. Low values confine sharpening to pronounced edges; high values emphasize film grain. | 0 – 100 (Default: 25) |
| Masking | Edge 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) |
| Texture | Mid-frequency local contrast adjustment, ideal for rendering fabrics, foliage, and skin textures. | -100 – +100 |
| Clarity | Broad-scale local contrast enhancement weighted toward midtones, avoiding shadow crushing. | -100 – +100 |
| Dehaze | Dark-channel prior physical model estimating optical transmission to cut through lens flare and atmospheric haze. | -100 – +100 |
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:
| Dimension | Batch Apply | Copy Settings / Paste Settings |
|---|---|---|
| Interface Location | Top canvas geometry toolbar. | Top of the right inspector. |
| Parameters Transferred | Film Area polygon coordinates and sprocket hole positions. | Selected grading parameters: density, printer lights, curves, look, and detail. |
| Target Frame Calibration | Re-measures localized film base and light table transmission independently. | Applies values directly without altering target film boundaries or base readings. |
| Ideal Use Case | Rigid 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:
- All available settings: Commits all parameters across the board;
- Tone and color (Default): Synchronizes density limits, printer lights, look, and tone curves, excluding crop and detail sharpening;
- Geometry only: Applies rotation, flipping, straighten, and perspective corrections.
- Users can selectively toggle 27 individual settings (including
filmMode,printerLights,curve,sharpen, andlut) 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.