USD importer
The USD importer imports the Universal Scene Description (USD) file format which was originally developed by Pixar. USD has gained relatively widespread adoption thanks to its use as the default format for the AR Quick Look technology used by Apple on iOS devices as well as initiatives such as the NVIDIA Omniverse project.
USD is also widely used in the Media and Entertainment industry, particularly in visual effects for feature film and television production. However use is now extending into other industries such as AEC and product design. USD is a highly extensible format and can support many features not suitable for use in RealityServer and as such only the functionalty actually defined in the specification is supported. One notable exception is that support is provided for the MDL Schema which allows MDL materials to be used within USD files.
Importer Options
When using the importer through the import_scene, import_scene_elements or import_scene_elements_from_string commands in RealityServer it is possible to provide additional options through the use of the import_options parameter. This parameter accepts a Map where the property key corresponds to the option name and the value to the value you want to set for the option. The table below describes the options available for the USD importer. This is in addition to the standard options provided by all importers.
Property Key | Default | Description |
---|---|---|
frame | 0 | If provided controls the frame number of the animation stored within the USD file which will be used during import. This may affect how geometry is positioned or deformed if there are animations within the USD file. If not provided the first frame is used. |
Example: Imports a USD file as a scene and sets various options.
{ "method": "import_scene", "params": { "scene_name": "my_scene", "filename": "my_file.usd", "import_options": { "frame": 150 } } }