Nodes · Filter
Defocus
Filterv2core
Overview
Depth-driven thin-lens defocus with a real aperture: disc or bladed, rotatable, anamorphic by aspect, and catadioptric for a mirror lens's ring bokeh.
How to
- Wire a depth pass, or set the focal plane by hand.
- Choose
bokehand, forbladed, the blade count and rotation. - Use
aspectfor anamorphic ovals;catadioptricfor the doughnut.
Inputs
| Input | What it takes |
|---|---|
| in | the image this node works on |
| mask | limits the effect to this matte — the engine's universal mask slot, applied for every node that declares it |
Outputs
| Output | Type |
|---|---|
| out | Image |
Parameters
| Parameter | Type | Default | What it does |
|---|---|---|---|
| channels | Choice | all | Which channels the disc is applied to; everything else passes straight through. allrgbargbalphanone |
| defocus | Float | 1.0 | The radius of the disc, in pixels. 0 leaves the image untouched; 10 is a soft portrait background; 40 melts everything. |
| ratio | Float | 1.0 | The disc's aspect: width over height. 1 is round; 2 is an oval twice as wide as it is tall (an anamorphic look); below 1 is tall. |
| scale | Float | 1.0 | Scales the disc on both axes at once — a single dial over defocus for animating the whole effect up and down. |
| quality | Int | 20 | How finely the disc's rim rows are area-sampled (sub-rows per pixel). 20 is exact to the eye; lower is a little faster on huge discs. |
| method | Choice | accelerated | accelerated: the disc as a stack of row spans on prefix sums — exact to the pixel's coverage and O(radius) per pixel, so a 100 px disc costs about what a 10 px one does. fullprecision: the same arithmetic here (both are exact); the choice is kept so a Nuke script reads across. acceleratedfullprecision |
| mix | Float | 1.0 | Blend between the original (0) and the defocused image (1). |
| disabled | Bool | false | Bypass: the node passes its first input through untouched (D in the graph). The knobs keep their values for when it comes back. |
| label | Text | A note shown under the node in the graph — what this node is FOR. Never affects the render or the cache. | |
| hide_input | Bool | false | Draw the node without its input wire — a tidy graph for a node whose source is obvious (a Dot, a viewer tap). |