GeoImport
Imports a 3D scene file (USD, Alembic, OBJ, FBX, glTF, PLY, STL, or a Blender .blend) into the 3D system; the file's animation follows the frame through time offset and time scale.
Imports a 3D scene file (USD, Alembic, OBJ, FBX, glTF, PLY, STL, or a Blender .blend) into the 3D system; the file's animation follows the frame through time offset and time scale. No Blender is needed except for .blend, which is converted to USD in the background and converted again when saved. Opening a new file shows an import dialog with the contents, the file's frame range, units scale and up axis.
| Node | GeoImport |
|---|---|
| Menu | 3D › GeoImport |
| Names in each format | |
| .oink comp (JSON) | "type": "OC_N_geoimport" |
| .nk script | GeoImport, also imports ReadGeo, ReadGeo2 (how .nk import works) |
| Python | nuke.createNode("GeoImport") |
| Assistant (MCP) | create_node(type="GeoImport") |
| Tab search | geoimport, or its initials gi |
Frame range
range_first,range_last: the file's animation holds its first and last frame outside this range. The default (1 to 1) means no range.units_scale,up_axis: scale the file (for example centimetres to metres) and turn Z up to Y up, or the other way.
Localization
localization policy and Update work as on the Read node, for Alembic (.abc) files only, as in Other formats are always read from where they are. See Localization.
Inputs and outputs
| Port | Name | Type |
|---|---|---|
| input 0 | scene | scene |
| output 0 | scene | scene |
Knobs
Panel tab Geoimport, in panel order.
| Knob | Label | Type | Default | Range / values | .nk knob | Description |
|---|---|---|---|---|---|---|
file | file | file | file | |||
localization_policy | localization policy | menu | fromAutoLocalizePath | on, fromAutoLocalizePath (from auto-localize path), onDemand (on demand), off | localizationPolicy | when the .abc file is copied to the local cache (.nk localizationPolicy). |
updateLocalization | Update | button (panel only) | Update: copy the file now, or again when its source changed. | |||
range_first | frame range | float | 1 | -10000 to 100000 (integer) | range_first | |
range_last | to | float | 1 | -10000 to 100000 (integer) | range_last | |
time_offset | time offset | float | 0 | -1000 to 1000 | time_offset | |
time_scale | time scale | float | 1 | 0 to 10 | time_scale | |
units_scale | units scale | float | 1 | 0.0001 to 1000 | ||
up_axis | up axis | menu | file | file (as imported), z_to_y (Z up -> Y up), y_to_z (Y up -> Z up) |
Other knobs (Python, .nk and the assistant; not on the panel)
| Knob | Label | Type | Default | Range / values | .nk knob | Description |
|---|---|---|---|---|---|---|
gl_color | Viewer Controls Color | float ×3 | 0, 0, 0 | 0 to 1 | ||
postage_stamp_frame | Static Frame | int | 1 | -2147483648 to 2147483647 | ||
lifetimeStart | Lifetime Start | int | 0 | -2147483648 to 2147483647 | ||
lifetimeEnd | Lifetime End | int | 100 | -2147483648 to 2147483647 | ||
useLifetime | Use Lifetime | boolean | false | |||
cached | Cached | boolean | false | |||
bookmark | Bookmark | boolean | false | |||
dope_sheet | Dope Sheet | boolean | false | |||
clone_group | Clone Group | string | ||||
link_source | Link Source | string | ||||
link_overrides | Link Overrides | string | ||||
split_views | Split Views | string |
Knob names in .nk scripts
| .nk knob | Knob here |
|---|---|
localizationPolicy | localization_policy |
cacheLocal | localization_policy |
Other .nk knobs use the same name here. See .nk import.