Search TipsCameraImagePlaneCreate
Note: Although CameraImagePlaneCreate nodes are available in Katana versions 4.5v1 and above, the ability to set up Image Planes is no longer supported due to the OpenSceneGraph-based Viewer being replaced with the Hydra Viewer.
Creates attributes on a camera that describe an image plane. In the Viewer, the camera displays the image plane.
|
Connection Type |
Connection Name |
Function |
|
Input |
input |
The place in the node graph where you want to create attributes on a camera for an image plane. |
|
Control (UI) |
Default Value |
Function |
|
cameraLocation |
N/A |
This is the scene graph location where the target camera resides. For example, the default value of /root/world/cam/camera references a camera at the location /root/world/cam/camera. For more information, refer to the Scene Graph Location Widget Type in the Common Parameter Widgets. |
|
name |
plane |
Sets the name of the image plane created. |
|
imagePath |
N/A |
Sets the filepath of the image or sequence to display in the image plane. Supported file formats include .cin, .dpx, .rla, .iff, .tif, .jpg, .tga, .rgb, and .tga. Floating point data (.exr, .tif, .zfile) is not currently supported. Note: Image sequences must contain a padded frame number. For more information, refer to the Asset and File Path Widget Types in the Common Parameter Widgets. |
|
frame |
1 |
Sets the frame of the image sequence to use. |
|
depth |
10000 |
Sets the distance from the camera to image plane. |
|
alpha |
1 |
Sets the image plane's alpha value. |
|
displayOnlyIfCurrent |
No |
When set to Yes, this image plane is only displayed when looking through the camera it is attached to. When set to No, you can see the image plane in all views. |
|
displayMode |
RGBA |
Sets the image plane display mode: • None • Outline • RGB • RGBA |
|
fit |
Best |
Controls how the image file fits into the image plane if there is a mismatch between aspect ratios: • Fill - the image is scaled as required to fill the plane, without being squashed or stretched. Any excess is cropped. • Best - the image is scaled as required to display it entirely within the plane, without being squashed, stretched or cropped. • Horizontal - the image is scaled as required so that its aspect ratio is maintained within the horizontal bounds of the plane. Any excess at the top or bottom is cropped. • Vertical - the image is scaled as required so that its aspect ratio is maintained within the vertical bounds of the plane. Any excess at the left or right is cropped. • To Size - the image is stretched or squashed to fit with the plane both horizontally and vertically. Note: To control the image's SRT values directly, enable the manualPlacementSettings checkbox. |
|
crop |
||
|
left |
0 |
Sets the amount of manual crop to apply to the edges of the image plane. |
|
bottom |
0 |
|
|
right |
1 |
|
|
top |
1 |
|
|
CameraImagePlaneCreate parameters continued |
||
|
manualPlacementSettings |
No |
When set to Yes, you can adjust the image manually using its SRT values. Otherwise, the image plane placement is synced to the camera. |
|
manualPlacementSettings: Yes > size Size controls the width and height of the image plane. |
||
|
x |
1 |
Adjusts the size of the image plane along the x axis. |
|
y |
1 |
Adjusts the size of the image plane along the y axis. |
|
manualPlacementSettings: Yes > offset Offset controls how much the center of the image plane is offset from the center of the viewing frustum of the camera. |
||
|
x |
0 |
Adjusts the offset of the image plane along the x axis. |
|
y |
0 |
Adjusts the offset of the image plane along the y axis. |
|
manualPlacementSettings: Yes |
||
|
rotate |
0 |
Adjusts the rotation of the image plane around the view vector. |
