GeoImport

The GeoImport node is used to import USD and Alembic objects from external files into Nuke. It supports the import of.usd, .usda, .abc, and .mltx files. GeoImport does not allow you to change the path of the object in the scene graph so be aware that conflicts can easily occur when importing the same file more than once - to avoid these entirely, use the GeoReference node to create an instance, or light-weight copy, of the required objects.

To learn more about the workflow, see Importing with GeoImport.

Note:  GeoImport's classic 3D system equivalent is the ReadGeo node.

Inputs and Controls

Connection Type

Connection Name

Function

Input

unnamed

The previous stage in the scene to which you want to add objects.

Control (UI)

Knob (Scripting)

Default Value

Function

GeoImport Tab

File

file

none

The path to the external file that you want to import. When the file is first loaded in, this will launch the Import Scene Graph Dialog. It supports the import of .usd, .usda, .abc, and .mltx files.
Localization Policy localizationPolicy from auto-localize path

Allow local file caching. Copies of the files are stored in a specified local folder for faster access times. This is supported for Alembic (.abc) files only, and will be disabled if you import a USD file.

on: always localize

from auto-localize path: localize if the file resides in the "auto-localize from" directory

on demand: localize on demand

off: never localize
Update updateLocalization Update If you change the Localization Policy setting, click Update button to apply the change.
Metadata: Promote layer metadata to stage promote_layer_metadata enabled If true, the following metadata fields can be promoted to the stage:
• Start time code
• End time code
• Frames per second
• Time codes per second
• Frame precision
• Meters per unit
• Default prim
• Up axis
• Owner
• Custom layer metadata
Note that if multiple layers specify a value, the strongest opinion is used.

Reload

reload

N/A

Click to update the scene graph with any changes made to the external USD file specified in the File control.

Frame Range

range_first
range_last

1, 1

If range size is non-zero then animation is assumed to be contained in the input file data, forcing the graph to re- evaluate on frame changes. If the input file is known to be static then resetting these to 1 , 1 stop this graph updating.
Time Remapping
Offset time_offset 0 Offsets the USD prim animation by this amount
Scale time_scale 1 Scales the referenced prim animation by this amount. Values between 0 and 1 speed up the animation and values higher than 1 slow it down.
Scene Graph Tab
Scene Graph N/A N/A Once a file is loaded in, use the Scene Graph tab where you can manage your stage after import. See more at Importing with GeoImport.