Search Tips

Search is based on keyword.

`Ex: "Procedures"`

Do not search with natural language

`Ex: "How do I write a new procedure?"`

Give Feedback Support Portal

# UsdIn

The UsdIn node allows you to import USD assets into Katana.

Universal Scene Descriptor (USD), is an open-source scene information interchange framework developed by Pixar. USD allows you to assemble and organize large amounts of assets into scenes or shots and transfer them between Digital Content Creation packages in a non-destructive way. USD files can contain geometry, materials and shading assignments, lighting, and physics.

For more information on USD, see https://graphics.pixar.com/usd/release/intro.html

Note: For versions of Katana before 4.5v1, you must to enable the USD plug-in using environment variables. For more information on how to do this, see Loading USD Plug-ins into Katana.

Control (UI) | Default Value | Function
fileName | N/A | Specifies where to retrieve the asset, a USD (.usd, .usda, .usdc, or .usdz) file. For more information, refer to Asset and File Path Widget Types.
assetResolverContexts | N/A | Sets the Asset Resolver Context which will be bound when opening the stage. If this is not specified, a default context is used based on the Asset Resolver for the fileName parameter.
location | /root/world/geo/asset | Specifies the scenegraph location where the USD asset is to be placed. The location parameter options are available in either the scenegraph widget or dropdown menu to the right of the parameter. For more information, refer to the Scene Graph Location Widget Type.
isolatePath | N/A | Used to load only the USD contents below a specified USD prim path.
variants (deprecated) | N/A | Used to specify USD Variants. This parameter is deprecated, we recommend to using USDVarientSelect instead.
ignoreLayerRegex | N/A | Ignores matching USD layers when a scene is being loaded into Katana.
motionSampleTimes | N/A | Specifies the frame-relative sample times to use when motion blur is requested using two input frames separated by a space. For example: Entering 0 1 loads all samples that contribute to the current frame's shutter window. Entering -1 1 loads all samples that contribute to the previous, current, and next frame's shutter window. The default behavior is no motion samples, load only the current frame. Generally, using more samples produces smoother motion blur, but at the cost of longer render times. The number of motionSampleTimes can be overridden with either UsdInDefaultMotionSamples or UsdInMotionOverrides nodes downstream. Note: The RenderSettings node maxTimeSamples control must be set to match the second sample time input to enable motion blur in renders.
instanceMode | expanded | When set to expanded, instances are loaded as though the children of parent primitives were there naturally. When set to sources and instances, parents of instanced primitives are created under a sibling of /world named /instances.
usdPurposeBasedMaterialBinding | No | When enabled, allows you to specify material bindings to be loaded in for objects with a purpose tag within the USD file. When disabled, Katana will load in the full USD scene with all material bindings resolved. Note: For more information, see USD Glossary: Purposes.
prePopulate | enabled | Assumes all assemblies and pre-populates present in your USD file are needed within the scene and loads them all in. Having prePopulate is good for efficiency, as it allows USD to use its own multithreading.
limitPopulationToModelHierarchy | enabled | If unchecked, the `UsdIn.UpdateGlobalLists` Op will traverse the entire USD stage, rather than just the prims part of the model hierarchy. This affects the creation of the `lightList` and `globals.cameraList` attributes on the `/root/world` location. To populate the light list, `UsdLuxLightListAPI` can still be used to store the `lightList` property and control the cache behavior via the `lightList:cacheBehavior` property. This functionality can be driven globally by the `KATANA_USD_GLOBALS_TRAVERSE_MODEL_HIERARCHY` environment variable, which, if set, takes precedence over this parameter.
verbose | disabled | When enabled, the information generated during USD scenegraph generation is output to the command line.
asArchive | disabled | When enabled, the type specified in the location parameter is usd archive instead of loaded directly into the scene. If enabled, variants, ignoreLayerRegex, motionSampleTimes, and instanceMode are made unavailable.
evaluateUsdSkelBindings | enabled | If enabled the skinning will be applied to each prim that is bound to a skeleton.