Houdini Engine HDA Loader (Alpha)

Houdini Engine for Omniverse USD Composer

Overview

Houdini Engine HDA Loader for Omniverse USD Composer allows you to run Houdini Digital Assets inside Omniverse USD Composer. For accessing Omniverse Nucleus and Omniverse features inside Houdini, please refer to Houdini Connector.

Requirements

  • Windows 10 or above

  • Omniverse USD Composer 2023 (Omniverse Kit 105) or above

  • SideFx Houdini Engine 19/19.5 license

Enable Houdini Engine Extension

Enable Houdini Engine Extension
  1. Launch Omniverse USD Composer. Click on Window > Extensions in the Main Menu.

  2. Search for “Houdini” in the Extension Search Bar.

  3. Select the HOUDINI ENGINE HDA LOADER Extension.

  4. Enable the Extension.

Using Houdini Engine Extension

Launch Houdini Engine Extension

Houdini Engine Extension Window

In the Main Menu, click on Window > Houdini Engine > Houdini Digital Asset Loader.

Basic Settings

The Houdini Engine Extension window looks like the image below

Basic Settings

Settings

Description

HDA Library

The HDA files to install in the current Houdini Engine session - This can be a HDA file path or a directory that contains HDA files. omniverse:// path is not supported yet.
By default, we load all Houdini built-in HDAs under $HHotlsOPlibSop.hda

HDA Name

The type name of the HDA to create and use. The dropdown menu has all the HDAs that have been installed to the current Houdini Engine session.

Input Prim Paths

The Prim paths of the geometries from Omniverse USD Composer to send to Houdini Engine session. For example: You have a stage of a city in Omniverse USD Composer, and you can just pass a building to the Houdini Engine session by specifying the building’s USD prim path.
Empty Input Prim Paths implies the HDA node has no input connector.

Author Data in Sublayer

Store the HDA processed data/geometries in a new layer as a sublayer. Enabling this option allows you to turn on/off the HDA layer later - similar to Houdini’s bypass flag.
If this option is unchecked, the HDA processed data/geometries will be stored in the EditTargetLayer of the stage in Omniverse USD Composer. Note that UNDO HDA cook is not supported currently.

Save Debug hip

Save a hip file after HDA cooked. Note this might increase the cook time.

Load HDA

Create a HDA node instance in current Houdini Engine session and populate the node parameters.

HDA Parameters and Cook

HDA Parameters

After clicking the Load HDA button. The node parameters will be populated. You can tune the parameters. Once you think the node ready to cook, you can hit the Cook button.

Scatter Models Example

Here we are going to use Scatter Models HDA as an example.

Scatter Model Example HDA

HDA Directory Location
  1. Add example HDAs data/hdas/examples to your Houdini directory. For example, C:\Users\Tom\Documents\houdini19.5\otls\.
    The example HDAs can be found in your kit directory. Click the folder icon in Extension Window to find where the kit directory is.
Launch HDA Loader
  1. Launch Omniverse USD Composer and Launch a HDA Loader.
    Click on Window > Houdini Engine > Houdini Digital Asset Loader in Main Menu.
Simple Geometry
  1. Create a simple geometry shape. A Sphere would work.

  2. Change the HDA Library to the path you did on step 1 - for example, C:\Users\Tom\Documents\houdini19.5\otls\

  3. Select HDA Name: Sop/omni_example_scatter_model::1.0

  4. Input Prim Paths: /World/Sphere (or the prim path you created in step 3.)

  5. Hit Load HDA button - Now a Sop/omni_example_scatter_model node instance is created in the Houdini Engine session.

Scatter Model Parms
  1. Hit Cook button

Scatter Models
  1. When cooking is done, you should see models being generated in Omniverse USD Composer.

Note

Change the visibility to invisible on /World/Sphere prim.

Fracture

Select Models

Now we are going to fracture the models.

  1. Toggle the Fracture parameter.

  2. Hit Cook button.

Now the models are updated and fractured.

Add Physics

Add Physics

Now we are going to add physics properties to the models and run sinmulations.

  1. Select all fractured models pieces.

  2. Right click > Add > Physics > Rigid Body with Colliders Preset.

  3. New you can hit the Play (SPACE) button on Omniverse USD Composer to run the Physics simulation.

Behind the scene - HDA Layers

HDA Layers

Each HDA instance stores its geometries in a USD layer.

Hide HDA Layer

Since each operation is stored in its own layer, we can mute the layer to see the stage as before HDA and after HDA. Also if you don’t like the cooking result, you can just remove the layer from the Stage’s sublayer paths.

Advanced Settings

There are two special parms that allow you to have more controls on how Houdini Engine for Omniverse USD Composer exports geometries. If your HDA has

  • A button parm called execute- Houdini Engine for USD Composer will press that button before start cooking. It is ideal if you want to run some pre-process before cooking the node.

  • A string parm called omni_usd_output_path - Houdini Engine will cook the node, then load the USD file which specified on that parm directly to Omniverse USD Composer, instead of loading the USD file that was converted from the HDA geometries.

By Combining these 2 parms together, you can have full control of how Houdini Engine for Omniverse USD Composer generates USD from Houdini. For example, You can have an execute button to writes out a USD file from the HDA and have the output USD path specified in omni_usd_output_path parm.

Known issues and limitations

  • We only support Sop level HDAs at this point. Houdini Engine doesn’t support LOP HDA yet. However, you can always wrap LOPs (or other operator types) in a SOP HDA.

  • Multi-parms is not supported yet. If your HDA has multi-parm, the cook will still work, but you won’t be able to set values on the multi-parms.

  • The memory usage can be huge - if you have heavy geometries. Keep monitoring your memory usage is recommended. Look for HARS.exe in your Windows Task Manager.