← Fusion node reference
USD / 3DIntermediate

uImagePlane

Image card in a USD scene

Creates a USD image plane from an external image with size, transform and separate-stage export controls.

uImagePlane
DaVinci Resolve · Fusion

uImagePlane places a flat textured card directly into the USD scene. It is useful for references, backplates, billboards, matte cards, projection helpers and other cases where a 2D image needs a 3D position.

Overview

What uImagePlane does

uImagePlane places a flat textured card directly into the USD scene. It is useful for references, backplates, billboards, matte cards, projection helpers and other cases where a 2D image needs a 3D position.

Mental model

Think of uImagePlane as a photograph mounted on a flat card in 3D space: Filename chooses the picture, Size defines the card, and Transform positions it relative to the camera and scene.

Common uses

Backplates and reference cards
Billboards
Matte cards
Projection/layout helpers

Flow anatomy

Inputs & outputs

The port structure shows how this node fits into a Fusion graph.

Stage / USD Input

USD stage data processed by this node.

uImagePlane
Fusion node

Stage Output

The resulting USD stage.

Inspector

Important parameters

Start with these controls before reaching for more complicated workarounds.

Filename

Sets the file used by the node.

Choose the source file here. If the project will be moved to another workstation, keep the path portable or collect the media with the project.

Browse

Opens a file browser for the related path or resource.

Size

Sets the base dimensions of the image card.

Export as Separate Stage

Packages the image plane as an independent USD stage/layer.

Translation X / Y / Z

Positions the card in scene space.

Rotation Order

Sets the 3D rotation order.

Defines the order in which the three rotation axes are evaluated.

Rotation X / Y / Z

Sets rotation on the X, Y and Z axes.

Pivot X / Y / Z

Sets the transform pivot.

Lock X/Y/Z

Links the X, Y and Z values for scale.

Scale

Sets the overall scale.

Use Target

Orients the plane toward a target when supported.

Practical setup

A reliable workflow

  1. 1

    Choose the source image.

  2. 2

    Set card size and aspect intent.

  3. 3

    Position it relative to the intended uCamera.

  4. 4

    Use target orientation for billboard-like behavior only when appropriate.

  5. 5

    Merge the plane with the shot stage.

  6. 6

    Check filtering and perspective in uRenderer.

Typical node chain
Image File
uImagePlane
uMerge
uRenderer

Examples

Where this node fits in real work

Reference backplate

Place a reference image behind USD geometry for layout and camera matching.

uImagePlaneuCamerauMergeuRenderer

Billboard card

Place a textured plane in the scene as a simple 2.5D element.

uImagePlaneuTransformuMergeuRenderer

Troubleshooting

Common mistakes

Treating the image plane as screen-space footage rather than 3D geometry.
Ignoring the camera perspective and placing the card at an arbitrary depth.
Using excessive scale instead of setting an appropriate base size.

Production notes

Practical tips

Use uImagePlane for simple cards; use regular 2D compositing when the image does not need 3D parallax.
Keep reference/backplate planes on clearly named USD branches.
Verify the image color interpretation when the plane is part of final output.

Related nodes