CameraMatch
CameraMatch (fSpy-style): drag two lines per vanishing point over edges that are parallel in the scene (red X, green Y, blue Z), put the origin on the ground, optionally a reference distance.
CameraMatch (fSpy-style): drag two lines per vanishing point over edges that are parallel in the scene (red X, green Y, blue Z), put the origin on the ground, optionally a reference distance. The camera solves live from your lines. The solver was written for this app from the published maths (no fSpy code). Mode 1vp uses a known focal length and the horizon; use_vp3 adds a third point to find the principal point. Create Camera makes a Camera node (+ preview render). Wrong way round? Flip VP1 / VP2.
| Node | CameraMatch |
|---|---|
| Menu | Transform › CameraMatch |
| Names in each format | |
| .oink comp (JSON) | "type": "OC_N_cameramatch" |
| .nk script | none: written as an Oink node |
| Python | nuke.createNode("OC_N_cameramatch") |
| Assistant (MCP) | create_node(type="CameraMatch") |
| Tab search | cameramatch, or its initials cm |
Inputs and outputs
| Port | Name | Type |
|---|---|---|
| input 0 | Image | image |
| output 0 | Image | image |
Knobs
Panel tab Cameramatch, in panel order.
| Knob | Label | Type | Default | Range / values | .nk knob | Description |
|---|---|---|---|---|---|---|
reference_frame | frame | float | 1 | -100000 to 100000 (integer) | ||
mode | mode | menu | 2vp | 2vp (2 vanishing points), 1vp (1 vanishing point + focal) | ||
vp1_axis | VP1 axis | menu | xp | xp (+X), xn (-X), yp (+Y), yn (-Y), zp (+Z), zn (-Z) | ||
vp2_axis | VP2 axis | menu | zn | xp (+X), xn (-X), yp (+Y), yn (-Y), zp (+Z), zn (-Z) | ||
use_vp3 | VP3 lines (check / refine) | bool | false | |||
refine | refine with all lines | bool | true | |||
pp_mode | principal point | menu | center | center (image centre), manual, vp3 (from 3rd vanishing point) | ||
principal_point | principal point | vector ×2 | 960, 540 | -10000 to 10000 | ||
focal_length | focal length (1 VP, mm) | float | 35 | 1 to 500 | ||
film_back | film back | menu | nuke | nuke (Nuke default 24.576 x 18.672), ff (Full frame 36 x 24), s35 (Super 35 24.89 x 18.66), alexa_mini_og (Alexa Mini open gate), alexa_mini_16x9 (Alexa Mini 16:9), alexa_lf_og (Alexa LF open gate), alexa35_og (Alexa 35 open gate), red_m... | ||
haperture | horiz aperture | float | 24.576 | 0.1 to 100 | ||
vaperture | vert aperture | float | 18.672 | 0.1 to 100 | ||
origin | origin | vector ×2 | 850.8, 81 | -10000 to 10000 | ||
ref_enable | reference distance | bool | false | |||
ref_axis | along axis | menu | x | x (X), y (Y), z (Z) | ||
ref_plane | starts on plane | menu | XZ | XZ (XZ (ground)), XY, YZ | ||
ref_distance | distance | float | 2 | 0 to 1000 | ||
ref_units | units | menu | m | m, cm, mm, ft, in | ||
show_grid | grid | bool | true | |||
grid_plane | grid plane | menu | XZ | XZ (XZ (ground)), XY, YZ | ||
grid_spacing | grid spacing | float | 1 | 0.01 to 100 | ||
grid_lines | grid lines | float | 10 | 1 to 100 (integer) | ||
vp1_line1 | VP1 line 1 | vector ×4 | 978, 133.5, 1433.6, 321.6 | -10000 to 10000 | ||
vp1_line2 | VP1 line 2 | vector ×4 | 409.3, 392.5, 847, 499.8 | -10000 to 10000 | ||
vp2_line1 | VP2 line 1 | vector ×4 | 742, 136.5, 358, 332.3 | -10000 to 10000 | ||
vp2_line2 | VP2 line 2 | vector ×4 | 1401.7, 383.4, 995.4, 498.6 | -10000 to 10000 | ||
vp3_line1 | VP3 line 1 | vector ×4 | 289.9, 425.5, 265.6, 722.9 | -10000 to 10000 | ||
vp3_line2 | VP3 line 2 | vector ×4 | 1513.6, 414.7, 1534, 716.6 | -10000 to 10000 | ||
horizon | horizon (1 VP) | vector ×4 | 480, 648, 1440, 648 | -10000 to 10000 | ||
ref_line | reference line | vector ×4 | 294.9, 364.4, 924.4, 518.7 | -10000 to 10000 |
Other knobs (Python, .nk and the assistant; not on the panel)
| Knob | Label | Type | Default | Range / values | .nk knob | Description |
|---|---|---|---|---|---|---|
gl_color | Viewer Controls Color | float ×3 | 0, 0, 0 | 0 to 1 | ||
postage_stamp_frame | Static Frame | int | 1 | -2147483648 to 2147483647 | ||
lifetimeStart | Lifetime Start | int | 0 | -2147483648 to 2147483647 | ||
lifetimeEnd | Lifetime End | int | 100 | -2147483648 to 2147483647 | ||
useLifetime | Use Lifetime | boolean | false | |||
cached | Cached | boolean | false | |||
bookmark | Bookmark | boolean | false | |||
dope_sheet | Dope Sheet | boolean | false | |||
clone_group | Clone Group | string | ||||
link_source | Link Source | string | ||||
link_overrides | Link Overrides | string | ||||
split_views | Split Views | string | ||||
fitted | Handles fitted to plate | boolean | false |