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 |
|---|---|
| Type id | OC_N_geoimport |
| Menu | 3D › GeoImport |
| Nuke class | GeoImport (also imports ReadGeo, ReadGeo2) |
| Code | opencomp_core/nodes/three_d/geo_io.py |
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 Nuke: 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 | Nuke 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 (Nuke 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 | Nuke 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 |
Nuke equivalent
Imports from and exports to Nuke's GeoImport (ReadGeo, ReadGeo2 also import to it).
Knobs with a different name here:
| Nuke knob | Knob here |
|---|---|
localizationPolicy | localization_policy |
cacheLocal | localization_policy |
Nuke knobs not in this list import as a knob of the same name, or are kept unchanged for export. See .nk import.