Card3D node
This documentation is for version 1.0 of Card3D (net.sf.openfx.Card3D).
Description
Card3D.
This effect applies a transform that corresponds to projection the source image onto a 3D card in space. The 3D card is positioned with relative to the Axis position, and the Camera position may also be given. The Axis may be used to apply the same global motion to several cards.
This plugin concatenates transforms.
See also https://web.archive.org/web/20210727235824/opticalenquiry.com/nuke/index.php?title=Card3D
Inputs
Input 
Description 
Optional 

Source 
No 
Controls
Parameter / script name 
Type 
Default 
Function 

Import Format / 
Choice 
chan 
The format of the file to import.
chan: Chan format, each line is FRAME TX TY TZ RX RY RZ VFOV. Can be created using Natron, Nuke, 3DEqualizer, Maya and other 3D tracking software. Be careful that the rotation order must be exactly the same when exporting and importing the chan file.
Boujou (boujou): Boujou text export. In Boujou, after finishing the track and solving, go to Export > Export Camera Solve (Or press F12) > choose where to save the data and give it a name, click he drop down Export Type and make sure it will save as a .txt, then click Save. Each camera line is R(0,0) R(0,1) R(0,2) R(1,0) R(1,1) R(1,2) R(2,0) R(2,1) R(2,2) Tx Ty Tz F(mm).

Import / 
N/A 
Import a chan file created using 3D tracking software, or a txt file created using Boujou. 

Export / 
N/A 
Export a .chan file which can be used in Natron, Nuke or 3D tracking software, such as 3DEqualizer, Maya, or Boujou. Be careful that the rotation order must be exactly the same when exporting and importing the chan file. 

Transform Order / 
Choice 
SRT 
Order in which scale (S), rotation (R) and translation (T) are applied.
SRT (srt): Scale, Rotation, Translation.
STR (str): Scale, Translation, Rotation.
RST (rst): Rotation, Scale, Translation.
RTS (rts): Rotation, Translation, Scale.
TSR (tsr): Translation, Scale, Rotation.
TRS (trs): Translation, Rotation, Scale.

Rotation Order / 
Choice 
ZXY 
Order in which Euler angles are applied in the rotation.
XYZ (xyz): Rotation over X axis, then Y and Z.
XZY (xzy): Rotation over X axis, then Z and Y.
YXZ (yxz): Rotation over Y axis, then X and Z.
YZX (yzx): Rotation over Y axis, then Z and X.
ZXY (zxy): Rotation over Z axis, then X and Y.
ZYX (zyx): Rotation over Z axis, then Y and X.

Translate / 
Double 
x: 0 y: 0 z: 0 
Translation component. 
Rotate / 
Double 
x: 0 y: 0 z: 0 
Euler angles (in degrees). 
Scale / 
Double 
x: 1 y: 1 z: 1 
Scale factor over each axis. 
Uniform Scale / 
Double 
1 
Scale factor over all axis. It is multiplied by the scale factor over each axis. 
Skew / 
Double 
x: 0 y: 0 z: 0 
Skew over each axis, in degrees. 
Pivot / 
Double 
x: 0 y: 0 z: 0 
The position of the origin for position, scaling, skewing, and rotation. 
Specify Matrix / 
Boolean 
Off 
Check to specify manually all the values for the position matrix. 
/ 
Double 
1 
Matrix coefficient. 
/ 
Double 
0 
Matrix coefficient. 
/ 
Double 
0 
Matrix coefficient. 
/ 
Double 
0 
Matrix coefficient. 
/ 
Double 
0 
Matrix coefficient. 
/ 
Double 
1 
Matrix coefficient. 
/ 
Double 
0 
Matrix coefficient. 
/ 
Double 
0 
Matrix coefficient. 
/ 
Double 
0 
Matrix coefficient. 
/ 
Double 
0 
Matrix coefficient. 
/ 
Double 
1 
Matrix coefficient. 
/ 
Double 
1 
Matrix coefficient. 
/ 
Double 
0 
Matrix coefficient. 
/ 
Double 
0 
Matrix coefficient. 
/ 
Double 
0 
Matrix coefficient. 
/ 
Double 
1 
Matrix coefficient. 
Enable Camera / 
Boolean 
Off 
Enable the camera projection parameters. 
Cam Import Format / 
Choice 
chan 
The format of the file to import.
chan: Chan format, each line is FRAME TX TY TZ RX RY RZ VFOV. Can be created using Natron, Nuke, 3DEqualizer, Maya and other 3D tracking software. Be careful that the rotation order must be exactly the same when exporting and importing the chan file.
Boujou (boujou): Boujou text export. In Boujou, after finishing the track and solving, go to Export > Export Camera Solve (Or press F12) > choose where to save the data and give it a name, click he drop down Export Type and make sure it will save as a .txt, then click Save. Each camera line is R(0,0) R(0,1) R(0,2) R(1,0) R(1,1) R(1,2) R(2,0) R(2,1) R(2,2) Tx Ty Tz F(mm).

Cam Import / 
N/A 
Import a chan file created using 3D tracking software, or a txt file created using Boujou. 

Cam Export / 
N/A 
Export a .chan file which can be used in Natron, Nuke or 3D tracking software, such as 3DEqualizer, Maya, or Boujou. Be careful that the rotation order must be exactly the same when exporting and importing the chan file. 

Cam Transform Order / 
Choice 
SRT 
Order in which scale (S), rotation (R) and translation (T) are applied.
SRT (srt): Scale, Rotation, Translation.
STR (str): Scale, Translation, Rotation.
RST (rst): Rotation, Scale, Translation.
RTS (rts): Rotation, Translation, Scale.
TSR (tsr): Translation, Scale, Rotation.
TRS (trs): Translation, Rotation, Scale.

Cam Rotation Order / 
Choice 
ZXY 
Order in which Euler angles are applied in the rotation.
XYZ (xyz): Rotation over X axis, then Y and Z.
XZY (xzy): Rotation over X axis, then Z and Y.
YXZ (yxz): Rotation over Y axis, then X and Z.
YZX (yzx): Rotation over Y axis, then Z and X.
ZXY (zxy): Rotation over Z axis, then X and Y.
ZYX (zyx): Rotation over Z axis, then Y and X.

Cam Translate / 
Double 
x: 0 y: 0 z: 0 
Translation component. 
Cam Rotate / 
Double 
x: 0 y: 0 z: 0 
Euler angles (in degrees). 
Cam Scale / 
Double 
x: 1 y: 1 z: 1 
Scale factor over each axis. 
Cam Uniform Scale / 
Double 
1 
Scale factor over all axis. It is multiplied by the scale factor over each axis. 
Cam Skew / 
Double 
x: 0 y: 0 z: 0 
Skew over each axis, in degrees. 
Cam Pivot / 
Double 
x: 0 y: 0 z: 0 
The position of the origin for position, scaling, skewing, and rotation. 
Cam Specify Matrix / 
Boolean 
Off 
Check to specify manually all the values for the position matrix. 
Cam / 
Double 
1 
Matrix coefficient. 
Cam / 
Double 
0 
Matrix coefficient. 
Cam / 
Double 
0 
Matrix coefficient. 
Cam / 
Double 
0 
Matrix coefficient. 
Cam / 
Double 
0 
Matrix coefficient. 
Cam / 
Double 
1 
Matrix coefficient. 
Cam / 
Double 
0 
Matrix coefficient. 
Cam / 
Double 
0 
Matrix coefficient. 
Cam / 
Double 
0 
Matrix coefficient. 
Cam / 
Double 
0 
Matrix coefficient. 
Cam / 
Double 
1 
Matrix coefficient. 
Cam / 
Double 
1 
Matrix coefficient. 
Cam / 
Double 
0 
Matrix coefficient. 
Cam / 
Double 
0 
Matrix coefficient. 
Cam / 
Double 
0 
Matrix coefficient. 
Cam / 
Double 
1 
Matrix coefficient. 
Projection / 
Choice 
Perspective 
Perspective (perspective): Perspective projection.
Orthographic (orthographic): Orthographic projection

Focal Length / 
Double 
50 
The camera focal length, in arbitrary units (usually either millimeters or 35 mm equivalent focal length). haperture and vaperture must be expressed in the same units. 
Horiz. Aperture / 
Double 
24.576 
The camera horizontal aperture (or film back width), in the same units as the focal length. In the case of scanned film, this can be obtained as image_width * scanner_pitch. 
Vert. Aperture / 
Double 
18.672 
The camera vertical aperture (or film back height), in the same units as the focal length. This does not affect the projection (which is computed from haperture and the image aspect ratio), but it is used to compute the focal length from vertical FOV when importing chan files, using the formula: focal = 0.5 * vaperture / tan(vfov/2). It is thus best set as: haperture = vaperture * image_width/image_height. In the case of scanned film, this can be obtained as image_height * scanner_pitch. 
Window Translate / 
Double 
x: 0 y: 0 
The camera window (or film back) is translated by this fraction of the horizontal aperture, without changing the position of the camera center. This can be used to model tiltshift or perspectivecontrol lens. 
Window Scale / 
Double 
x: 1 y: 1 
Scale the camera window (or film back). 
Window Roll / 
Double 
0 
Rotation (in degrees) of the camera window (or film back) around the z axis. 
Import Format / 
Choice 
chan 
The format of the file to import.
chan: Chan format, each line is FRAME TX TY TZ RX RY RZ VFOV. Can be created using Natron, Nuke, 3DEqualizer, Maya and other 3D tracking software. Be careful that the rotation order must be exactly the same when exporting and importing the chan file.
Boujou (boujou): Boujou text export. In Boujou, after finishing the track and solving, go to Export > Export Camera Solve (Or press F12) > choose where to save the data and give it a name, click he drop down Export Type and make sure it will save as a .txt, then click Save. Each camera line is R(0,0) R(0,1) R(0,2) R(1,0) R(1,1) R(1,2) R(2,0) R(2,1) R(2,2) Tx Ty Tz F(mm).

Import / 
N/A 
Import a chan file created using 3D tracking software, or a txt file created using Boujou. 

Export / 
N/A 
Export a .chan file which can be used in Natron, Nuke or 3D tracking software, such as 3DEqualizer, Maya, or Boujou. Be careful that the rotation order must be exactly the same when exporting and importing the chan file. 

Transform Order / 
Choice 
SRT 
Order in which scale (S), rotation (R) and translation (T) are applied.
SRT (srt): Scale, Rotation, Translation.
STR (str): Scale, Translation, Rotation.
RST (rst): Rotation, Scale, Translation.
RTS (rts): Rotation, Translation, Scale.
TSR (tsr): Translation, Scale, Rotation.
TRS (trs): Translation, Rotation, Scale.

Rotation Order / 
Choice 
ZXY 
Order in which Euler angles are applied in the rotation.
XYZ (xyz): Rotation over X axis, then Y and Z.
XZY (xzy): Rotation over X axis, then Z and Y.
YXZ (yxz): Rotation over Y axis, then X and Z.
YZX (yzx): Rotation over Y axis, then Z and X.
ZXY (zxy): Rotation over Z axis, then X and Y.
ZYX (zyx): Rotation over Z axis, then Y and X.

Translate / 
Double 
x: 0 y: 0 z: 1 
Translation component. 
Rotate / 
Double 
x: 0 y: 0 z: 0 
Euler angles (in degrees). 
Scale / 
Double 
x: 1 y: 1 z: 1 
Scale factor over each axis. 
Uniform Scale / 
Double 
1 
Scale factor over all axis. It is multiplied by the scale factor over each axis. 
Skew / 
Double 
x: 0 y: 0 z: 0 
Skew over each axis, in degrees. 
Pivot / 
Double 
x: 0 y: 0 z: 0 
The position of the origin for position, scaling, skewing, and rotation. 
Specify Matrix / 
Boolean 
Off 
Check to specify manually all the values for the position matrix. 
/ 
Double 
1 
Matrix coefficient. 
/ 
Double 
0 
Matrix coefficient. 
/ 
Double 
0 
Matrix coefficient. 
/ 
Double 
0 
Matrix coefficient. 
/ 
Double 
0 
Matrix coefficient. 
/ 
Double 
1 
Matrix coefficient. 
/ 
Double 
0 
Matrix coefficient. 
/ 
Double 
0 
Matrix coefficient. 
/ 
Double 
0 
Matrix coefficient. 
/ 
Double 
0 
Matrix coefficient. 
/ 
Double 
1 
Matrix coefficient. 
/ 
Double 
1 
Matrix coefficient. 
/ 
Double 
0 
Matrix coefficient. 
/ 
Double 
0 
Matrix coefficient. 
/ 
Double 
0 
Matrix coefficient. 
/ 
Double 
1 
Matrix coefficient. 
LensIn Focal / 
Double 
1 
The focal length of the camera that took the picture on the card. The card is scaled so that at distance 1 (which is the default card Z) it occupies the field of view corresponding to lensInFocal and lensInHAperture. 
LensIn H.Aperture / 
Double 
1 
The horizontal aperture (or sensor/film back width) of the camera that took the picture on the card. The card is scaled so that at distance 1 (which is the default card Z) it occupies the field of view corresponding to lensInFocal and lensInHAperture. 
Output Format / 
Choice 
Project 
Desired format for the output sequence.
Format (format): Use a predefined image format.
Size (size): Use a specific extent (size and offset).
Project (project): Use the project extent (size and offset).

Center / 
Button 
Centers the region of definition to the input region of definition. If there is no input, then the region of definition is centered to the project window. 

Format / 
Choice 
HD 1920x1080 
The output format
PC_Video 640x480 (PC_Video)
NTSC 720x486 0.91 (NTSC)
PAL 720x576 1.09 (PAL)
NTSC_16:9 720x486 1.21 (NTSC_16:9)
PAL_16:9 720x576 1.46 (PAL_16:9)
HD_720 1280x720 (HD_720)
HD 1920x1080 (HD)
UHD_4K 3840x2160 (UHD_4K)
1K_Super_35(fullap) 1024x778 (1K_Super_35(fullap))
1K_Cinemascope 914x778 2.00 (1K_Cinemascope)
2K_Super_35(fullap) 2048x1556 (2K_Super_35(fullap))
2K_Cinemascope 1828x1556 2.00 (2K_Cinemascope)
2K_DCP 2048x1080 (2K_DCP)
4K_Super_35(fullap) 4096x3112 (4K_Super_35(fullap))
4K_Cinemascope 3656x3112 2.00 (4K_Cinemascope)
4K_DCP 4096x2160 (4K_DCP)
square_256 256x256 (square_256)
square_512 512x512 (square_512)
square_1K 1024x1024 (square_1K)
square_2K 2048x2048 (square_2K)

Bottom Left / 
Double 
x: 0 y: 0 
Coordinates of the bottom left corner of the size rectangle. 
Size / 
Double 
w: 1 h: 1 
Width and height of the size rectangle. 
Invert / 
Boolean 
Off 
Invert the transform. 
Filter / 
Choice 
Cubic 
Filtering algorithm  some filters may produce values outside of the initial range (*) or modify the values even if there is no movement (+).
Impulse (impulse): (nearest neighbor / box) Use original values.
Box (box): Integrate the source image over the bounding box of the backtransformed pixel.
Bilinear (bilinear): (tent / triangle) Bilinear interpolation between original values.
Cubic (cubic): (cubic spline) Some smoothing.
Keys (keys): (CatmullRom / Hermite spline) Some smoothing, plus minor sharpening (*).
Simon (simon): Some smoothing, plus medium sharpening (*).
Rifman (rifman): Some smoothing, plus significant sharpening (*).
Mitchell (mitchell): Some smoothing, plus blurring to hide pixelation (*)(+).
Parzen (parzen): (cubic Bspline) Greatest smoothing of all filters (+).
Notch (notch): Flat smoothing (which tends to hide moire’ patterns) (+).

Clamp / 
Boolean 
Off 
Clamp filter output within the original range  useful to avoid negative values in mattes 
Black outside / 
Boolean 
On 
Fill the area outside the source image with black 
Motion Blur / 
Double 
0 
Quality of motion blur rendering. 0 disables motion blur, 1 is a good value. Increasing this slows down rendering. 
Directional Blur Mode / 
Boolean 
Off 
Motion blur is computed from the original image to the transformed image, each parameter being interpolated linearly. The motionBlur parameter must be set to a nonzero value, and the blackOutside parameter may have an important effect on the result. 
Shutter / 
Double 
0.5 
Controls how long (in frames) the shutter should remain open. 
Shutter Offset / 
Choice 
Start 
Controls when the shutter should be open/closed. Ignored if there is no motion blur (i.e. shutter=0 or motionBlur=0).
Centered (centered): Centers the shutter around the frame (from tshutter/2 to t+shutter/2)
Start (start): Open the shutter at the frame (from t to t+shutter)
End (end): Close the shutter at the frame (from tshutter to t)
Custom (custom): Open the shutter at t+shuttercustomoffset (from t+shuttercustomoffset to t+shuttercustomoffset+shutter)

Custom Offset / 
Double 
0 
When custom is selected, the shutter is open at current time plus this offset (in frames). Ignored if there is no motion blur (i.e. shutter=0 or motionBlur=0). 
Interactive Update / 
Boolean 
Off 
If checked, update the parameter values during interaction with the image viewer, else update the values when pen is released. 