Usage#

There are two different entry points to import CAD files using the Hoops Converter.

How to Import and Convert Files#

File -> Import#

To import a CAD file into Omniverse:

  1. Navigate to the top menu and select File > Import

  2. A file dialog will open. Browse to the location of your file, select it, and click Import.

CAD Converter File Import

Content Browser -> Convert To USD#

To convert a CAD file to USD:

  1. If the Content window is not already open. Navigate to the top menu and select Window > Browers > Content.

  2. A Content browser window will open. Browse to the location of your file or files, select them, and right-click, and select Convert to USD in the Context menu.

  3. The Converter Options dialog window will appear; modify any options as needed, and click Convert.

Note: You can select more than one file to batch Convert to USD, we recommend turning off Reference in the Current Stage.

CAD Converter Convert to USD

Converter Options#

Convert Visible Only#

If true, skip hidden elements; else, convert hidden elements but set to invisible.

Generate Projection UVs#

If UV texture cordinates are missing then this option will use the Scene Optimizer Kit Extension as a post-conversion process to generate texture coordinates for meshes. When this option is enabled, default values are used as described in the Generate Projection UVs section of the Scene Optimizer documentation.

Enable Instancing#

This option will determine whether or not instancing will be used in the USD.

Convert Metadata#

If true then metadata, including PMI and BIM relationships(applicable only to .ifc models) are imported as USD Attributes or USD Relationships; else, metadata are ignored.

Here is an example of metadata conversion from CAD to USD, where the converted metadata is prefixed with the omni:hoops:metadata namespace. Please consult the comprehensive example in HOOPS Exchange SDK’s Generic Attributes guide to understand how the converter gathers the list of attributes through PRC tree traversal.

CAD Metadata

USD Metadata

Edit Stage Metrics#

These options changes the metersPerUnit and/or upAxis of a stage’s active edit target layer by updating the layer’s metadata and applying relevant transformations to attributes that represent world space units so that they reflect the new metersPerUnit/upAxis.

Override Up-Axis#

Override the up-axis of the converted USD’s stage to Y-up, Z-up, or default to the converter’s up-axis setting.

Meters Per Unit#

Set the meters per unit converted USD’s stage metric. If set to 0.0, the converted USD will retain the meters per unit from conversion.

Material Selection#

Set the material type for target renderer.

  • None. No materials are generated.

  • USD Preview Surface (default). Compatible with Universal renderer contexts.

  • OmniPBR (+ USD Preview Surface). Compatible with RTX and Universal renderer contexts.

Tesselation Level#

Tesselation level may be set when converting BREPs to geometry.

The available presets are:

  • ExtraLow : ChordHeightRatio=50, AngleToleranceDeg=40,

  • Low : ChordHeightRatio=600, AngleToleranceDeg=40,

  • Medium : ChordHeightRatio=2000, AngleToleranceDeg=40,

  • High : ChordHeightRatio=5000, AngleToleranceDeg=30,

  • ExtraHigh : ChordHeightRatio=10000, AngleToleranceDeg=20.

CAD Converter File Import

ChordHeightRatio: Specifies the ratio of the diagonal length of the bounding box (defined by Dxd) to the chord height.

A value of 50 means that the diagonal of the bounding box is 50 times greater than the chord height.

Values can range from 50 to 10,000. Higher values will generate more accurate tessellation.

AngleToleranceDeg: Specifies the maximum angle between two contiguous tessellation segments describing the curve of a topological edge for every face.

During tessellation, the curve describing the edge of a topological face will be approximated using straight line segments.

AngleToleranceDeg is the maximum angle between two consecutive segments.

Allowable values range from 10 to 40. Lower values will result in greater accuracy.

Destination Options#

The entry points for conversion expose different destination options.

File -> Import#

File -> Import is recommended for importing data into your stage.

Content Browser -> Convert to USD#

Destination Options#

Convert To USD is recommended to convert files to external USD files only. You may choose to Reference in Current Stage or not.

Convert to USD

Path The default location for the converted USD file matches the source file’s location. You may specify an alternative destination if preferred.

Enable Reference in Current Stage to automatically add references in the current stage after conversion. If disabled, the converted USD is saved to the default or specified destination and is not added as a reference in the current stage.

Scene Optimizer Config#

(Experimental feature) Provide a path to a saved Scene Optimizer JSON configuration file or a JSON formatted string for executing a predefined optimization process stack. See Scene Optimizer Service documentation for details.

Getting Help#