Search TipsGeoImport
The GeoImport node is used to import USD, Alembic, MaterialX, and Gaussian Splat files from external files into Nuke. It supports the import of .usd, .usda, .usdc, .abc, .mltx, .ply and .splat 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, .usdc, .abc, .mltx, .ply, and .splat 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 |
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 Mapping | |||
| 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. |
