Node reference
Transform nodes
Add UV Map
Type name: AddSTMap (scripts, MCP and Nuke import use it).
Adds an identity st-map (layer.u, layer.v) for STMap.
Inputs: input.
| Setting | Default | Range or choices | What it does |
|---|---|---|---|
| out 2 | stmap | The layer: its .u and .v channels. |
Adjust Bounds
Type name: AdjBBox (scripts, MCP and Nuke import use it).
Grows the bounding box (repeating the edge pixels) or shrinks it (negative), e.g. before a blur.
Inputs: input.
| Setting | Default | Range or choices | What it does |
|---|---|---|---|
| add pixels | 25 | -100 to 100 | Pixels added on every side (negative: removed). |
BlackOutside
The picture inside the format, with a black edge around it.
Inputs: input.
No settings.
CameraShake
A random wobble of translate, rotation and scale (fractal noise).
Inputs: input.
| Setting | Default | Range or choices | What it does |
|---|---|---|---|
| amplitude_x | 10 | 0 to 100 | The largest horizontal shake, in pixels. |
| amplitude_y | 10 | 0 to 100 | The largest vertical shake, in pixels. |
| rotation | 0 | 0 to 45 | The largest turn of the shake, in degrees. |
| scaling | 0 | 0 to 1 | The largest change of size of the shake (0.1: up to 10% bigger or smaller). |
| frequency | 0.5 | 0 to 5 | How fast the shake moves: noise cycles per frame. |
| octaves | 2 | 1 to 8 | Layers of noise, each twice as fast and half as strong: more gives a jerkier shake. |
| seed | 0 | 0 to 100 | Another number gives another random pattern. |
| fixed scale | 1 | 0.5 to 2 | A constant scale applied with the shake, about the centre (to hide the edges). |
| center | 0 | 0 to 2000 | The centre of the turn and scale, x in pixels. |
| center | 0 | 0 to 2000 | The centre of the turn and scale, y in pixels. |
| filter | cubic | impulse, cubic, Keys, Simon, Rifman, Mitchell, Parzen, notch, Lanczos4, Lanczos6, sinc4 | Nuke's (kept; ours is bilinear). |
| clamp | off | Keep the values between 0 and 1. | |
| black outside | off | Black outside the picture's edges instead of repeating them. | |
| motionblur | 1 | 0 to 4 | Motion blur: how many samples of the movement, 0 for none. |
| Shutter | 0.5 | 0 to 1 | Kept for Nuke scripts, not used. |
| Shutter Offset | centred | centred, start, end, custom | Kept for Nuke scripts, not used. |
| shuttercustomoffset | 0 | -1 to 1 | Kept for Nuke scripts, not used. |
Card Transform
Type name: Card3D (scripts, MCP and Nuke import use it).
The input on a card in 3D, seen through the camera input (or the card's own lens).
Inputs: img, cam (optional, track data).
| Setting | Default | Range or choices | What it does |
|---|---|---|---|
| Transform Order | SRT | SRT, STR, RST, RTS, TSR, TRS | Kept for Nuke scripts, not used (the card is scaled, rotated, then moved). |
| Rotation Order | ZXY | XYZ, XZY, YXZ, YZX, ZXY, ZYX | The order the x, y and z rotations are applied in (ZXY: z first). |
| translate x | 0 | -10 to 10 | Moves the picture across, in pixels. |
| translate y | 0 | -10 to 10 | Moves the picture up, in pixels. |
| translate z | -1 | -10 to 10 | The card's distance along z (negative: in front of the camera). |
| rotate x | 0 | -10 to 10 | The card's rotation about x, in degrees. |
| rotate y | 0 | -10 to 10 | The card's rotation about y, in degrees. |
| rotate z | 0 | -10 to 10 | The card's rotation about z, in degrees. |
| scaling x | 0 | -10 to 10 | The card's size along x (0 counts as 1). |
| scaling y | 0 | -10 to 10 | The card's size along y (0 counts as 1). |
| uniform scale | 1 | -10 to 10 | Multiplies the card's size on both axes. |
| skew x | 0 | -10 to 10 | Kept for Nuke scripts, not used. |
| skew y | 0 | -10 to 10 | Kept for Nuke scripts, not used. |
| skew z | 0 | -10 to 10 | Kept for Nuke scripts, not used. |
| pivot translate x | 0 | -10 to 10 | Kept for Nuke scripts, not used. |
| pivot translate y | 0 | -10 to 10 | Kept for Nuke scripts, not used. |
| pivot translate z | 0 | -10 to 10 | Kept for Nuke scripts, not used. |
| pivot rotate x | 0 | -10 to 10 | Kept for Nuke scripts, not used. |
| pivot rotate y | 0 | -10 to 10 | Kept for Nuke scripts, not used. |
| pivot rotate z | 0 | -10 to 10 | Kept for Nuke scripts, not used. |
| pivot x | 0 | -10 to 10 | Kept for Nuke scripts, not used. |
| pivot y | 0 | -10 to 10 | Kept for Nuke scripts, not used. |
| pivot z | 0 | -10 to 10 | Kept for Nuke scripts, not used. |
| lens focal length | 1 | -10 to 10 | With the lens aperture, sets the card's size: the untouched card fills a camera with this lens. |
| lens horizontal aperture | 1 | -10 to 10 | With the lens focal length, sets the card's size; also the lens used without a camera input. |
| Specify Matrix | off | Kept for Nuke scripts, not used. | |
| filter | cubic | impulse, cubic, Keys, Simon, Rifman, Mitchell, Parzen, notch, Lanczos4, Lanczos6, sinc4 | Nuke's (kept; ours is bilinear). |
Corner Pin
Type name: CornerPin2D (scripts, MCP and Nuke import use it).
Moves the four corners of the "from" shape onto the "to" corners (a perspective warp), as Nuke's CornerPin2D: 1 bottom-left, 2 bottom-right, 3 top-right, 4 top-left, in pixels.
Inputs: input.
| Setting | Default | Range or choices | What it does |
|---|---|---|---|
| to1 x | 0 | -500 to 2500 | Where this corner of the "from" shape goes. |
| to1 y | 0 | -500 to 2500 | Where this corner of the "from" shape goes. |
| to2 x | 1920 | -500 to 2500 | Where this corner of the "from" shape goes. |
| to2 y | 0 | -500 to 2500 | Where this corner of the "from" shape goes. |
| to3 x | 1920 | -500 to 2500 | Where this corner of the "from" shape goes. |
| to3 y | 1080 | -500 to 2500 | Where this corner of the "from" shape goes. |
| to4 x | 0 | -500 to 2500 | Where this corner of the "from" shape goes. |
| to4 y | 1080 | -500 to 2500 | Where this corner of the "from" shape goes. |
| from1 x | 0 | -500 to 2500 | A corner of the shape that is moved. |
| from1 y | 0 | -500 to 2500 | A corner of the shape that is moved. |
| from2 x | 1920 | -500 to 2500 | A corner of the shape that is moved. |
| from2 y | 0 | -500 to 2500 | A corner of the shape that is moved. |
| from3 x | 1920 | -500 to 2500 | A corner of the shape that is moved. |
| from3 y | 1080 | -500 to 2500 | A corner of the shape that is moved. |
| from4 x | 0 | -500 to 2500 | A corner of the shape that is moved. |
| from4 y | 1080 | -500 to 2500 | A corner of the shape that is moved. |
| follow input | off | The corners are offsets from the input's bounding box (the image after a Transform above): the pin moves with the image. Off: corners in pixels of the frame. | |
| invert | off | Move the "to" shape onto the "from" one instead. | |
| filter | cubic | impulse, bilinear, cubic, Keys, Simon, Rifman, Mitchell, Parzen, notch, Lanczos4, Lanczos6, sinc4 | Nuke's filters. impulse: nearest pixel; cubic: smooth, no overshoot; Keys, Simon, Rifman: sharper, in that order; Mitchell: between; Parzen: softest; notch: flat, against moire; Lanczos4, Lanczos6: sharpest, with ringing; sinc4: sharper still. |
| clamp | off | Keep filtered values within their neighbours (no overshoot). | |
| black outside | on | Outside the input is black, with soft edges. Off: edge pixels are extended. | |
| motion blur | 0 | 0 to 4 | Motion blur quality: 0 off; each 0.1 is one more sample (Nuke's knob). |
| shutter angle | 180 | 0 to 360 | Degrees, as a film camera's (180: open half a frame). Nuke's shutter x 360. |
| shutter offset | start | start, centred, end, custom | Where the shutter opens: at the frame (start), around it, before it, or at the custom offset. |
| custom offset | 0 | -1 to 1 | Where the shutter opens, in frames from the frame (shutter offset custom). |
CornerPinTracker
A Tracker with four tracks, the corners 1 bottom-left, 2 bottom-right, 3 top-right, 4 top-left, that also pins: the source's frame goes onto the four corners at each frame, alone or over the plate. With nothing on the source the plate passes unchanged. Track it from its settings, like a Tracker. JOS only.
Inputs: plate, source (optional), mask (optional, a mask).
| Setting | Default | Range or choices | What it does |
|---|---|---|---|
| over plate | off | Put the pinned source over the plate (premultiplied). Off: the pinned source alone, to comp over something else. A source without alpha gets an alpha of 1 over its frame. | |
| filter | cubic | impulse, bilinear, cubic, Keys, Simon, Rifman, Mitchell, Parzen, notch, Lanczos4, Lanczos6, sinc4 | Nuke's filters. impulse: nearest pixel; cubic: smooth, no overshoot; Keys, Simon, Rifman: sharper, in that order; Mitchell: between; Parzen: softest; notch: flat, against moire; Lanczos4, Lanczos6: sharpest, with ringing; sinc4: sharper still. |
| clamp | off | Keep filtered values within their neighbours (no overshoot). | |
| black outside | on | Outside the input is black, with soft edges. Off: edge pixels are extended. | |
| extrapolate | off | Before a track's first key and after its last, its position goes on as it was moving instead of stopping (as the curve editor's before/after setting, worked out live; the keys stay as they are). For tracks that leave the frame or start late. | |
| extrapolate as | linear | linear, extrapolate, exponential | Linear: at the speed of the end key. Extrapolate: with the speed and acceleration of the last keys. Exponential: the speed changing by the same ratio each frame (the curve editor's end settings). |
| motion blur | 0 | 0 to 4 | Motion blur quality: 0 off; each 0.1 is one more sample (Nuke's knob). |
| shutter angle | 180 | 0 to 360 | Degrees, as a film camera's (180: open half a frame). Nuke's shutter x 360. |
| shutter offset | start | start, centred, end, custom | Where the shutter opens: at the frame (start), around it, before it, or at the custom offset. |
| custom offset | 0 | -1 to 1 | Where the shutter opens, in frames from the frame (shutter offset custom). |
| display gizmo | on | Shows a green box over the pinned source in the viewer: drag inside to move it, a corner to scale it, an edge to stretch it, the handle above it to turn it. The four tracks carry it. | |
| translate x | 0 | -1000 to 1000 | |
| translate y | 0 | -1000 to 1000 | |
| rotate | 0 | -180 to 180 | |
| scale x | 1 | 0 to 4 | |
| scale y | 1 | 0 to 4 | |
| track 1 enable | on | Uses this track: off, it is kept but plays no part. | |
| track 1 name | bottom-left | The track's name. | |
| track 1 x | 480 | 0 to 2000 | The tracked point's position across, in pixels, animated by tracking. |
| track 1 y | 270 | 0 to 2000 | The tracked point's position up, in pixels, animated by tracking. |
| track 1 T | on | Drives the translation. | |
| track 1 R | off | Drives the rotation. | |
| track 1 S | off | Drives the scale. | |
| track 1 offset x | 0 | -100 to 100 | Moves the track's point away from the pattern's centre. |
| track 1 offset y | 0 | -100 to 100 | Moves the track's point up or down from the pattern's centre, in pixels. |
| track 1 error | 0 | 0 to 1 | How badly the pattern matched at each tracked frame (0: perfectly). Set by tracking. |
| track 1 pattern left | -15 | -60 to 0 | The pattern box's left edge, from the pattern's centre (the box is what is followed). |
| track 1 pattern bottom | -15 | -60 to 0 | The pattern box's bottom edge, from the pattern's centre, in pixels. |
| track 1 pattern right | 15 | 0 to 60 | The pattern box's right edge, from the pattern's centre, in pixels. |
| track 1 pattern top | 15 | 0 to 60 | The pattern box's top edge, from the pattern's centre, in pixels. |
| track 1 search left | -40 | -150 to 0 | The search box's left edge, from the pattern's centre: how far the pattern may move from one frame to the next. |
| track 1 search bottom | -40 | -150 to 0 | The search box's bottom edge, from the pattern's centre, in pixels. |
| track 1 search right | 40 | 0 to 150 | The search box's right edge, from the pattern's centre, in pixels. |
| track 1 search top | 40 | 0 to 150 | The search box's top edge, from the pattern's centre, in pixels. |
| track 2 enable | on | Uses this track: off, it is kept but plays no part. | |
| track 2 name | bottom-right | The track's name. | |
| track 2 x | 1440 | 0 to 2000 | The tracked point's position across, in pixels, animated by tracking. |
| track 2 y | 270 | 0 to 2000 | The tracked point's position up, in pixels, animated by tracking. |
| track 2 T | on | Drives the translation. | |
| track 2 R | off | Drives the rotation. | |
| track 2 S | off | Drives the scale. | |
| track 2 offset x | 0 | -100 to 100 | Moves the track's point away from the pattern's centre. |
| track 2 offset y | 0 | -100 to 100 | Moves the track's point up or down from the pattern's centre, in pixels. |
| track 2 error | 0 | 0 to 1 | How badly the pattern matched at each tracked frame (0: perfectly). Set by tracking. |
| track 2 pattern left | -15 | -60 to 0 | The pattern box's left edge, from the pattern's centre (the box is what is followed). |
| track 2 pattern bottom | -15 | -60 to 0 | The pattern box's bottom edge, from the pattern's centre, in pixels. |
| track 2 pattern right | 15 | 0 to 60 | The pattern box's right edge, from the pattern's centre, in pixels. |
| track 2 pattern top | 15 | 0 to 60 | The pattern box's top edge, from the pattern's centre, in pixels. |
| track 2 search left | -40 | -150 to 0 | The search box's left edge, from the pattern's centre: how far the pattern may move from one frame to the next. |
| track 2 search bottom | -40 | -150 to 0 | The search box's bottom edge, from the pattern's centre, in pixels. |
| track 2 search right | 40 | 0 to 150 | The search box's right edge, from the pattern's centre, in pixels. |
| track 2 search top | 40 | 0 to 150 | The search box's top edge, from the pattern's centre, in pixels. |
| track 3 enable | on | Uses this track: off, it is kept but plays no part. | |
| track 3 name | top-right | The track's name. | |
| track 3 x | 1440 | 0 to 2000 | The tracked point's position across, in pixels, animated by tracking. |
| track 3 y | 810 | 0 to 2000 | The tracked point's position up, in pixels, animated by tracking. |
| track 3 T | on | Drives the translation. | |
| track 3 R | off | Drives the rotation. | |
| track 3 S | off | Drives the scale. | |
| track 3 offset x | 0 | -100 to 100 | Moves the track's point away from the pattern's centre. |
| track 3 offset y | 0 | -100 to 100 | Moves the track's point up or down from the pattern's centre, in pixels. |
| track 3 error | 0 | 0 to 1 | How badly the pattern matched at each tracked frame (0: perfectly). Set by tracking. |
| track 3 pattern left | -15 | -60 to 0 | The pattern box's left edge, from the pattern's centre (the box is what is followed). |
| track 3 pattern bottom | -15 | -60 to 0 | The pattern box's bottom edge, from the pattern's centre, in pixels. |
| track 3 pattern right | 15 | 0 to 60 | The pattern box's right edge, from the pattern's centre, in pixels. |
| track 3 pattern top | 15 | 0 to 60 | The pattern box's top edge, from the pattern's centre, in pixels. |
| track 3 search left | -40 | -150 to 0 | The search box's left edge, from the pattern's centre: how far the pattern may move from one frame to the next. |
| track 3 search bottom | -40 | -150 to 0 | The search box's bottom edge, from the pattern's centre, in pixels. |
| track 3 search right | 40 | 0 to 150 | The search box's right edge, from the pattern's centre, in pixels. |
| track 3 search top | 40 | 0 to 150 | The search box's top edge, from the pattern's centre, in pixels. |
| track 4 enable | on | Uses this track: off, it is kept but plays no part. | |
| track 4 name | top-left | The track's name. | |
| track 4 x | 480 | 0 to 2000 | The tracked point's position across, in pixels, animated by tracking. |
| track 4 y | 810 | 0 to 2000 | The tracked point's position up, in pixels, animated by tracking. |
| track 4 T | on | Drives the translation. | |
| track 4 R | off | Drives the rotation. | |
| track 4 S | off | Drives the scale. | |
| track 4 offset x | 0 | -100 to 100 | Moves the track's point away from the pattern's centre. |
| track 4 offset y | 0 | -100 to 100 | Moves the track's point up or down from the pattern's centre, in pixels. |
| track 4 error | 0 | 0 to 1 | How badly the pattern matched at each tracked frame (0: perfectly). Set by tracking. |
| track 4 pattern left | -15 | -60 to 0 | The pattern box's left edge, from the pattern's centre (the box is what is followed). |
| track 4 pattern bottom | -15 | -60 to 0 | The pattern box's bottom edge, from the pattern's centre, in pixels. |
| track 4 pattern right | 15 | 0 to 60 | The pattern box's right edge, from the pattern's centre, in pixels. |
| track 4 pattern top | 15 | 0 to 60 | The pattern box's top edge, from the pattern's centre, in pixels. |
| track 4 search left | -40 | -150 to 0 | The search box's left edge, from the pattern's centre: how far the pattern may move from one frame to the next. |
| track 4 search bottom | -40 | -150 to 0 | The search box's bottom edge, from the pattern's centre, in pixels. |
| track 4 search right | 40 | 0 to 150 | The search box's right edge, from the pattern's centre, in pixels. |
| track 4 search top | 40 | 0 to 150 | The search box's top edge, from the pattern's centre, in pixels. |
Crop
Keeps the pixels inside a box; optionally makes the box the new format.
Inputs: input.
| Setting | Default | Range or choices | What it does |
|---|---|---|---|
| left | 0 | 0 to 4096 | Left edge, in full-resolution pixels. |
| right | 0 | 0 to 4096 | Right edge (new Crops: the project format's; 0 = the input format's). |
| top | 0 | 0 to 4096 | Top edge (new Crops: the project format's; 0 = the input format's). |
| bottom | 0 | 0 to 4096 | Bottom edge. |
| softness | 0 | 0 to 100 | Fades to black over this many pixels inside the box. |
| reformat | off | The box becomes the output format, moved to the origin. | |
| black outside | on | A one-pixel black border around the box, so blurs and other filters fade to black there (Nuke's crop). |
GridWarp
Bends the image from one grid to another (Bezier grids, edited in the viewer), or morphs two images.
Inputs: src, dst (optional), bg (optional), mask (optional).
| Setting | Default | Range or choices | What it does |
|---|---|---|---|
| output | source warped | source, source warped, destination, destination warped, morph | source, destination: that input unchanged; source warped: the source bent from the source grid to the destination grid; destination warped: the reverse; morph: both bent to the grid between them at warp, mixed by mix. |
| divisions | 5 | 3 to 20 | Points across and up of a new grid (empty grids). |
| warp | 1 | 0 to 1 | How far the grid moves from the source's to the destination's. |
| mix | 0 | 0 to 1 | morph: from the source (0) to the destination (1). |
| background | on src | on black, on src, on dst, on bg | What shows outside the warped grid. |
| bbox | union | union, format | The area the result covers: format, the input's format only; union, its format and its pixels outside it. |
| render resolution | 10 | 1 to 50 | Triangles per grid cell side (Nuke's). |
| filter | cubic | impulse, bilinear, cubic, Keys, Simon, Rifman, Mitchell, Parzen, notch, Lanczos4, Lanczos6, sinc4 | Nuke's filters. impulse: nearest pixel; cubic: smooth, no overshoot; Keys, Simon, Rifman: sharper, in that order; Mitchell: between; Parzen: softest; notch: flat, against moire; Lanczos4, Lanczos6: sharpest, with ringing; sinc4: sharper still. |
| invert mask | off | Use 1 - the mask's alpha. |
UV Displace
Type name: IDistort (scripts, MCP and Nuke import use it).
Moves pixels by a uv pair of channels (a motion or distortion pass).
Inputs: input, mask (optional).
| Setting | Default | Range or choices | What it does |
|---|---|---|---|
| channels | all | rgb, rgba, alpha, all | rgb, rgba, alpha, all, or a layer (depth) or channel by name, as Nuke's. |
| uv | none | The uv layer (its first two channels), or two channel names: "R G". | |
| uv offset | 0 | -1 to 1 | Taken off u and v first. |
| uv scale | 1 | 0 to 10 | Multiplies u and v: each pixel reads the input this many pixels per unit of uv away. |
| blur | none | Kept for Nuke scripts. | |
| blur scale | 1 | 0 to 10 | Kept for Nuke scripts. |
| premultiplied | off | Kept for Nuke scripts. | |
| filter | cubic | impulse, cubic, Keys, Simon, Rifman, Mitchell, Parzen, notch, Lanczos4, Lanczos6, sinc4 | How the moved pixels are sampled (Transform's filters). |
| invert mask | off | Use 1 - the mask's alpha. |
LensDistortion
Removes a lens's distortion (Undistort), puts it back (Redistort), or renders both as STMaps, from a lens model with Nuke's knobs, measured against Nuke 16 (radial, asymmetric, tangential, anamorphic squeeze). STMap passes the input through and adds the maps as forward.u/v (undistort) and backward.u/v (redistort). Not built: grid detection and solving, fisheye projections, anamorphic twist and scale, beam splitter.
Inputs: src (optional).
| Setting | Default | Range or choices | What it does |
|---|---|---|---|
| model preset | NukeX Classic | NukeX Classic, CaraVR Radial, Degree 3, 3DEqualizer/3DE Classic LD Model, 3DEqualizer/3DE4 Radial - Standard, Degree 4, 3DEqualizer/3DE4 Radial - Fisheye, Degree 8, 3DEqualizer/3DE4 Anamorphic - Standard, Degree 4, 3DEqualizer/3DE4 Anamorphic, Degree 6, Custom | A label for the model's source: as in Nuke, choosing a preset changes none of the knobs below (measured in Nuke 16). |
| lens type | Spherical | Spherical, Anamorphic | Anamorphic divides x's coefficients by the squeeze. |
| squeeze | 1 | 1 to 2 | The anamorphic squeeze: x's coefficients are divided by it. |
| type | Radial Standard | Radial Standard, Radial Asymmetric, Radial-Tangential/R-T Coupled, Radial-Tangential/R-T Uncoupled | Radial Standard: numerators and denominators. Radial Asymmetric: x and y have their own coefficients (X, Y). R-T Coupled adds tangential terms from tangent p1 and p2; R-T Uncoupled from the T and U polynomials. |
| direction | Forward | Forward, Backward | Forward: the model takes undistorted points to distorted ones. |
| order numerator | 0 | 0 to 4 | How many numerator terms are used (0 to 4). |
| order denominator | 2 | 0 to 4 | How many denominator terms are used (0 to 4). |
| exponent numerator | 2 | 1 to 4 | The numerator's terms are powers of the radius to this exponent (term i: r^(e (i + 1))). |
| exponent denominator | 2 | 1 to 4 | The denominator's terms are powers of the radius to this exponent (term i: r^(e (i + 1))). |
| numerator 0 | 0 | -1 to 1 | The radial numerator's coefficient of term 0, used while it is within the numerator's order. |
| numerator 1 | 0 | -1 to 1 | The radial numerator's coefficient of term 1, used while it is within the numerator's order. |
| numerator 2 | 0 | -1 to 1 | The radial numerator's coefficient of term 2, used while it is within the numerator's order. |
| numerator 3 | 0 | -1 to 1 | The radial numerator's coefficient of term 3, used while it is within the numerator's order. |
| denominator 0 | 0 | -1 to 1 | The radial denominator's coefficient of term 0, used while it is within the denominator's order. |
| denominator 1 | 0 | -1 to 1 | The radial denominator's coefficient of term 1, used while it is within the denominator's order. |
| denominator 2 | 0 | -1 to 1 | The radial denominator's coefficient of term 2, used while it is within the denominator's order. |
| denominator 3 | 0 | -1 to 1 | The radial denominator's coefficient of term 3, used while it is within the denominator's order. |
| numerator X00 | 0 | -1 to 1 | A coefficient of X's factor: harmonic 0 (cos 2h of the angle), degree 0; used while its power is within the order. |
| numerator X01 | 0 | -1 to 1 | A coefficient of X's factor: harmonic 0 (cos 2h of the angle), degree 1; used while its power is within the order. |
| numerator X02 | 0 | -1 to 1 | A coefficient of X's factor: harmonic 0 (cos 2h of the angle), degree 2; used while its power is within the order. |
| numerator X10 | 0 | -1 to 1 | A coefficient of X's factor: harmonic 1 (cos 2h of the angle), degree 0; used while its power is within the order. |
| numerator X11 | 0 | -1 to 1 | A coefficient of X's factor: harmonic 1 (cos 2h of the angle), degree 1; used while its power is within the order. |
| numerator X12 | 0 | -1 to 1 | A coefficient of X's factor: harmonic 1 (cos 2h of the angle), degree 2; used while its power is within the order. |
| numerator X20 | 0 | -1 to 1 | A coefficient of X's factor: harmonic 2 (cos 2h of the angle), degree 0; used while its power is within the order. |
| numerator X21 | 0 | -1 to 1 | A coefficient of X's factor: harmonic 2 (cos 2h of the angle), degree 1; used while its power is within the order. |
| numerator X30 | 0 | -1 to 1 | A coefficient of X's factor: harmonic 3 (cos 2h of the angle), degree 0; used while its power is within the order. |
| denominator X00 | 0 | -1 to 1 | A coefficient of X's factor: harmonic 0 (cos 2h of the angle), degree 0; used while its power is within the order. |
| denominator X01 | 0 | -1 to 1 | A coefficient of X's factor: harmonic 0 (cos 2h of the angle), degree 1; used while its power is within the order. |
| denominator X02 | 0 | -1 to 1 | A coefficient of X's factor: harmonic 0 (cos 2h of the angle), degree 2; used while its power is within the order. |
| denominator X10 | 0 | -1 to 1 | A coefficient of X's factor: harmonic 1 (cos 2h of the angle), degree 0; used while its power is within the order. |
| denominator X11 | 0 | -1 to 1 | A coefficient of X's factor: harmonic 1 (cos 2h of the angle), degree 1; used while its power is within the order. |
| denominator X12 | 0 | -1 to 1 | A coefficient of X's factor: harmonic 1 (cos 2h of the angle), degree 2; used while its power is within the order. |
| denominator X20 | 0 | -1 to 1 | A coefficient of X's factor: harmonic 2 (cos 2h of the angle), degree 0; used while its power is within the order. |
| denominator X21 | 0 | -1 to 1 | A coefficient of X's factor: harmonic 2 (cos 2h of the angle), degree 1; used while its power is within the order. |
| denominator X30 | 0 | -1 to 1 | A coefficient of X's factor: harmonic 3 (cos 2h of the angle), degree 0; used while its power is within the order. |
| numerator Y00 | 0 | -1 to 1 | A coefficient of Y's factor: harmonic 0 (cos 2h of the angle), degree 0; used while its power is within the order. |
| numerator Y01 | 0 | -1 to 1 | A coefficient of Y's factor: harmonic 0 (cos 2h of the angle), degree 1; used while its power is within the order. |
| numerator Y02 | 0 | -1 to 1 | A coefficient of Y's factor: harmonic 0 (cos 2h of the angle), degree 2; used while its power is within the order. |
| numerator Y10 | 0 | -1 to 1 | A coefficient of Y's factor: harmonic 1 (cos 2h of the angle), degree 0; used while its power is within the order. |
| numerator Y11 | 0 | -1 to 1 | A coefficient of Y's factor: harmonic 1 (cos 2h of the angle), degree 1; used while its power is within the order. |
| numerator Y12 | 0 | -1 to 1 | A coefficient of Y's factor: harmonic 1 (cos 2h of the angle), degree 2; used while its power is within the order. |
| numerator Y20 | 0 | -1 to 1 | A coefficient of Y's factor: harmonic 2 (cos 2h of the angle), degree 0; used while its power is within the order. |
| numerator Y21 | 0 | -1 to 1 | A coefficient of Y's factor: harmonic 2 (cos 2h of the angle), degree 1; used while its power is within the order. |
| numerator Y30 | 0 | -1 to 1 | A coefficient of Y's factor: harmonic 3 (cos 2h of the angle), degree 0; used while its power is within the order. |
| denominator Y00 | 0 | -1 to 1 | A coefficient of Y's factor: harmonic 0 (cos 2h of the angle), degree 0; used while its power is within the order. |
| denominator Y01 | 0 | -1 to 1 | A coefficient of Y's factor: harmonic 0 (cos 2h of the angle), degree 1; used while its power is within the order. |
| denominator Y02 | 0 | -1 to 1 | A coefficient of Y's factor: harmonic 0 (cos 2h of the angle), degree 2; used while its power is within the order. |
| denominator Y10 | 0 | -1 to 1 | A coefficient of Y's factor: harmonic 1 (cos 2h of the angle), degree 0; used while its power is within the order. |
| denominator Y11 | 0 | -1 to 1 | A coefficient of Y's factor: harmonic 1 (cos 2h of the angle), degree 1; used while its power is within the order. |
| denominator Y12 | 0 | -1 to 1 | A coefficient of Y's factor: harmonic 1 (cos 2h of the angle), degree 2; used while its power is within the order. |
| denominator Y20 | 0 | -1 to 1 | A coefficient of Y's factor: harmonic 2 (cos 2h of the angle), degree 0; used while its power is within the order. |
| denominator Y21 | 0 | -1 to 1 | A coefficient of Y's factor: harmonic 2 (cos 2h of the angle), degree 1; used while its power is within the order. |
| denominator Y30 | 0 | -1 to 1 | A coefficient of Y's factor: harmonic 3 (cos 2h of the angle), degree 0; used while its power is within the order. |
| numerator T0 | 0 | -1 to 1 | A coefficient of the tangential p1 polynomial in the radius (term 0). |
| numerator T1 | 0 | -1 to 1 | A coefficient of the tangential p1 polynomial in the radius (term 1). |
| numerator T2 | 0 | -1 to 1 | A coefficient of the tangential p1 polynomial in the radius (term 2). |
| numerator T3 | 0 | -1 to 1 | A coefficient of the tangential p1 polynomial in the radius (term 3). |
| denominator T0 | 0 | -1 to 1 | A coefficient of the tangential p1 polynomial in the radius (term 0). |
| denominator T1 | 0 | -1 to 1 | A coefficient of the tangential p1 polynomial in the radius (term 1). |
| denominator T2 | 0 | -1 to 1 | A coefficient of the tangential p1 polynomial in the radius (term 2). |
| denominator T3 | 0 | -1 to 1 | A coefficient of the tangential p1 polynomial in the radius (term 3). |
| numerator U0 | 0 | -1 to 1 | A coefficient of the tangential p2 polynomial in the radius (term 0). |
| numerator U1 | 0 | -1 to 1 | A coefficient of the tangential p2 polynomial in the radius (term 1). |
| numerator U2 | 0 | -1 to 1 | A coefficient of the tangential p2 polynomial in the radius (term 2). |
| numerator U3 | 0 | -1 to 1 | A coefficient of the tangential p2 polynomial in the radius (term 3). |
| denominator U0 | 0 | -1 to 1 | A coefficient of the tangential p2 polynomial in the radius (term 0). |
| denominator U1 | 0 | -1 to 1 | A coefficient of the tangential p2 polynomial in the radius (term 1). |
| denominator U2 | 0 | -1 to 1 | A coefficient of the tangential p2 polynomial in the radius (term 2). |
| denominator U3 | 0 | -1 to 1 | A coefficient of the tangential p2 polynomial in the radius (term 3). |
| tangent p1 | 0 | -0.1 to 0.1 | The first tangential coefficient (p1), as Nuke's. |
| tangent p2 | 0 | -0.1 to 0.1 | The second tangential coefficient (p2), as Nuke's. |
| centre x | 0 | -0.2 to 0.2 | The distortion centre, from the format's centre in normalised units. |
| centre y | 0 | -0.2 to 0.2 | The distortion centre's height, from the format's centre in normalised units. |
| normalisation | Maximum | Width, Height, Diagonal, Maximum | The radius 1 of the model: half the format's width, height, diagonal or larger side. |
| mode | Undistort | STMap, Undistort, Redistort | Undistort removes the distortion, Redistort adds it; STMap passes the input through and adds the maps as forward.u/v (undistort) and backward.u/v (redistort). |
| filter | cubic | impulse, bilinear, cubic, Keys, Simon, Rifman, Mitchell, Parzen, notch, Lanczos4, Lanczos6, sinc4 | Kept for scripts: sampling is bilinear for now. |
| projection | None (Rectilinear) | None (Rectilinear), Fisheye/Fisheye Stereographic, Fisheye/Fisheye Equidistant, Fisheye/Fisheye Equisolid, Fisheye/Fisheye Orthographic | Kept for scripts: fisheye projections aren't applied yet. |
MakeLatLongMap
Six cube faces (right, left, top, bottom, front, back) into a lat-long.
Inputs: right (optional), left (optional), top (optional), bottom (optional), front, back (optional).
| Setting | Default | Range or choices | What it does |
|---|---|---|---|
| invert U | off | Flip the lat-long left to right. | |
| invert V | off | Flip the lat-long upside down. | |
| Rotation Order | ZXY | XYZ, XZY, YXZ, YZX, ZXY, ZYX | The order the x, y and z rotations are applied in (ZXY: z first). |
| rx | 0 | -180 to 180 | The sphere's rotation about x, in degrees. |
| ry | 0 | -180 to 180 | The sphere's rotation about y, in degrees. |
| rz | 0 | -180 to 180 | The sphere's rotation about z, in degrees. |
| output | Lat Long map | Lat Long map, Light Probe (Angular Map), Orthographic Sphere | Ours makes the lat-long only (the others kept). |
| filter | cubic | impulse, cubic, Keys, Simon, Rifman, Mitchell, Parzen, notch, Lanczos4, Lanczos6, sinc4 | Nuke's (kept; ours is bilinear). |
| filter size | 1 | 0 to 4 | Kept for Nuke scripts, not used (the faces are read bilinearly). |
Match Move
Type name: MatchMove (scripts, MCP and Nuke import use it).
Follows two points through the shot and moves the image on its "image" input with them (with nothing connected there the plate passes unchanged): the pivot for the move, the transform track (when tracked) for rotation and scale.
Inputs: src, match-move image (optional), mask (optional, a mask).
| Setting | Default | Range or choices | What it does |
|---|---|---|---|
| reference frame | 1 | 1 to 100 | The frame at which the output equals the input. |
| filter | cubic | impulse, bilinear, cubic, Keys, Simon, Rifman, Mitchell, Parzen, notch, Lanczos4, Lanczos6, sinc4 | Nuke's filters. impulse: nearest pixel; cubic: smooth, no overshoot; Keys, Simon, Rifman: sharper, in that order; Mitchell: between; Parzen: softest; notch: flat, against moire; Lanczos4, Lanczos6: sharpest, with ringing; sinc4: sharper still. |
| black outside | on | Black outside the picture's edges instead of repeating them. | |
| over plate | off | Match-move with an image on the "image" input: put the moved image over the plate (premultiplied). Off: the moved image alone (as a Transform on it, Nuke's way). | |
| merge tracks | off | Moves the picture with all the track pairs' motion, chained frame by frame: where one pair leaves the frame another carries on, without a jump. Off: the first pair alone. "add track pair" turns it on. | |
| extrapolate | off | Before a track's first key and after its last, its position goes on as it was moving instead of stopping (as the curve editor's before/after setting, worked out live; the keys stay as they are). For tracks that leave the frame or start late. | |
| extrapolate as | linear | linear, extrapolate, exponential | Linear: at the speed of the end key. Extrapolate: with the speed and acceleration of the last keys. Exponential: the speed changing by the same ratio each frame (the curve editor's end settings). |
| track 1 enable | on | Uses the pivot track: off, the node moves nothing. | |
| track 1 name | pivot | The track's name (pivot or transform unless renamed). | |
| track 1 x | 960 | 0 to 2000 | The pivot's position in pixels, animated by tracking: its motion gives the move. |
| track 1 y | 540 | 0 to 2000 | The pivot's position in pixels, animated by tracking: its motion gives the move. |
| track 1 T | on | Drives the translation. | |
| track 1 R | off | Drives the rotation. | |
| track 1 S | off | Drives the scale. | |
| track 1 offset x | 0 | -100 to 100 | Moves the track's point away from the pattern's centre. |
| track 1 offset y | 0 | -100 to 100 | Moves the track's point up or down from the pattern's centre, in pixels. |
| track 1 error | 0 | 0 to 1 | How badly the pattern matched at each tracked frame (0: perfectly). Set by tracking. |
| track 1 pattern left | -15 | -60 to 0 | The pattern box's left edge, from the pattern's centre (the box is what is followed). |
| track 1 pattern bottom | -15 | -60 to 0 | The pattern box's bottom edge, from the pattern's centre, in pixels. |
| track 1 pattern right | 15 | 0 to 60 | The pattern box's right edge, from the pattern's centre, in pixels. |
| track 1 pattern top | 15 | 0 to 60 | The pattern box's top edge, from the pattern's centre, in pixels. |
| track 1 search left | -40 | -150 to 0 | The search box's left edge, from the pattern's centre: how far the pattern may move from one frame to the next. |
| track 1 search bottom | -40 | -150 to 0 | The search box's bottom edge, from the pattern's centre, in pixels. |
| track 1 search right | 40 | 0 to 150 | The search box's right edge, from the pattern's centre, in pixels. |
| track 1 search top | 40 | 0 to 150 | The search box's top edge, from the pattern's centre, in pixels. |
| track 2 enable | on | Uses the transform track for rotation and scale (once it has been tracked). | |
| track 2 name | transform | The track's name (pivot or transform unless renamed). | |
| track 2 x | 1200 | 0 to 2000 | The transform track's position in pixels, animated by tracking: its turn and distance about the pivot give the rotation and scale. |
| track 2 y | 540 | 0 to 2000 | The transform track's position in pixels, animated by tracking: its turn and distance about the pivot give the rotation and scale. |
| track 2 T | on | Drives the translation. | |
| track 2 R | off | Drives the rotation. | |
| track 2 S | off | Drives the scale. | |
| track 2 offset x | 0 | -100 to 100 | Moves the track's point away from the pattern's centre. |
| track 2 offset y | 0 | -100 to 100 | Moves the track's point up or down from the pattern's centre, in pixels. |
| track 2 error | 0 | 0 to 1 | How badly the pattern matched at each tracked frame (0: perfectly). Set by tracking. |
| track 2 pattern left | -15 | -60 to 0 | The pattern box's left edge, from the pattern's centre (the box is what is followed). |
| track 2 pattern bottom | -15 | -60 to 0 | The pattern box's bottom edge, from the pattern's centre, in pixels. |
| track 2 pattern right | 15 | 0 to 60 | The pattern box's right edge, from the pattern's centre, in pixels. |
| track 2 pattern top | 15 | 0 to 60 | The pattern box's top edge, from the pattern's centre, in pixels. |
| track 2 search left | -40 | -150 to 0 | The search box's left edge, from the pattern's centre: how far the pattern may move from one frame to the next. |
| track 2 search bottom | -40 | -150 to 0 | The search box's bottom edge, from the pattern's centre, in pixels. |
| track 2 search right | 40 | 0 to 150 | The search box's right edge, from the pattern's centre, in pixels. |
| track 2 search top | 40 | 0 to 150 | The search box's top edge, from the pattern's centre, in pixels. |
| display gizmo | on | Shows a green box over the image on the "image" input in the viewer: drag inside to move it, a corner to scale it, an edge to stretch it, the handle above it to turn it. | |
| translate x | 0 | -1000 to 1000 | Moves the image sideways at the reference frame, in pixels, before the tracked motion. |
| translate y | 0 | -1000 to 1000 | Moves the image up or down at the reference frame, in pixels, before the tracked motion. |
| rotate | 0 | -180 to 180 | Turns the image about its centre, in degrees, before the tracked motion. |
| scale x | 1 | 0 to 4 | Scales the image's width about its centre (1: unchanged), before the tracked motion. |
| scale y | 1 | 0 to 4 | Scales the image's height about its centre (1: unchanged), before the tracked motion. |
| motion blur | 0 | 0 to 4 | Motion blur quality: 0 off; each 0.1 is one more sample (Nuke's knob). |
| shutter angle | 180 | 0 to 360 | Degrees, as a film camera's (180: open half a frame). Nuke's shutter x 360. |
| shutter offset | start | start, centred, end, custom | Where the shutter opens: at the frame (start), around it, before it, or at the custom offset. |
| custom offset | 0 | -1 to 1 | Where the shutter opens, in frames from the frame (shutter offset custom). |
Merge Tracks
Type name: MergeTracks (scripts, MCP and Nuke import use it).
Merges trackers (Tracker, Stabilize, Match Move) on its yellow inputs into one motion, frame by frame: where one track leaves the frame another carries on. Moves the image on "image" with it, alone or over the plate. JOS only.
Inputs: plate (optional), image (optional), tracker (optional, a tracker); more as you connect them.
| Setting | Default | Range or choices | What it does |
|---|---|---|---|
| reference frame | 1 | 1 to 100 | The frame at which the image sits as placed: the motion is from there. |
| over plate | off | Put the moved image over the plate (premultiplied). Off: the moved image alone. | |
| display gizmo | off | Shows a green box over the image in the viewer: drag inside to move it, a corner to scale it, an edge to stretch it, the handle above it to turn it. | |
| translate x | 0 | -1000 to 1000 | Moves the image across at the reference frame, in pixels. |
| translate y | 0 | -1000 to 1000 | Moves the image up at the reference frame, in pixels. |
| rotate | 0 | -180 to 180 | Turns the image at the reference frame, in degrees. |
| scale x | 1 | 0 to 4 | The image's width at the reference frame, times this. |
| scale y | 1 | 0 to 4 | The image's height at the reference frame, times this. |
| filter | cubic | impulse, bilinear, cubic, Keys, Simon, Rifman, Mitchell, Parzen, notch, Lanczos4, Lanczos6, sinc4 | Nuke's filters. impulse: nearest pixel; cubic: smooth, no overshoot; Keys, Simon, Rifman: sharper, in that order; Mitchell: between; Parzen: softest; notch: flat, against moire; Lanczos4, Lanczos6: sharpest, with ringing; sinc4: sharper still. |
| black outside | on | Black outside the picture's edges instead of repeating them. | |
| motion blur | 0 | 0 to 4 | Motion blur quality: 0 off; each 0.1 is one more sample (Nuke's knob). |
| shutter angle | 180 | 0 to 360 | Degrees, as a film camera's (180: open half a frame). Nuke's shutter x 360. |
| shutter offset | start | start, centred, end, custom | Where the shutter opens: at the frame (start), around it, before it, or at the custom offset. |
| custom offset | 0 | -1 to 1 | Where the shutter opens, in frames from the frame (shutter offset custom). |
Mirror
Flips the image upside down (flip) or left to right (flop).
Inputs: input.
| Setting | Default | Range or choices | What it does |
|---|---|---|---|
| flip | off | Upside down. | |
| flop | off | Left to right. |
Perspective Distort
Type name: PerspDistort (scripts, MCP and Nuke import use it).
A rectilinear picture of a field of view as an equidistant one, or back.
Inputs: input.
| Setting | Default | Range or choices | What it does |
|---|---|---|---|
| channels | all | rgba, rgb, alpha, all | The channels the node changes; the others pass through. |
| Field of View | 45 | 1 to 179 | The picture's horizontal field of view, in degrees (1 to 179). |
| reverse | off | Turn an equidistant (fisheye-like) picture back into a rectilinear one. | |
| resize bounding box | off | Kept for Nuke scripts, not used. | |
| filter | cubic | impulse, cubic, Keys, Simon, Rifman, Mitchell, Parzen, notch, Lanczos4, Lanczos6, sinc4 | Nuke's (kept; ours is bilinear). |
PlanarTracker
Follows a flat surface (a screen, a wall, a sign) through the shot from points inside it; an image on "insert" is placed on the plane (over the plate). Export makes a CornerPin2D that follows it.
Inputs: Source, insert (optional), mask (optional, a mask).
| Setting | Default | Range or choices | What it does |
|---|---|---|---|
| motion | Perspective | Translation, T + Scale, S + Rotation, TS + Rotation, TSR + Shear, Perspective | How the plane may move from frame to frame. |
| reference frame | 1 | 1 to 100 | The frame the plane was drawn at (set by the first tracking run). |
| features | 100 | 10 to 500 | How many points inside the plane are followed. |
| feature threshold | 0.05 | 0.001 to 0.5 | The weakest point used, as a fraction of the strongest. |
| feature separation | 9 | 1 to 50 | The closest two points may be, in pixels. |
| match threshold | 0.7 | 0 to 1 | How alike a point must look in the next frame to be followed. |
| bottom left x | 480 | -500 to 2500 | The plane's corner at this frame (a key per tracked frame). |
| bottom left y | 270 | -500 to 2500 | The plane's corner at this frame (a key per tracked frame). |
| bottom right x | 1440 | -500 to 2500 | The plane's corner at this frame (a key per tracked frame). |
| bottom right y | 270 | -500 to 2500 | The plane's corner at this frame (a key per tracked frame). |
| top right x | 1440 | -500 to 2500 | The plane's corner at this frame (a key per tracked frame). |
| top right y | 810 | -500 to 2500 | The plane's corner at this frame (a key per tracked frame). |
| top left x | 480 | -500 to 2500 | The plane's corner at this frame (a key per tracked frame). |
| top left y | 810 | -500 to 2500 | The plane's corner at this frame (a key per tracked frame). |
| bottom left x | 480 | -500 to 2500 | The plane's corner as drawn at the reference frame. |
| bottom left y | 270 | -500 to 2500 | The plane's corner as drawn at the reference frame. |
| bottom right x | 1440 | -500 to 2500 | The plane's corner as drawn at the reference frame. |
| bottom right y | 270 | -500 to 2500 | The plane's corner as drawn at the reference frame. |
| top right x | 1440 | -500 to 2500 | The plane's corner as drawn at the reference frame. |
| top right y | 810 | -500 to 2500 | The plane's corner as drawn at the reference frame. |
| top left x | 480 | -500 to 2500 | The plane's corner as drawn at the reference frame. |
| top left y | 810 | -500 to 2500 | The plane's corner as drawn at the reference frame. |
| placement | follow motion | follow motion, fit to surface | Follow motion: the insert, as it lies on the plate at the reference frame, moves with the plane (Nuke's relative CornerPin2D). Fit to surface: the insert's corners go onto the surface's (Nuke's absolute CornerPin2D). |
| display gizmo | off | Shows a box over the insert in the viewer: drag inside to move it on the plane, a corner to scale it, an edge to stretch it, the handle above it to turn it. | |
| translate x | 0 | -1000 to 1000 | Moves the insert in the plane (pixels of the insert's format). |
| translate y | 0 | -1000 to 1000 | Moves the insert in the plane (pixels of the insert's format). |
| rotate | 0 | -180 to 180 | Turns the insert in the plane, about its centre (degrees). |
| scale x | 1 | 0 to 4 | Scales the insert in the plane, about its centre: it grows along the plane's perspective. |
| scale y | 1 | 0 to 4 | Scales the insert in the plane, about its centre: it grows along the plane's perspective. |
| skew | 0 | -1 to 1 | Shears the insert in the plane (x moves with y). |
| over plate | on | Puts the placed insert over the plate (premultiplied; an insert without alpha is opaque over its format). Off: the placed insert alone. | |
| filter | cubic | impulse, bilinear, cubic, Keys, Simon, Rifman, Mitchell, Parzen, notch, Lanczos4, Lanczos6, sinc4 | Nuke's filters. impulse: nearest pixel; cubic: smooth, no overshoot; Keys, Simon, Rifman: sharper, in that order; Mitchell: between; Parzen: softest; notch: flat, against moire; Lanczos4, Lanczos6: sharpest, with ringing; sinc4: sharper still. |
| motion blur | 0 | 0 to 4 | Motion blur quality: 0 off; each 0.1 is one more sample (Nuke's knob). |
| shutter angle | 180 | 0 to 360 | Degrees, as a film camera's (180: open half a frame). Nuke's shutter x 360. |
| shutter offset | start | start, centred, end, custom | Where the shutter opens: at the frame (start), around it, before it, or at the custom offset. |
| custom offset | 0 | -1 to 1 | Where the shutter opens, in frames from the frame (shutter offset custom). |
| mix | 1 | 0 to 1 | How much of the result shows over the plate (0: the plate). |
| keep occlusion in front | off | Off (default): the occlusion shapes and input only keep the tracking off what covers the plane. On: what they cover of the plate (a finger over the screen) also stays in front of the insert; without "over plate" it is cut out of the insert. |
Reformat
Resizes the image to a new format (width x height) or by a scale factor.
Inputs: input.
| Setting | Default | Range or choices | What it does |
|---|---|---|---|
| type | to format | to format, to box, scale | to format: a new width and height; to box: a box the image is fitted to; scale: the format times a factor. |
| width | 1920 | 1 to 4096 | New format width. |
| height | 1080 | 1 to 4096 | New format height. |
| box width | 200 | 1 to 4096 | The box's width. |
| box height | 200 | 1 to 4096 | The box's height. |
| force this shape | off | The format is the box. Off: the image's size once resized (the box itself for none and distort). | |
| scale | 1 | 0.1 to 4 | Format times this. |
| scale x | 1 | 0.1 to 4 | Times scale, the width (Nuke's scale {x y}). |
| scale y | 1 | 0.1 to 4 | Times scale, the height. |
| resize | width | none, width, height, fit, fill, distort | How the image fits the new format: scaled to its width, its height, to fit inside, to fill it, or stretched (distort). |
| center | on | Centre the image in the new format; off: bottom-left corners meet. | |
| flip | off | Upside down. | |
| flop | off | Mirrored left to right. | |
| filter | cubic | impulse, bilinear, cubic, Keys, Simon, Rifman, Mitchell, Parzen, notch, Lanczos4, Lanczos6, sinc4 | Nuke's filters. impulse: nearest pixel; cubic: smooth, no overshoot; Keys, Simon, Rifman: sharper, in that order; Mitchell: between; Parzen: softest; notch: flat, against moire; Lanczos4, Lanczos6: sharpest, with ringing; sinc4: sharper still. |
| clamp | off | Keep filtered values within their neighbours (no overshoot). | |
| black outside | off | Outside the input is black, with soft edges. Off: edge pixels are extended. | |
| preserve bounding box | off | Keep the pixels outside the new format (for nodes after it that move them in). Off: cut at the format. |
UV Remap
Type name: STMap (scripts, MCP and Nuke import use it).
Moves pixels by a map: each output pixel takes the source where the map's u and v (0 to 1 across the source) point. Lens distortion and warps baked into images.
Inputs: src, stmap.
| Setting | Default | Range or choices | What it does |
|---|---|---|---|
| u | R | The map channel giving u (across). | |
| v | G | The map channel giving v (up). | |
| filter | cubic | impulse, bilinear, cubic, Keys, Simon, Rifman, Mitchell, Parzen, notch, Lanczos4, Lanczos6, sinc4 | Nuke's filters. impulse: nearest pixel; cubic: smooth, no overshoot; Keys, Simon, Rifman: sharper, in that order; Mitchell: between; Parzen: softest; notch: flat, against moire; Lanczos4, Lanczos6: sharpest, with ringing; sinc4: sharper still. |
SphereToLatLongMap
A mirror ball turned into a lat-long.
Inputs: input.
| Setting | Default | Range or choices | What it does |
|---|---|---|---|
| filter | cubic | impulse, cubic, Keys, Simon, Rifman, Mitchell, Parzen, notch, Lanczos4, Lanczos6, sinc4 | Nuke's (kept; ours is bilinear). |
| rx | 0 | -180 to 180 | The sphere's rotation about x, in degrees. |
| ry | -90 | -180 to 180 | The sphere's rotation about y, in degrees. |
| rz | 0 | -180 to 180 | The sphere's rotation about z, in degrees. |
| Rotation Order | ZXY | XYZ, XZY, YXZ, YZX, ZXY, ZYX | The order the x, y and z rotations are applied in (ZXY: z first). |
SphericalMap
A lat-long turned into a mirror ball.
Inputs: input.
| Setting | Default | Range or choices | What it does |
|---|---|---|---|
| rx | 0 | -180 to 180 | The sphere's rotation about x, in degrees. |
| ry | 90 | -180 to 180 | The sphere's rotation about y, in degrees. |
| rz | 0 | -180 to 180 | The sphere's rotation about z, in degrees. |
| Rotation Order | ZXY | XYZ, XZY, YXZ, YZX, ZXY, ZYX | The order the x, y and z rotations are applied in (ZXY: z first). |
| Filter? | off | How pixels are resampled when the picture moves or scales. | |
| Bi-Linear Interpolation? | off | Kept for Nuke scripts, not used (the lat-long is always read bilinearly). | |
| Reduce Cache Usage (Increase Render Time)? | off | Kept for Nuke scripts, not used. |
SphericalTransform
An environment image from one projection to another (lat-long, mirror ball, light probes, fisheye...).
Inputs: input.
| Setting | Default | Range or choices | What it does |
|---|---|---|---|
| input type | Mirror Ball | Mirror Ball, Lat Long map, Cube, Light Probe, Light Probe 360, Orthographic Sphere, Fisheye | The projection the input image is in. |
| input rotation order | ZXY | XYZ, XZY, YXZ, YZX, ZXY, ZYX | The order of the input's x, y and z rotations, as Nuke's. |
| input rotate x | 0 | -180 to 180 | Turns the input about x, in degrees. |
| input rotate y | 0 | -180 to 180 | Turns the input about y, in degrees. |
| input rotate z | 0 | -180 to 180 | Turns the input about z, in degrees. |
| output type | Lat Long map | Mirror Ball, Lat Long map, Cube, Light Probe, Light Probe 360, Orthographic Sphere, Fisheye | The projection the result is made in. |
| output rotation order | ZXY | XYZ, XZY, YXZ, YZX, ZXY, ZYX | The order of the output's x, y and z rotations, as Nuke's. |
| output rotate x | 0 | -180 to 180 | Turns the output about x, in degrees. |
| output rotate y | 0 | -180 to 180 | Turns the output about y, in degrees. |
| output rotate z | 0 | -180 to 180 | Turns the output about z, in degrees. |
| width | 0 | 0 to 8192 | The output size; 0: the project's format. |
| height | 0 | 0 to 8192 | The output height in pixels; 0: the project's format. |
| filter | cubic | impulse, bilinear, cubic, Keys, Simon, Rifman, Mitchell, Parzen, notch, Lanczos4, Lanczos6, sinc4 | Nuke's filters. impulse: nearest pixel; cubic: smooth, no overshoot; Keys, Simon, Rifman: sharper, in that order; Mitchell: between; Parzen: softest; notch: flat, against moire; Lanczos4, Lanczos6: sharpest, with ringing; sinc4: sharper still. |
SplineWarp
Warps the picture with curve pairs: what lies on each source shape moves to its joined destination shape.
Inputs: A (optional), B (optional), mask (optional).
| Setting | Default | Range or choices | What it does |
|---|---|---|---|
| output | A warped | A, A warped, B, B warped, AB morph | A: the A input unchanged; A warped: A moved from the source shapes onto their destinations; B and B warped: the same for B (moved the other way); AB morph: A warped dissolving into B warped by mix. |
| mix | 0 | 0 to 1 | AB morph: from A warped (0) to B warped (1). |
| channels | all | rgb, rgba, alpha, all | rgb, rgba, alpha, all, or a layer (depth) or channel by name, as Nuke's. |
| premultiply | off | Kept for Nuke scripts; not applied yet. | |
| crop to format | on | On: the result stops at the input's format. Off: it also covers the input's area outside the format. | |
| autokey | on | Key the whole shape at the current frame when it is drawn or its points are edited (Nuke's AutoKey). Off: a shape without keys changes on every frame. | |
| hold the format's edge | on | The image's edge doesn't move (the warp fades towards it). | |
| warp | 1 | 0 to 1 | How much of the warp: 0 none, 1 all. |
| curve resolution | 3 | 1 to 10 | How many points each shape is sampled into for the warp (more: follows the curves more closely, slower). |
| filter | cubic | impulse, cubic, Keys, Simon, Rifman, Mitchell, Parzen, notch | Kept for Nuke scripts: sampling is bilinear for now. |
StabTrack
A Tracker's motion (named) applied: stabilize or track.
Inputs: input.
| Setting | Default | Range or choices | What it does |
|---|---|---|---|
| Tracker Node | Tracker1 | The name of the Tracker whose tracks move the picture. | |
| Operation | Stabilize | Stabilize, Track | Stabilize undoes the tracks' motion since the tracker's reference frame; Track follows it. |
| Transform | on | Use the tracks' translation. | |
| Rotate | on | Turns the picture, in degrees. | |
| Scale | on | Use the tracks' change of size. | |
| Black Outside | on | Black outside the moved picture (off: its edge pixels repeat). |
Stabilize
Follows two points through the shot and undoes their motion on the plate: the pivot for the move, the transform track (when tracked) for rotation and scale.
Inputs: src, mask (optional, a mask).
| Setting | Default | Range or choices | What it does |
|---|---|---|---|
| reference frame | 1 | 1 to 100 | The frame at which the output equals the input. |
| filter | cubic | impulse, bilinear, cubic, Keys, Simon, Rifman, Mitchell, Parzen, notch, Lanczos4, Lanczos6, sinc4 | Nuke's filters. impulse: nearest pixel; cubic: smooth, no overshoot; Keys, Simon, Rifman: sharper, in that order; Mitchell: between; Parzen: softest; notch: flat, against moire; Lanczos4, Lanczos6: sharpest, with ringing; sinc4: sharper still. |
| black outside | on | Black outside the picture's edges instead of repeating them. | |
| over plate | off | Match-move with an image on the "image" input: put the moved image over the plate (premultiplied). Off: the moved image alone (as a Transform on it, Nuke's way). | |
| merge tracks | off | Moves the picture with all the track pairs' motion, chained frame by frame: where one pair leaves the frame another carries on, without a jump. Off: the first pair alone. "add track pair" turns it on. | |
| extrapolate | off | Before a track's first key and after its last, its position goes on as it was moving instead of stopping (as the curve editor's before/after setting, worked out live; the keys stay as they are). For tracks that leave the frame or start late. | |
| extrapolate as | linear | linear, extrapolate, exponential | Linear: at the speed of the end key. Extrapolate: with the speed and acceleration of the last keys. Exponential: the speed changing by the same ratio each frame (the curve editor's end settings). |
| track 1 enable | on | Uses the pivot track: off, the node moves nothing. | |
| track 1 name | pivot | The track's name (pivot or transform unless renamed). | |
| track 1 x | 960 | 0 to 2000 | The pivot's position in pixels, animated by tracking: its motion gives the move. |
| track 1 y | 540 | 0 to 2000 | The pivot's position in pixels, animated by tracking: its motion gives the move. |
| track 1 T | on | Drives the translation. | |
| track 1 R | off | Drives the rotation. | |
| track 1 S | off | Drives the scale. | |
| track 1 offset x | 0 | -100 to 100 | Moves the track's point away from the pattern's centre. |
| track 1 offset y | 0 | -100 to 100 | Moves the track's point up or down from the pattern's centre, in pixels. |
| track 1 error | 0 | 0 to 1 | How badly the pattern matched at each tracked frame (0: perfectly). Set by tracking. |
| track 1 pattern left | -15 | -60 to 0 | The pattern box's left edge, from the pattern's centre (the box is what is followed). |
| track 1 pattern bottom | -15 | -60 to 0 | The pattern box's bottom edge, from the pattern's centre, in pixels. |
| track 1 pattern right | 15 | 0 to 60 | The pattern box's right edge, from the pattern's centre, in pixels. |
| track 1 pattern top | 15 | 0 to 60 | The pattern box's top edge, from the pattern's centre, in pixels. |
| track 1 search left | -40 | -150 to 0 | The search box's left edge, from the pattern's centre: how far the pattern may move from one frame to the next. |
| track 1 search bottom | -40 | -150 to 0 | The search box's bottom edge, from the pattern's centre, in pixels. |
| track 1 search right | 40 | 0 to 150 | The search box's right edge, from the pattern's centre, in pixels. |
| track 1 search top | 40 | 0 to 150 | The search box's top edge, from the pattern's centre, in pixels. |
| track 2 enable | on | Uses the transform track for rotation and scale (once it has been tracked). | |
| track 2 name | transform | The track's name (pivot or transform unless renamed). | |
| track 2 x | 1200 | 0 to 2000 | The transform track's position in pixels, animated by tracking: its turn and distance about the pivot give the rotation and scale. |
| track 2 y | 540 | 0 to 2000 | The transform track's position in pixels, animated by tracking: its turn and distance about the pivot give the rotation and scale. |
| track 2 T | on | Drives the translation. | |
| track 2 R | off | Drives the rotation. | |
| track 2 S | off | Drives the scale. | |
| track 2 offset x | 0 | -100 to 100 | Moves the track's point away from the pattern's centre. |
| track 2 offset y | 0 | -100 to 100 | Moves the track's point up or down from the pattern's centre, in pixels. |
| track 2 error | 0 | 0 to 1 | How badly the pattern matched at each tracked frame (0: perfectly). Set by tracking. |
| track 2 pattern left | -15 | -60 to 0 | The pattern box's left edge, from the pattern's centre (the box is what is followed). |
| track 2 pattern bottom | -15 | -60 to 0 | The pattern box's bottom edge, from the pattern's centre, in pixels. |
| track 2 pattern right | 15 | 0 to 60 | The pattern box's right edge, from the pattern's centre, in pixels. |
| track 2 pattern top | 15 | 0 to 60 | The pattern box's top edge, from the pattern's centre, in pixels. |
| track 2 search left | -40 | -150 to 0 | The search box's left edge, from the pattern's centre: how far the pattern may move from one frame to the next. |
| track 2 search bottom | -40 | -150 to 0 | The search box's bottom edge, from the pattern's centre, in pixels. |
| track 2 search right | 40 | 0 to 150 | The search box's right edge, from the pattern's centre, in pixels. |
| track 2 search top | 40 | 0 to 150 | The search box's top edge, from the pattern's centre, in pixels. |
| motion blur | 0 | 0 to 4 | Motion blur quality: 0 off; each 0.1 is one more sample (Nuke's knob). |
| shutter angle | 180 | 0 to 360 | Degrees, as a film camera's (180: open half a frame). Nuke's shutter x 360. |
| shutter offset | start | start, centred, end, custom | Where the shutter opens: at the frame (start), around it, before it, or at the custom offset. |
| custom offset | 0 | -1 to 1 | Where the shutter opens, in frames from the frame (shutter offset custom). |
Tile
Rows x columns smaller copies of the image in its format, optionally mirrored every other one.
Inputs: input.
| Setting | Default | Range or choices | What it does |
|---|---|---|---|
| rows | 1 | 1 to 16 | How many copies of the image are stacked vertically. |
| mirror rows | off | Flip every other row of copies upside down. | |
| columns | 1 | 1 to 16 | How many copies of the image sit side by side. |
| mirror columns | off | Flip every other column of copies left to right. | |
| filter | cubic | impulse, cubic, Keys, Simon, Rifman, Mitchell, Parzen, notch, Lanczos4, Lanczos6, sinc4 | Kept for Nuke scripts: copies are box-averaged. |
Tracker
Follows points through the shot (tracks). Their positions can be linked to other nodes' settings (a Roto's master offset...); Stabilize and Match Move use them.
Inputs: src, mask (optional, a mask).
| Setting | Default | Range or choices | What it does |
|---|---|---|---|
| reference frame | 1 | 1 to 100 | The frame at which the output equals the input. |
| over plate | off | Match-move with an image on the "image" input: put the moved image over the plate (premultiplied). Off: the moved image alone (as a Transform on it, Nuke's way). | |
| merge tracks | off | Shows one motion made of all the tracks (translate, rotate, scale, center), chained frame by frame: where one track leaves the frame the others carry on. Ctrl+drag a value onto another setting. | |
| extrapolate | off | Before a track's first key and after its last, its position goes on as it was moving instead of stopping (as the curve editor's before/after setting, worked out live; the keys stay as they are). For tracks that leave the frame or start late. | |
| extrapolate as | linear | linear, extrapolate, exponential | Linear: at the speed of the end key. Extrapolate: with the speed and acceleration of the last keys. Exponential: the speed changing by the same ratio each frame (the curve editor's end settings). |
Transform
Translates, rotates, scales and skews the image (Nuke's order: skew, scale and rotate about the centre, then translate). Motion blur (as Nuke's) averages the transform over the shutter when it is animated.
Inputs: input.
| Setting | Default | Range or choices | What it does |
|---|---|---|---|
| translate x | 0 | -500 to 500 | Moves the picture across, in pixels. |
| translate y | 0 | -500 to 500 | Moves the picture up, in pixels. |
| rotate | 0 | -180 to 180 | Degrees, counter-clockwise. |
| scale | 1 | 0.1 to 10 | Scales the image about the centre, both ways (times scale x and scale y). |
| scale x | 1 | 0.1 to 10 | Times scale, horizontally. |
| scale y | 1 | 0.1 to 10 | Times scale, vertically. |
| skew x | 0 | -1 to 1 | Slants the image horizontally: x moves by this times the height above the centre. |
| skew y | 0 | -1 to 1 | Slants the image vertically: y moves by this times the distance right of the centre. |
| skew order | XY | XY, YX | XY applies the y skew first, then the x one (as Nuke does); YX the other way round. |
| center x | 0 | -500 to 500 | Pivot, as an offset from the centre of the format (0, 0: the image centre). |
| center y | 0 | -500 to 500 | The pivot's height, as an offset from the centre of the format, in pixels. |
| invert | off | Apply the inverse transform. | |
| filter | cubic | impulse, bilinear, cubic, Keys, Simon, Rifman, Mitchell, Parzen, notch, Lanczos4, Lanczos6, sinc4 | Nuke's filters. impulse: nearest pixel; cubic: smooth, no overshoot; Keys, Simon, Rifman: sharper, in that order; Mitchell: between; Parzen: softest; notch: flat, against moire; Lanczos4, Lanczos6: sharpest, with ringing; sinc4: sharper still. |
| clamp | off | Keep filtered values within their neighbours (no overshoot). | |
| black outside | on | Outside the input is black, with soft edges. Off: edge pixels are extended. | |
| motion blur | 0 | 0 to 4 | Motion blur quality: 0 off; each 0.1 is one more sample (Nuke's knob). |
| shutter angle | 180 | 0 to 360 | Degrees, as a film camera's (180: open half a frame). Nuke's shutter x 360. |
| shutter offset | start | start, centred, end, custom | Where the shutter opens: at the frame (start), around it, before it, or at the custom offset. |
| custom offset | 0 | -1 to 1 | Where the shutter opens, in frames from the frame (shutter offset custom). |
TransformMasked
A Transform of some channels, limited by a mask.
Inputs: input, mask (optional).
| Setting | Default | Range or choices | What it does |
|---|---|---|---|
| channels | all | rgb, rgba, alpha, all | rgb, rgba, alpha, all, or a layer (depth) or channel by name, as Nuke's. |
| translate x | 0 | -500 to 500 | Moves the picture across, in pixels. |
| translate y | 0 | -500 to 500 | Moves the picture up, in pixels. |
| rotate | 0 | -180 to 180 | Degrees, counter-clockwise. |
| scale | 1 | 0.1 to 10 | Scales the image about the centre, both ways (times scale x and scale y). |
| scale x | 1 | 0.1 to 10 | Times scale, horizontally. |
| scale y | 1 | 0.1 to 10 | Times scale, vertically. |
| skew x | 0 | -1 to 1 | Slants the image horizontally: x moves by this times the height above the centre. |
| skew y | 0 | -1 to 1 | Slants the image vertically: y moves by this times the distance right of the centre. |
| skew order | XY | XY, YX | XY applies the y skew first, then the x one (as Nuke does); YX the other way round. |
| center x | 0 | -500 to 500 | Pivot, as an offset from the centre of the format (0, 0: the image centre). |
| center y | 0 | -500 to 500 | The pivot's height, as an offset from the centre of the format, in pixels. |
| invert | off | Apply the inverse transform. | |
| filter | cubic | impulse, bilinear, cubic, Keys, Simon, Rifman, Mitchell, Parzen, notch, Lanczos4, Lanczos6, sinc4 | Nuke's filters. impulse: nearest pixel; cubic: smooth, no overshoot; Keys, Simon, Rifman: sharper, in that order; Mitchell: between; Parzen: softest; notch: flat, against moire; Lanczos4, Lanczos6: sharpest, with ringing; sinc4: sharper still. |
| clamp | off | Keep filtered values within their neighbours (no overshoot). | |
| black outside | on | Outside the input is black, with soft edges. Off: edge pixels are extended. | |
| motion blur | 0 | 0 to 4 | Motion blur quality: 0 off; each 0.1 is one more sample (Nuke's knob). |
| shutter angle | 180 | 0 to 360 | Degrees, as a film camera's (180: open half a frame). Nuke's shutter x 360. |
| shutter offset | start | start, centred, end, custom | Where the shutter opens: at the frame (start), around it, before it, or at the custom offset. |
| custom offset | 0 | -1 to 1 | Where the shutter opens, in frames from the frame (shutter offset custom). |
| invert mask | off | Use 1 - the mask's alpha. | |
| mix | 1 | 0 to 1 | How much of the result shows over the input: 0 is the input, 1 the full effect. |
Twist
Turns the picture about a centre, most at the centre, nothing at the edge of scale.
Inputs: input.
| Setting | Default | Range or choices | What it does |
|---|---|---|---|
| twist | 0 | -720 to 720 | The turn at the centre, in degrees; it falls off to nothing at the edge of the scale. |
| rotation center | 0 | 0 to 2000 | The centre of the turn, x in pixels. |
| rotation center | 0 | 0 to 2000 | The centre of the turn, y in pixels. |
| scale | 1 | 0 to 2 | The radius of the turn, times half the format's diagonal; nothing turns beyond it. |
| mesh density | 0 | 0 to 100 | Kept for Nuke scripts, not used. |
| antialiasing | none | none, low, medium, high | Kept for Nuke scripts, not used. |
| samples | 1 | 1 to 10 | Kept for Nuke scripts, not used. |
| Shutter | 0.5 | 0 to 1 | Kept for Nuke scripts, not used. |
| Shutter Offset | start | centred, start, end, custom | Kept for Nuke scripts, not used. |
| shuttercustomoffset | 0 | -1 to 1 | Kept for Nuke scripts, not used. |
| randomize time | 0 | 0 to 1 | Kept for Nuke scripts, not used. |
| sample diameter | 1 | 0 to 1 | Kept for Nuke scripts, not used. |
| filter | cubic | impulse, cubic, Keys, Simon, Rifman, Mitchell, Parzen, notch, Lanczos4, Lanczos6, sinc4 | Nuke's (kept; ours is bilinear). |
UVTile
A uv image's values moved into one tile (UDIM or u/v), scaled, translated, wrapped.
Inputs: input.
| Setting | Default | Range or choices | What it does |
|---|---|---|---|
| udim | 1001 | 1001 to 1100 | The UDIM tile moved to 0..1 when enabled (1001 is u 0, v 0; ten tiles a row). |
| enable | off | Pick the tile by its UDIM number instead of u and v. | |
| u | 0 | 0 to 10 | The tile's u: subtracted from the red (u) values. |
| v | 0 | 0 to 10 | The tile's v: subtracted from the green (v) values. |
| wrap u | clamp | clamp, repeat, mirror | What u values outside 0..1 become: clamped, repeated or mirrored. |
| wrap v | clamp | clamp, repeat, mirror | What v values outside 0..1 become: clamped, repeated or mirrored. |
| translate_x | 0 | -1 to 1 | Moves the picture across, in pixels. |
| translate_y | 0 | -1 to 1 | Moves the picture up, in pixels. |
| scale | 1 | 0 to 4 | Multiplies the u and v values once moved into the tile, before the translate. |
Upscale
Type name: UpRez (scripts, MCP and Nuke import use it).
Scales the picture up around the origin, the format kept.
Inputs: input.
| Setting | Default | Range or choices | What it does |
|---|---|---|---|
| scale | 1 | 1 to 4 | The scale factor, around the origin (bottom-left). |
| dY | 0 | -1 to 1 | Shifts where the input is read vertically, in input pixels. |
| impulse | off | Nearest pixel instead of bilinear. |