FieldImage

The FieldImage node creates a 3D field from a 2D image. The image is projected through 3D space with the field values being the pixel values of the image. If a camera is connected, the image is connected through the camera, filling the frustum. If no camera is connected, the image is fit to a unit square on the XY plane and projected along the Z axis. If no image is connected, field values will be 1 inside the image and 0 outside. One use for this is to make a mask which is the shape of a camera frustum.

Inputs and Controls

Connection Type

Connection Name

Function
Input

cam

An input for connecting a camera.
  img An input for connecting an image file.

Control (UI)

Knob (Scripting)

Default Value

Function

FieldImage Tab

channels

channels

rgb

Specifies the channels for your field image.
Display Tab
Draw Bounding Box preview_bounds Unchanged

Draw the bounding box of the field if it has one.

Select between On, Off, and Unchanged. Unchanged means that this option is inherited from nodes above it in the node graph. By inheriting On or Off from above, this means this setting only needs to be edited in one node to affect the display across all Field nodes in the node graph.
Draw Preview preview_on Unchanged

Draw a rough preview of the field.

Select between On, Off, and Unchanged. Unchanged means that this option is inherited from nodes above it in the node graph. By inheriting On or Off from above, this means this setting only needs to be edited in one node to affect the display across all Field nodes in the node graph.
Opacity preview_opacity 1 The opacity at which to draw the preview.
Scale preview_scale 1 A value by which the field is multiplied before drawing. You may need to increase this to display faint volumes for example.
Offset preview_offset 0 A value added to the field before drawing (after scaling).
Detail preview_detail 1 The detail level at which the preview is drawn. Large values are more accurate but slower to draw.