FieldSurface

The FieldSurface node produces various types of field from geometry. The geometry can be a point cloud, basis curve, mesh, or Gaussian splat.

Note:  This is a LABS node, indicated in Nuke with the tag:
LABS nodes are experimental and not intended to be used for production.

Inputs and Controls

Connection Type

Connection Name

Function

Input

geo

An input for connecting to geometry.

Control (UI)

Knob (Scripting)

Default Value

Function

FieldSurface Tab

Field Type field_type Nearest Point

Select a field type to produce.

Nearest Point: The field contains the nearest point on the geometry.

Vector: The vector from the nearest point to the sample point.

Normal: The normal (as for Vector, but normalized).

Distance: The distance to the nearest point Signed Distance: The signed distance to the nearest point.

Inside: 1 if the point is inside the geometry, 0 otherwise (meshes only).

Mesh Path

path_mask

Last modified

Specifies the mask pattern, for targeting the prim(s) to use.

You can use standard glob-style wildcards, such as '*', '?', to create masks or use individual prim names separated by spaces. For example, /GeoCube 1 /GeoCard3 applies the effect to only those prims.

Default - Injected/All Roots - selects the default prim(s) for the node. The default will be the injected mask prim paths if there is an upstream node with this. Otherwise the default mask for this node type is evaluated.

All roots - select the top level Xform(s) in your scene.

Last modified - selects whatever the last node modified was.

All Cameras - selects all Cameras in your scene graph.

All Lights - select all lights in your scene graph.

All Meshes - selects all meshes in your scene graph.

Custom - sets a custom selection of prims that exist in your scene graph.

Tip:  You can also use the cog menu, the Viewer picker, or drag and drop paths from the Scene Graph to create masks.

Curve Segments curve_segements 10 For cubic curves only, the number of straight line segments to subdivide each curve segment into. Smaller values are faster, larger are more accurate.
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.