| Since | 17.0 |
The glTF hierarchy importer can import a glTF scene as a network of nodes or as flattened geometry. See the following link for further information about the glTF format.
Note
See the following link for an overview of importing and exporting GLTF files to and from Houdini.
The follow table provides further details about which glTF features and extensions are supported, plus any relevant notes about how they are supported:
glTF Property or Extension |
Supported |
Notes |
Scene |
|
The glTF scene specified by the Scene parameter will be imported as an Object network with the same node hierarchy as the glTF scene. |
Node |
|
Corresponding Houdini nodes will be created for glTF nodes imported from the selected glTF scene. |
Mesh |
|
glTF nodes with an associated mesh will be imported as a Houdini geometry node containing a SOP GLTF node that is responsible for importing the mesh. |
Mesh Primitive (Points) |
|
- |
Mesh Primitive (Lines) |
|
- |
Mesh Primitive (Triangles) |
|
Mesh primtiives of mode TRIANGLES are supported and will be imported. Mesh primitives with an unsupported mode will be ignored. |
Camera |
|
glTF nodes with an associated camera will be imported as a camera node. |
Skin |
|
- |
Morph Target |
|
- |
Animation (Transform Target) |
|
- |
Animation (Weight Target) |
|
- |
Material |
|
glTF materials will be imported as a Principled Shader node and imported geometry will be assigned the corresponding Principled Shader node as its material. |
Texture |
|
Only textures associated with a glTF material will be imported. Imported textures will be assigned to the appropriate texture map on Principled Shader materials that the texture is associated with. |
KHR_draco_mesh_compression Extension |
|
- |
KHR_lights_punctual Extension |
|
- |
Parameters ¶
File Name
The glTF file to. The loading method depends on the extension of the file loaded.
Files with a .glb extension be treated as binary GLB files.
Files with a .gltf extension will be loaded as normal JSON data.
Asset Extraction Folder
Textures packed into a glTF binary buffer or represented as base64 data must be unpacked before usage.
This field specifies the location textures are to be unpacked on disk.
Scene
Select the scene to import from the glTF object.
In the absence of a scene name, the label will be based off the scene index.
Build Scene
Build the scene from the input parameters. If the scene was loaded previously, this will reload the scene hierarchy and geometry.
Lock Geometry
Enable this option to lock any geometry nodes created during scene building.
Flatten Hierarchy
Flatten all nodes in the scene down to a single node containing all the geometry.
Promote Point Attributes To Vertex
Promote all point attributes (excluding P) to vertex attributes.
Points Merge Distance
When Promote Point Attributes To Vertex is enabled, points within this distance to each other will be merged.
Filter Options ¶
Import Geometry
Enable this option to import geometry objects. When disabled, glTF meshes will be loaded as empty Geometry nodes.
Import Custom Attributes
Enable this option to import any custom attributes from glTF primitives.
Custom attributes in glTF are prefixed with an underscore _ which will be stripped during import.
Import Materials
Enable this option to import glTF materials as Principled Shader materials. This also creates material assignments.
If this option is disabled, materials and material assignments will not be created.
Import Non-Geometry
Import nodes which do not create or transform any geometry. Disable this to remove unused nodes when the additional hierarchical data is unneeded.
Import Unused Materials
Import all materials available, even if they are not assigned or used by the imported scene.