Trilinear

The Trilinear node lets you warp your 3D geometry object as a whole by using trilinear interpolation from the object’s bounding box to the given destination box. For example, you can use this node to create animated object deformations, such as the squash of a bouncing ball.

Inputs and Controls

Connection Type

Connection Name

Function

Input

unnamed

The 3D geometry object you want to warp. If you want to warp several objects together, you can also connect a MergeGeo node here.

Control (UI)

Knob (Scripting)

Default Value

Function

Trilinear Tab

display

display

unchanged

Adjust the display characteristics of the 3D object. These settings don’t affect the render output of the scene; these are for display purposes only in the 3D Viewer.

off - hides the 3D geometry object.

wireframe - displays only the outlines of the object’s geometry.

solid - displays all geometry with a solid color.

solid +wireframe - displays the geometry as solid color with the object’s geometry outlines.

textured - displays only the surface texture.

textured +wireframe - displays the wireframe plus the surface texture.

unchanged - doesn't change the object's display mode. The Viewer can override this setting.

selectable

selectable

enabled

When enabled, you can make selections as normal in the Viewer. When disabled, points cannot be selected or changed.

render

render_mode

unchanged

Sets how the object will render. This control is independent from the display selection, but has the same settings.

reset shape to input

reset_shape

N/A

Cancels your changes and resets the input to its original shape.

copy

copy_shape

N/A

Copies the current positions of the bounding box corners (p0-p7) into a temporary buffer.

paste

paste_shape

N/A

Pastes previously copied positions of the bounding box corners (p0-p7).

set key

set_key_shape

N/A

Sets keys for the positions of all the bounding box corners (p0-p7) on the current frame. This is the same as selecting Setkey from the animation menu next to each of the controls.

delete key

del_key_shape

N/A

Deletes the keys on the positions of all the bounding box corners (p0-p7) on the current frame.

delete anim

del_anim_shape

N/A

Deletes the keys on the positions of all the bounding box corners (p0-p7) on all frames.

p0 xyz

p0

-0.5, -0.5, -0.5

The x, y, and z coordinates for the p0 corner of the bounding box. You can also adjust these by dragging the corner in the Viewer.

p1 xyz

p1

-0.5, 0.5, -0.5

The x, y, and z coordinates for the p1 corner of the bounding box. You can also adjust these by dragging the corner in the Viewer.

p2 xyz

p2

0.5, 0.5, -0.5

The x, y, and z coordinates for the p2 corner of the bounding box. You can also adjust these by dragging the corner in the Viewer.

p3 xyz

p3

0.5, -0.5, -0.5

The x, y, and z coordinates for the p3 corner of the bounding box. You can also adjust these by dragging the corner in the Viewer.

p4 xyz

p4

-0.5, -0.5, 0.5

The x, y, and z coordinates for the p4 corner of the bounding box. You can also adjust these by dragging the corner in the Viewer.

p5 xyz

p5

-0.5, 0.5, 0.5

The x, y, and z coordinates for the p5 corner of the bounding box. You can also adjust these by dragging the corner in the Viewer.

p6 xyz

p6

0.5, 0.5, 0.5

The x, y, and z coordinates for the p6 corner of the bounding box. You can also adjust these by dragging the corner in the Viewer.

p7 xyz

p7

0.5, -0.5, 0.5

The x, y, and z coordinates for the p7 corner of the bounding box. You can also adjust these by dragging the corner in the Viewer.

Source box Tab

use incoming bounding box

src_use_bbox

enabled

By default, the node warps the bounding box of the input object. If you'd rather warp a custom bounding box, uncheck this and use the controls below to define the custom box.

reset source box to input

reset_src_shape

N/A

Cancels any changes you've made to the custom bounding box and resets it to the original settings taken from the input.

This control is only available if you have unchecked useincomingboundingbox.

box

src_color

red

The color of the custom bounding box in the 3D Viewer.

This control is only available if you have unchecked useincomingboundingbox.

src0 xyz

src0

-0.5, -0.5, -0.5

Sets the x, y, and z coordinates for one of the two custom bounding box corners you can adjust.

src1 xyz

src1

0.5, 0.5, 0.5

Sets the x, y, and z coordinates for one of the two custom bounding box corners you can adjust.

Step-by-Step Guides

Modifying Objects Using a Trilinear Interpolation