C_CameraIngest

C_CameraIngest streamlines import workflows when using manually solved or pre-tracked footage from third-party applications. Connect your cameras and your footage to the node to setup a rig that can be used directly for stitching, or as the basis for further refinement with the C_CameraSolver.

Inputs and Controls

Connection Type

Connection Name

Function

Input

Cameras

The pre-tracked or manually solved cameras associated with the images you want to ingest.

Images

The sequences to ingest.

Control (UI)

Knob (Scripting)

Default Value

Function

C_CameraIngest Tab

Local GPU

gpuName

N/A

Displays the GPU used for rendering when Use GPU if available is enabled. Local GPU displays Not available when:

Use CPU is selected as the GPU device in the Preferences.

no suitable GPU was found on your system.

it was not possible to create a context for processing on the selected GPU, such as when there is not enough free memory available on the GPU.

You can select a different GPU device, if available, by navigating to the Preferences and selecting an alternative from the GPU Device dropdown.

Note:  Selecting a different GPU requires you to restart Nuke before the change takes effect.

Use GPU if available

useGPUIfAvailable

enabled

When enabled, rendering occurs on the Local GPU specified, if available, rather than the CPU.

Note:  Enabling this option with no local GPU allows the script to run on the GPU whenever the script is opened on a machine that does have a GPU available.
You should also select this if you wish to render from the command line with the --gpu option.

See Windows, Mac OS X and macOS, or Linux for more information on the GPUs Nuke supports.

Camera Views

Create

create

N/A

Click to specify the number of views to create and then click OK.

If the number of Cameras specified is fewer than the views that already exist in the script, clicking OK removes the additional views.

Delete All

deleteAll

N/A

Click to delete all existing views in the script.

Output

Format

outputFormat

dependent on Compositing environment Project Settings

Sets the output resolution passed down the node tree.

Typically, you would set the format globally in the Project Settings, but this control overrides the global setting.

Converge

convergenceDepth

10

Sets the depth at which the cameras overlap, allowing you to bring particular areas in the scene into focus.

The approximate diameter of the sphere on which the cameras sit uses the Rig Size control on the Cameras tab. This normalizes the 3D representation of the rig into close to real world units, depending on the quality of the solve. The Converge control then defines the depth at which the preview stitch is converged, the "hero" depth of the scene.

Note:  Convergence doesn't affect nodal rigs because all the cameras share the same origin.

Rig Centre

positionType

Average

Sets the position of the center of the rig in the 3D Viewer when passed to a C_CameraSolver:

Origin - sets the rig center to the origin (0, 0, 0) of the scene.

Average - sets the rig center to the average of all camera positions.

Note:  You can also use the controls on the Transform tab to adjust the rig center with the C_CameraSolver selected in the Node Graph.

Cameras Tab

Rig Size

rigSize

0.3

Sets the diameter of the rig. This normalizes the 3D representation of the rig into close to real world units, depending on the quality of the solve.

The Converge control then defines the depth at which the preview stitch is converged, the "hero" depth of the scene.

The Rig Size and Converge controls use the same units so if you set the Rig Size in meters, the Converge control also uses meters.

Rig Centre

positionType

Average

Sets the position of the center of the rig in the 3D Viewer when passed to a C_CameraSolver:

Origin - sets the rig center to the origin (0, 0, 0) of the scene.

Average - sets the rig center to the average of all camera positions.

Note:  You can also use the controls on the C_CameraInest tab to adjust the rig center.

Focal Length

focalType

Default (pass-through)

Sets how the focal length of the cameras is handled:

Default (pass-through) - the input focal length is unchanged, which can be useful when dealing with extreme fisheye lenses that Nuke cannot replicate.

Convert - assume that the input cameras are rectilinear and convert the focal length from rectilinear.

Lens Type

lensType

Fisheye

Sets the type of lens the cameras in the rig employ, either Rectilinear or Fisheye.

Centre Shift

centreShift

0, 0

Sets the center point shift for the lens of the selected cameras in the Cameras table.

Distortion

distortion

0, 0, 0

Sets the distortion for the lens of the selected cameras in the Cameras table.

Mask

Shape

alphaShape

Rectangular

Sets the shape of the mask used to blend images from adjacent cameras:

Rectangular - overwrites the source alpha channel with a rectangular blend mask.

Elliptical - overwrites the source alpha channel with an elliptical blend mask.

Source - uses the source alpha as the blend mask.

Size

alphaSize

N/A

Sets the size of the blend mask on the x and y axis for Rectangular and Elliptical blend masks.

Note:  The Size control has no effect on Source alpha blend masks.

Feather

alphaFeather

N/A

Sets the feathering applied to the edges of the blend mask for Rectangular and Elliptical blend masks.

Note:  The Feather control has no effect on Source alpha blend masks.

Cameras

cameras

N/A

Displays camera information for views connected to C_CameraIngest's inputs.

As you alter the lens controls, the cameras in the table update with positional data.

You can toggle cameras on and off to determine which cameras from the rig are displayed in the stitch preview.

Transform Tab

transform order

xform_order

SRT

Sets the operation order for scale (S), rotation (R), and translation (T). The possible operation combinations are SRT, STR, RST, RTS, TSR, TRS.

rotation order

rot_order

ZXY

Sets the order of rotation. The possible axial combinations are ZXY, XYZ, XZY, YXZ, YZX, ZXY, ZYX.

translate xyz

translate

0, 0, 0

Lets you translate the rig along the x, y, and z axes. You can also adjust translate values by clicking and dragging the camera in the 3D Viewer.

rotate xyz

rotate

0, 0, 0

Lets you rotate the rig around the x, y, and z axes. You can adjust rotate values by holding down Ctrl/Cmd and dragging in the 3D Viewer.

uniform scale

uniform_scale

1

Lets you scale the rig simultaneously on the x, y, and z axes.

Local matrix

specify matrix

useMatrix

disabled

Enable this control to specify matrix values for the rig you’re transforming as an alternative to setting transform and scale values above.

matrix

matrix

N/A

The matrix displays values from the rig’s transform, rotate, and scale controls.

Check specify matrix and copy or drag-and-drop matrix values from another object to apply those values, such as when aligning objects in a scene.