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	off	Draw the bounding box of the field if it has one.
Draw Preview	preview_on	off	Draw a rough preview of the field.
Preview Opacity	preview_opacity	0.5	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.