Lens Debaser 1.57 · User guide

LensDebaserOFX

Lens Debaser is an Apple-Silicon Metal/OpenFX effect for DaVinci Resolve. It can add spatial, chromatic, tonal, and highlight character to your too-perfect footage.

Because all cameras are good now. Too good. So I made this for you to debase perfectly good optics in post - because perfect modern optics is for OnlyFans - not for ABSOLUTE CINEMA!

DEBASE PERFECTLY GOOD OPTICS IN POSTGet Lens Debaser now

WORK IN PROGRESS

Experimental software

Lens Debaser is under active development. Features, controls, presets, results, compatibility and performance may change without notice. Parts of the plugin may break, behave unexpectedly, or not work entirely as described in this guide.

Lens Debaser is not a scientific ray tracer. It uses perceptually useful approximations of lens effects rather than attempting mathematically exact optical simulation. The aim is to produce convincing, controllable results while keeping render times practical for post-production and color-grading workflows.

The software and this guide are provided as is and as available, without warranties of any kind, express or implied. To the fullest extent permitted by applicable law, the authors and contributors accept no liability for loss, damage, interrupted work, corrupted projects, lost media or any other consequence arising from installation or use. Test the plugin on copies of important projects and media.

INSTALLATION

Install the compiled plug-in

The release package contains the ready-built Apple Silicon OpenFX plug-in, its Metal processing library, factory presets and an installer. Xcode and developer tools are not required.

Unpack the release
Double-click the downloaded Lens Debaser ZIP file to extract its folder.
Quit Resolve
Fully quit DaVinci Resolve before installing or replacing the plug-in.
Run the installer
Double-click Install Lens Debaser.command and enter the Mac administrator password when requested. If macOS blocks it, Control-click the installer, choose Open, then confirm.
Restart Resolve
Open Resolve and find Lens Debaser in the OpenFX effects library. The installer also copies the included factory presets into the Lens Debaser preset folder.

Requirements: an Apple Silicon Mac and DaVinci Resolve or DaVinci Resolve Studio. Installing a newer release automatically saves the previous plug-in bundle in /Library/Application Support/Lens Debaser/Backups.

QUICK START

Four steps to results

Add Lens Debaser
Add Lens Debaser to a node on the Color page.
Match the input
Choose the Input Working Space that matches the image entering the node.
Choose a starting point
Load a preset or begin with Clean Slate, then adjust the controls for the shot.
Optional: set the final strength
Use Blend when you want to mix the complete Lens Debaser result with the original image.

ROOT CONTROL GROUP

Setup

Choose presets, define input interpretation, and apply broad capture and look behavior.

Setup / CONTROL GROUP

Presets

Load, select and save Lens Debaser presets.

Load opens a .ldbpreset file and adds the presets in its folder to the Preset menu. Choose a name from the menu to apply it. Save writes the visible lens settings to a new .ldbpreset file.

See it in action ↓

Illustrated Lens Debaser Setup and Presets control layout

Setup / CONTROL GROUP

Processing

Define the color encoding entering the node and temporarily inspect individual processing stages.

Input Working Space tells Lens Debaser how to decode the incoming RGB values. The plugin converts that input to linear AP1, performs its optical processing there, then returns the result to the selected working space so it remains correctly placed in the Resolve color pipeline. Choose the space of the image entering this node—not the timeline or delivery space unless they are also the node input. A wrong selection changes luminance, color, thresholds and therefore the behavior of bloom, flare, transmission and other effects. Diagnostic View temporarily replaces the normal result with an analysis image; it does not change the preset or create a finishing look. Keep Diagnostic View set to Off for normal work.

See it in action ↓

Illustrated Lens Debaser Setup and Processing control layout

PROCESSING

Diagnostic Views

Diagnostic View temporarily replaces the normal image with information that helps identify and adjust individual parts of the effect.

ViewWhat it shows
OffThe normal Lens Debaser result.
Difference (Amplified)The amplified difference between the processed result and the source, centered on middle grey. Neutral grey means no change; brighter, darker or colored areas show where the plugin changes the image.
Scatter OnlyOnly the combined Bloom, Glare, Spherical Halo and Anamorphic Flare contribution, amplified for inspection. A black image means those controls are producing no scatter energy on the current frame.
Direct Optics OnlyThe direct optical result—including geometry, field, detail, chromatic, transmission and aperture processing—without Bloom, Glare, Spherical Halo or Anamorphic Flare added.
Depth InputThe normalized depth map Lens Debaser is using after Depth Interpretation and the Input Near/Input Far remap. Black represents 0 and white represents 1.
Defocus AmountA grayscale view of distance from Focus Depth after the current depth response. Dark areas are closer to the focus plane; bright areas receive more defocus.
Depth RejectionA grayscale view of depth boundaries protected from cross-layer scatter. Brighter areas show stronger sample rejection caused by Depth Edge Protection.

Diagnostic View changes only the displayed output. It does not alter the current preset or the stored lens controls.

Setup / CONTROL GROUP

Capture

Make compatible lens effects respond together to focal length, aperture, focus distance and capture format.

Capture does not add a visible effect by itself. Instead, it modifies compatible controls that are already active elsewhere in Lens Debaser. A wider field of view—produced by a shorter focal length or a larger capture gate—strengthens off-axis effects such as distortion, lateral color fringing, edge softness, field curvature, directional smear and natural falloff. A larger aperture, shown by a smaller f-number, strengthens pupil-related effects such as coma, optical vignetting, aperture-shaped defocus and anamorphic flare. Closer focus strengthens spherical softness, aperture-shaped defocus and longitudinal focus color. Capture Influence sets how strongly these relationships affect the active controls; at zero, the focal length, aperture, focus distance and gate settings make no change.

See it in action ↓

Illustrated Lens Debaser Setup and Capture control layout

Setup / CONTROL GROUP

Look

Quickly steer the image toward a broad lens character before fine-tuning individual controls.

Character adds a restrained mix of softness, edge color, falloff and highlight response. Vintage Bias produces a warmer, softer and less corrected image; Vintage Caricature pushes that treatment further. Exotic Bias favors irregular distortion, color separation and asymmetry. Classic 2x Anamorphic Bias introduces oval bokeh, cylindrical edge behavior and horizontal flare character. The biases can be combined, and Look Influence controls their overall strength.

See it in action ↓

Illustrated Lens Debaser Setup and Look control layout

ROOT CONTROL GROUP

Optics

Shape geometry, the optical field, focus transfer, detail, chromatic, anamorphic, refractive and prism behavior.

Optics / CONTROL GROUP

Geometry

Model conventional distortion and gradual optical edge deformation around an adjustable center.

Primary Distortion handles the broad bend, Secondary adds higher-order curvature, and Moustache creates a direction-changing wave. Field-Gated Geometry applies the Field Shape envelope to geometry; Peripheral Stretch adds smooth edge magnification and Peripheral Warp adds nonuniform bending rather than another barrel-distortion term.

See it in action ↓

Illustrated Lens Debaser Optics and Geometry control layout

Optics / CONTROL GROUP

Field Shape

Choose where edge-dependent lens effects begin and how they spread across the frame.

Field Center moves the best-corrected area. Field Aspect and Rotation stretch and turn the affected region, while Swirl rotates image structure around it. Field Onset sets how much of the center remains protected; Field Falloff controls whether the transition toward the edges is gradual or concentrated. This group shapes other field-dependent effects and therefore needs one of them active to become visible.

See it in action ↓

Illustrated Lens Debaser Optics and Field Shape control layout

Optics / CONTROL GROUP

Focus & Field

Keep one area relatively clear while focus and detail become less uniform toward the edges.

Corner Detail Loss softens outer detail. Field Curvature makes the apparent focus plane bow across the frame. Astigmatism changes radial and circular detail differently, while Radial and Tangential Smear pull soft detail in those respective directions. Field Shape determines where these changes begin.

See it in action ↓

Illustrated Lens Debaser Optics and Focus & Field control layout

Optics / CONTROL GROUP

Detail Transfer

Change the texture and crispness of the image at broad, fine and directional scales.

Microcontrast changes local separation in medium-sized detail. Fine Detail changes smaller texture. Edge Falloff lets detail weaken away from the center. Sagittal and Tangential Detail independently affect lines running toward the image center and lines running around it, while Detail Scale chooses the size of structure being affected.

See it in action ↓

Illustrated Lens Debaser Optics and Detail Transfer control layout

Optics / CONTROL GROUP

Chromatic Aberration

Add lateral edge separation and depth-sensitive longitudinal color fringing.

Red and Blue Fringing respond most visibly to high-contrast edges and increase away from the optical center. Chromatic Onset at −1 follows the shared Field envelope; values from 0 upward enable an independent onset and falloff. Longitudinal Amount and Radius tint the soft side of focus transitions with the selected near/far colors; fine edges, specular detail and a depth map make this response easiest to see.

See it in action ↓

Illustrated Lens Debaser Optics and Chromatic Aberration control layout

Optics / CONTROL GROUP

Anamorphic

Create the stretched geometry, edge color and horizontal flare behavior associated with anamorphic lenses.

Anamorphic Field controls the overall cylindrical character. Distortion bends geometry differently across the horizontal and vertical axes, while Aberration adds directionally stretched color separation. Flare Amount, Radius and Thickness create the main horizontal streak; Bands and Secondary Streak add layered structure. Vertical Rays create a cross-like highlight response, and Ghost controls add a sequence of softer colored reflections across the frame. Threshold determines which highlights are bright enough to produce these effects.

See it in action ↓

Illustrated Lens Debaser Optics and Anamorphic control layout

Optics / CONTROL GROUP

Refractive Irregularity

Add gentle waves, local stretching and color shifts that suggest uneven or stressed glass.

Amount controls the strength and Scale controls the size of the warped regions. Edge Bias confines more of the effect to the outer frame. Directionality, Direction and Rotation stretch and orient the pattern. Irregular Dispersion adds a small color split to the warped detail, and Seed chooses another repeatable pattern.

See it in action ↓

Illustrated Lens Debaser Optics and Refractive Irregularity control layout

Optics / CONTROL GROUP

Prism Refraction

Create a smooth directional bend and color split entering from one side of the frame.

Amount controls the displacement, Direction chooses the affected edge and the direction of the bend, and Dispersion separates color along that same optical path. Edge Bias moves the transition toward or away from the selected edge, while Softness controls how gradually the prism response blends into the unaffected image.

See it in action ↓

Illustrated Lens Debaser Optics and Prism Refraction control layout

ROOT CONTROL GROUP

Pupil & Vignette

Control the aperture footprint, illumination falloff and the lens image-circle boundary.

Pupil & Vignette / CONTROL GROUP

Aperture

Shape the appearance of defocused highlights and peripheral bokeh.

Response controls how strongly the selected aperture shape replaces ordinary blur, and Radius sets the bokeh size. Shape, blade controls, rotation, softness and aspect define the highlight silhouette. Cat-Eye compresses bokeh near the frame edge; Bokeh Swirl turns it around the Field Center. Pupil Shift and Clipping make edge bokeh close unevenly, while Rim Weight creates a brighter outer ring. These controls are easiest to judge on small background lights or specular highlights that are out of focus.

See it in action ↓

Illustrated Lens Debaser Pupil & Vignette and Aperture control layout

Pupil & Vignette / CONTROL GROUP

Vignette

Combine three distinct forms of edge attenuation.

Natural is smooth illumination falloff, Optical is pupil/field shading, and Mechanical is a harder obstruction-like cutoff.

See it in action ↓

Illustrated Lens Debaser Pupil & Vignette and Vignette control layout

Pupil & Vignette / CONTROL GROUP

Image Circle

Define the lens-coverage boundary used by Mechanical Vignette.

Size controls coverage, Aspect makes it elliptical and Softness controls the boundary transition. These controls have no visible effect while Mechanical Vignette is zero.

See it in action ↓

Illustrated Lens Debaser Pupil & Vignette and Image Circle control layout

ROOT CONTROL GROUP

Light

Model highlight bloom, glare, spherical halos and the tonal or color response of glass transmission.

Light / CONTROL GROUP

Bloom

Spread highlight energy into a soft luminous neighborhood.

Amount is energy, Threshold chooses qualifying scene-linear highlights, Radius sets reach, and Bloom Stretch makes the spread directional. Lamps, reflections, bright windows and overexposed edges produce the clearest response; a low-dynamic-range or dim input may show little change until Threshold is lowered.

See it in action ↓

Illustrated Lens Debaser Light and Bloom control layout

Light / CONTROL GROUP

Glare & Halo

Build veiling glare and spherical-aberration halos.

Glare is broad colored scatter and Spherical Halo is a smoother highlight envelope. Both react primarily around sufficiently bright image structure, so lamps, reflections and bright windows are the best test subjects. They are distinct from Bloom and from the asymmetric Coma controls in Advanced.

See it in action ↓

Illustrated Lens Debaser Light and Glare & Halo control layout

Light / CONTROL GROUP

Transmission

Simulate color and tonal behavior caused by glass and coatings.

Transmission Amount mixes the selected transmission color. Density, Contrast and Highlight Softness shape light passage without requiring bloom or glare.

See it in action ↓

Illustrated Lens Debaser Light and Transmission control layout

Light / CONTROL GROUP

Highlight Response

Control how smoothly bright areas begin to produce glow, flare and other highlight effects.

Highlight Knee changes the transition around the thresholds used by Bloom, Glare, Spherical Halo, Coma and Anamorphic Flare. A harder knee limits the response more tightly to the brightest values; a softer knee brings surrounding highlight detail into the effect more gradually. It has no visible result until at least one of those highlight effects is active.

See it in action ↓

Illustrated Lens Debaser Light and Highlight Response control layout

ROOT CONTROL GROUP

Advanced

Refine off-axis behavior, repeatable lens variation, element wear, internal contamination and depth-aware processing.

Advanced / CONTROL GROUP

Off-Axis Character

Create asymmetric, field-dependent highlight tails.

Coma sets tail strength and direction; its sign swaps orientation. Coma Threshold is the scene-linear highlight level at which the response begins. The response is clearest on isolated bright points away from the Field Center and may be inconspicuous on evenly lit or low-contrast material.

See it in action ↓

Illustrated Lens Debaser Advanced and Off-Axis Character control layout

Advanced / CONTROL GROUP

Variation

Make an otherwise clean lens treatment feel less perfectly centered and manufactured.

Variation Amount controls the overall strength. Field Asymmetry shifts edge behavior, Pupil Irregularity changes bokeh, Chromatic Asymmetry makes color fringing less even, and Transmission Unevenness introduces subtle tonal variation. Seed chooses another repeatable version. These controls vary effects that are already active, so a compatible field, aperture, chromatic or transmission setting is required.

See it in action ↓

Illustrated Lens Debaser Advanced and Variation control layout

Advanced / CONTROL GROUP

Front Element Wear

Add the softened contrast, flare and fixed marks associated with a worn front element.

Cleaning Haze lowers contrast around light. Cleaning Marks and Deep Scratches become most visible when bright windows or practicals illuminate them; Direction and Mark Scale set their orientation and size. Coating Wear introduces patchy shifts in contrast, color and flare. Damage Seed chooses another repeatable wear pattern.

See it in action ↓

Illustrated Lens Debaser Advanced and Front Element Wear control layout

Advanced / CONTROL GROUP

Internal Element Contamination

Introduce broad cloudy density, smearing and veiling from contamination inside the lens.

Amount controls the overall visibility and Size sets the scale of the cloudy regions. Smear stretches them, Scatter increases localized glow and loss of contrast, Softness smooths their boundaries, and Complexity adds overlapping large-scale variation. Bright windows and practical lights make the scatter easiest to see. Seed chooses another repeatable pattern.

See it in action ↓

Illustrated Lens Debaser Advanced and Internal Element Contamination control layout

Advanced / CONTROL GROUP

Depth Input

Use a depth map to place focus and control depth-aware optical effects.

Lens Debaser reads a grayscale depth image through its Second RGB/Depth Map input. The depth signal controls where enabled focus, aperture, halo and other depth-aware responses appear; it does not create an optical look until compatible effects are active.

Using a depth map on the Color page

  1. Create or supply a grayscale depth map and connect its RGB output to Lens Debaser’s Second RGB/Depth Map input.
  2. Choose one of the six Depth Interpretation models to match how the map stores distance:
    • Depth-Free does not use the external depth input. Lens Debaser retains its image- and field-based focus approximation.
    • Near White is for normalized maps in which lighter values are closer and darker values are farther away.
    • Near Black is for normalized maps in which darker values are closer and lighter values are farther away.
    • Linear Camera Z is for camera-space distance that increases linearly from the near range toward the far range.
    • Inverse Z / Disparity is for reciprocal-depth or disparity maps, where nearby subjects have larger values. Lens Debaser reverses this relationship into its common near-to-far working direction.
    • Logarithmic Z is for depth distributed logarithmically, providing finer separation through the near range while compressing more distant values.
  3. Use Input Near and Input Far to fit the useful range of the incoming map. This is especially helpful when the map occupies only a narrow part of the available black-to-white range.
  4. Select Diagnostic View → Depth Input to verify the interpreted and remapped depth signal, then return Diagnostic View to Off for normal processing.
  5. Move Focus Depth to place the in-focus plane. Defocus Onset controls how far depth must move away from that plane before the enabled effect begins; Defocus Falloff controls how gradually it reaches full strength.
  6. Increase Depth Edge Protection when foreground and background colors contaminate one another across depth boundaries. Use Depth Edge Softness to keep that protection from producing an unnaturally hard transition.
  7. Enable at least one compatible optical response. If none is active, changing the depth controls may produce no visible result.

Depth-aware responses in this build

  • Aperture Response and bokeh reconstruction: depth controls the defocus radius around Focus Depth. The active aperture shape, Cat-Eye, Bokeh Swirl, Pupil Shift, Pupil Clipping and Pupil Rim Weight are carried into that depth-positioned bokeh.
  • Longitudinal chromatic aberration: depth chooses the near- or far-focus color and controls how strongly that focus color appears away from the focus plane.
  • Spherical Halo: halo strength follows distance from Focus Depth and respects protected depth boundaries.
  • Anamorphic flare, diffraction and reflection structure: depth affects source eligibility and prevents the reconstructed flare response from freely crossing unrelated depth layers.
  • Bloom and Glare: these remain driven by qualifying highlights, while the depth map protects foreground/background boundaries from inappropriate cross-layer spill.
  • Front Element Wear scatter and Internal Element Contamination scatter: their diffused-light components share the protected optical-scatter path. The fixed wear or contamination pattern itself is not repositioned by depth.

Not depth-aware: geometry, lateral chromatic aberration, vignette, transmission, detail transfer, field shape, refractive irregularity and prism refraction remain image- or field-based. Depth Input also provides the Depth Input, Defocus Amount and Depth Rejection diagnostic views for checking the map and its influence.

See it in action ↓

Illustrated Lens Debaser Advanced and Depth Input control layout

ROOT CONTROL GROUP

Blend

Set the final mix between the original image and the complete processed result.

Blend / CONTROL GROUP

Blend

Mix the complete processed result with the untouched source.

Blend 0 is the input image; Blend 1 is the full effect. It remains the final control group for predictable finishing.

See it in action ↓

Illustrated Lens Debaser Blend and Blend control layout

DEMONSTRATIONS

Explore individual control groups

The Demonstrations folder contains one moderate educational preset per major control group or required interaction. Each is tuned as a usable starting point while remaining clear enough to explain the control; its note identifies the input features or dependencies needed to reveal the response.

INTERACTIVE OPTICAL ATLAS

See every control group in action

Optical groups are shown on both charts and three color-graded images captured with an iPhone 17 Pro and a 1.55× anamorphic adapter (ProRes RAW Open Gate), rendered by the current Lens Debaser engine. Processing uses one focused diagnostic example; Blend uses one focused 100%/50% comparison.

Presets

Reference ↑

A preset recalls a complete set of Lens Debaser controls. This example uses Demo Look to make a clearly visible starting treatment that can then be refined for the shot.

Applied preset for the comparisons below: 02-Demo-Look

Diagnostic Views

Reference ↑

This single comparison demonstrates Diagnostic View → Difference (Amplified): Detail Transfer is deliberately enabled, and the applied side replaces the normal image with an amplified map of where Lens Debaser changes it. Neutral grey means little or no change; brighter, darker or colored regions identify altered image structure. Set Diagnostic View back to Off to see the finished image.

Applied preset for the comparisons below: 06-Demo-Detail-Transfer

Capture

Reference ↑

Demo Capture supplies four direct image effects: peripheral detail loss, field curvature, longitudinal focus color and natural vignetting. Capture then coordinates their strength from the simulated shooting setup. Its 24 mm focal length on a Super 35 gate produces a sufficiently wide field of view to strengthen off-axis softness, curvature and falloff; its f/1.6 aperture and 90 cm focus distance strengthen the defocus and longitudinal color response. The applied image therefore shows the preset's four effects after Capture has modified them—not an effect created by Capture alone.

Applied preset for the comparisons below: 01-Demo-Capture

Look

Reference ↑

The applied image combines softer detail, warmer transmission, stronger edge falloff, color fringing and less even correction. Adjust the individual Look biases to move from restrained character toward vintage, exotic or anamorphic rendering.

Applied preset for the comparisons below: 02-Demo-Look

Geometry

Reference ↑

Straight lines expose primary, secondary and moustache distortion; the shared Field envelope controls their gradual onset.

Applied preset for the comparisons below: 03-Demo-Field-Gated-Geometry

Field Shape

Reference ↑

Field Shape determines where edge-dependent changes begin. The preset adds focus loss, directional softness and color fringing so moving the center, stretching or rotating the field, and changing onset or falloff can be seen directly.

Applied preset for the comparisons below: 04-Demo-Field-Shape

Focus & Field

Reference ↑

The center remains relatively clear while fine structure becomes softer, curved and directionally smeared toward the frame edges.

Applied preset for the comparisons below: 05-Demo-Focus-And-Field

Detail Transfer

Reference ↑

The applied image reduces broad local contrast and fine texture, weakens detail near the edges and treats radial and circular line detail differently.

Applied preset for the comparisons below: 06-Demo-Detail-Transfer

Chromatic Aberration

Reference ↑

High-contrast outer edges reveal lateral red/blue separation. Longitudinal color becomes most informative with depth or defocused highlights.

Applied preset for the comparisons below: 07-Demo-Chromatic-Aberration

Anamorphic

Reference ↑

Architectural lines reveal cylindrical geometry while the repeated practical lights provide real scene highlights for the anamorphic flare response.

Applied preset for the comparisons below: 08-Demo-Anamorphic

Refractive Irregularity

Reference ↑

The applied image adds repeatable local ripples and slight color shifts, most easily seen in straight lines and fine detail toward the edges.

Applied preset for the comparisons below: 21-Demo-Refractive-Irregularity

Prism Refraction

Reference ↑

The applied image bends the selected side of the chart through one continuous wedge and adds controlled spectral separation along the same direction.

Applied preset for the comparisons below: 31-Demo-Prism-Refraction

Aperture

Reference ↑

The preset turns blurred highlights into a softly rounded seven-blade shape, compresses them toward the frame edge and adds a gentle rotational change around the center. Sharp areas mainly show the accompanying focus transfer.

Applied preset for the comparisons below: 09-Demo-Aperture

Vignette

Reference ↑

An evenly exposed chart separates gradual natural and optical shading from harder mechanical obstruction.

Applied preset for the comparisons below: 10-Demo-Vignette

Image Circle

Reference ↑

Image Circle defines a boundary but does nothing by itself. Mechanical Vignette is enabled so size, aspect and softness can shape coverage.

Applied preset for the comparisons below: 11-Demo-Image-Circle

Bloom

Reference ↑

Bloom needs pixels above its scene-linear threshold. The bright exterior and ceiling practicals reveal amount, radius and stretch on real material.

Applied preset for the comparisons below: 12-Demo-Bloom

Glare & Halo

Reference ↑

Glare and spherical halo are highlight-driven; the bright doorway against the darker interior reveals their different broad envelopes.

Applied preset for the comparisons below: 13-Demo-Glare-And-Halo

Transmission

Reference ↑

Real tonal and color variation reveals glass color, density, contrast and highlight softness more clearly than a binary chart.

Applied preset for the comparisons below: 14-Demo-Transmission

Highlight Response

Reference ↑

Highlight Response does nothing alone, so the preset enables bloom, glare, coma, halo and flare. The softer knee lets those effects build more gradually around bright windows and practical lights instead of switching on abruptly.

Applied preset for the comparisons below: 15-Demo-Highlight-Response

Off-Axis Character

Reference ↑

Coma needs bright points above its threshold and becomes strongest away from Field Center. The repeated lamps provide real off-axis sources.

Applied preset for the comparisons below: 16-Demo-Coma

Variation

Reference ↑

Variation does nothing to a completely neutral lens, so the preset first enables field, bokeh, color-fringing and transmission behavior. Variation then makes those changes less centered and uniform.

Applied preset for the comparisons below: 17-Demo-Variation

Front Element Wear

Reference ↑

The applied image combines lower contrast around light, repeatable cleaning and scratch marks, and patchy coating-related color and contrast changes.

Applied preset for the comparisons below: 20-Demo-Front-Element-Wear

Internal Element Contamination

Reference ↑

The applied image gains broad cloudy density variation, elongated soft patches and localized veiling around brighter parts of the frame.

Applied preset for the comparisons below: 24-Demo-Internal-Element-Contamination

Depth Input

Reference ↑

Depth controls require a second depth signal. Aperture defocus and halo are enabled so focus placement, defocus response and edge protection become visible without adding a color cast.

Applied preset for the comparisons below: 18-Demo-Depth-Input

Blend

Reference ↑

Blend needs processing to mix. The ISO chart compares the same moderate focus, chromatic and bloom treatment at 100% effect and 50% Blend.

Applied preset for the comparisons below: 19-Demo-Blend

CINEMATIC LENSES

Default character presets

The current library contains 104 factory presets: 31 demonstrations and 73 cinematic-lens presets.

Most cinematic families provide independently authored Subtle, Medium and Caricature observations. Subtle introduces the family with a restrained change, Medium is a clearly visible starting point, and Caricature exposes the defining signature strongly. Bodycam Edge Stress remains a single signature preset. Presets containing aperture reconstruction use controlled values and combine them with a clearer focus region; a connected depth map gives direct control over the in-focus plane.

FamilyCharacter and suitable input
Golden Portrait PrimeWarm dimensional portrait rendering with a protected center, curved edge falloff and highlight-sensitive glare.
Silver Contrast PrimeCooler, lower-contrast still-glass character with organic edge loss and restrained axial color.
Uncoated NewsreelWarm uncoated transmission, reduced contrast, haze, bloom and glare that respond strongly to windows and practicals.
Breathing Documentary ZoomSoft vintage zoom character with gradual edge geometry, uneven field response and chromatic texture.
Rotating Bokeh PortraitTangentially stretched peripheral bokeh around a usable portrait center; small bright background points reveal it best.
Petzval Oval PortraitWarm oval-pupil portrait response with curved focus, cat-eye deformation and asymmetric historical character.
Bubble Bokeh TripletFirm round defocus highlights, curved edge focus and visible longitudinal color around bright background points.
Pearlescent DiffusionDreamy soft-focus response with spherical halo, bloom, glare and reduced microcontrast while retaining a usable center.
Electric Blue ScopeTwo-times anamorphic field with oval bokeh, edge aberration and strong blue streak response above the flare threshold.
Honeyed Compact ScopeWarm compact anamorphic character with elliptical falloff, amber streaks and restrained edge softness.
Bent Glass ScopePronounced off-axis anamorphic deformation, refractive irregularity, directional focus loss and chromatic separation.
Neon Radiance PrimeClean center with conspicuous colored highlight radiance; lamps, signs, reflections and windows drive the effect.
Nocturnal Cat-EyeStrong off-axis pupil deformation, curved focus, coma and axial color; requires isolated peripheral highlights.
Stressed Ultra WideGradual peripheral stretch and warp, complex moustache geometry and heavy edge chromatic aberration.
Rehoused Still GlassRepeatable decentering, refractive unevenness and coating wear with a restrained photographic base.
C-Mount CCTVSmall-image-circle coverage, hard mechanical vignette, heavy edge softness, coma and chromatic stress.
Close Focus MacroClose-focus spherical and longitudinal aberration with a deliberately retained in-focus region.
Microscope ObjectiveTight central correction surrounded by rapid field curvature, edge softness and chromatic separation.
Tilted FreelensStrong asymmetric focus plane, directional smear and irregular off-axis rendering.
Improvised Projector LensUnconventional pupil, glow, aberration and refractive behavior inspired by adapted projection optics.
Bodycam Edge StressSingle signature preset with hard image-circle coverage, spherical edge defocus, gradual edge CA and refractive distortion.
Hawk V-Lite Vintage '74Inspired by an anamorphic profile with oval off-axis bokeh, vintage field softness, broad blue flare and a structured reflection train.
Cooke Anamorphic /i Special FlareInspired by an anamorphic profile with blue-cyan streaks, smooth vertical diffraction, controlled wash and focal-length-aware flare structure.
Decentered Dream GlassCreative compound optic combining pupil decentering, clipping, field asymmetry, refractive irregularity and soft highlight response.
Edge Prism GlassHand-held linear-prism character with a smooth one-sided bend, controlled spectral separation and softly integrated edge stress.

PRESET ATLAS

See the included presets in action

Each cinematic-lens family is shown on both charts and the three color-graded iPhone images. Medium versions are used where available; Bodycam Edge Stress uses its single included version.

Golden Portrait Prime

Warm dimensional portrait rendering with a protected center, curved edge falloff and highlight-sensitive glare.

Applied preset for the comparisons below: 01-Golden-Portrait-Prime-2-Medium

Silver Contrast Prime

Cooler, lower-contrast still-glass character with organic edge loss and restrained axial color.

Applied preset for the comparisons below: 02-Silver-Contrast-Prime-2-Medium

Uncoated Newsreel

Warm uncoated transmission, reduced contrast, haze, bloom and glare that respond strongly to windows and practicals.

Applied preset for the comparisons below: 03-Uncoated-Newsreel-2-Medium

Breathing Documentary Zoom

Soft vintage zoom character with gradual edge geometry, uneven field response and chromatic texture.

Applied preset for the comparisons below: 04-Breathing-Documentary-Zoom-2-Medium

Rotating Bokeh Portrait

Tangentially stretched peripheral bokeh around a usable portrait center; small bright background points reveal it best.

Applied preset for the comparisons below: 05-Rotating-Bokeh-Portrait-2-Medium

Petzval Oval Portrait

Warm oval-pupil portrait response with curved focus, cat-eye deformation and asymmetric historical character.

Applied preset for the comparisons below: 06-Petzval-Oval-Portrait-2-Medium

Bubble Bokeh Triplet

Firm round defocus highlights, curved edge focus and visible longitudinal color around bright background points.

Applied preset for the comparisons below: 07-Bubble-Bokeh-Triplet-2-Medium

Pearlescent Diffusion

Dreamy soft-focus response with spherical halo, bloom, glare and reduced microcontrast while retaining a usable center.

Applied preset for the comparisons below: 08-Pearlescent-Diffusion-2-Medium

Electric Blue Scope

Two-times anamorphic field with oval bokeh, edge aberration and strong blue streak response above the flare threshold.

Applied preset for the comparisons below: 09-Electric-Blue-Scope-2-Medium

Honeyed Compact Scope

Warm compact anamorphic character with elliptical falloff, amber streaks and restrained edge softness.

Applied preset for the comparisons below: 10-Honeyed-Compact-Scope-2-Medium

Bent Glass Scope

Pronounced off-axis anamorphic deformation, refractive irregularity, directional focus loss and chromatic separation.

Applied preset for the comparisons below: 11-Bent-Glass-Scope-2-Medium

Neon Radiance Prime

Clean center with conspicuous colored highlight radiance; lamps, signs, reflections and windows drive the effect.

Applied preset for the comparisons below: 12-Neon-Radiance-Prime-2-Medium

Nocturnal Cat-Eye

Strong off-axis pupil deformation, curved focus, coma and axial color; requires isolated peripheral highlights.

Applied preset for the comparisons below: 13-Nocturnal-Cat-Eye-2-Medium

Stressed Ultra Wide

Gradual peripheral stretch and warp, complex moustache geometry and heavy edge chromatic aberration.

Applied preset for the comparisons below: 14-Stressed-Ultra-Wide-2-Medium

Rehoused Still Glass

Repeatable decentering, refractive unevenness and coating wear with a restrained photographic base.

Applied preset for the comparisons below: 15-Rehoused-Still-Glass-2-Medium

C-Mount CCTV

Small-image-circle coverage, hard mechanical vignette, heavy edge softness, coma and chromatic stress.

Applied preset for the comparisons below: 16-C-Mount-CCTV-2-Medium

Close Focus Macro

Close-focus spherical and longitudinal aberration with a deliberately retained in-focus region.

Applied preset for the comparisons below: 17-Close-Focus-Macro-2-Medium

Microscope Objective

Tight central correction surrounded by rapid field curvature, edge softness and chromatic separation.

Applied preset for the comparisons below: 18-Microscope-Objective-2-Medium

Tilted Freelens

Strong asymmetric focus plane, directional smear and irregular off-axis rendering.

Applied preset for the comparisons below: 19-Tilted-Freelens-2-Medium

Improvised Projector Lens

Unconventional pupil, glow, aberration and refractive behavior inspired by adapted projection optics.

Applied preset for the comparisons below: 20-Improvised-Projector-Lens-2-Medium

Bodycam Edge Stress

Single signature preset with hard image-circle coverage, spherical edge defocus, gradual edge CA and refractive distortion.

Applied preset for the comparisons below: 21-Bodycam-Edge-Stress

Hawk V-Lite Vintage '74

Inspired by an anamorphic profile with oval off-axis bokeh, vintage field softness, broad blue flare and a structured reflection train.

Applied preset for the comparisons below: 22-Hawk-V-Lite-Vintage-74-2-Medium

Cooke Anamorphic /i Special Flare

Inspired by an anamorphic profile with blue-cyan streaks, smooth vertical diffraction, controlled wash and focal-length-aware flare structure.

Applied preset for the comparisons below: 23-Cooke-Anamorphic-i-Special-Flare-2-Medium

Decentered Dream Glass

Creative compound optic combining pupil decentering, clipping, field asymmetry, refractive irregularity and soft highlight response.

Applied preset for the comparisons below: 24-Decentered-Dream-Glass-2-Medium

Edge Prism Glass

Hand-held linear-prism character with a smooth one-sided bend, controlled spectral separation and softly integrated edge stress.

Applied preset for the comparisons below: 25-Edge-Prism-Glass-2-Medium

PRACTICAL NOTES

Performance and troubleshooting

CREDITS & LICENSING

Acknowledgements & Credits

Lens Debaser is distributed under Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International. The complete terms are in the repository LICENSE file.

Images

Code and platform

Colour science and validation