Houdini Engine for Maya
 All Files Pages

Plugin Commands

There are two native plugin commands, houdiniAsset and houdiniEngine


houdiniEngine [-license] [-houdiniVersion] [-houdiniEngineVersion] [-buildHoudiniVersion] [-buildHoudiniEngineVersion] [-makeTempDir] [-saveHIP string]

Long Name Argument Description
-license (-lic) Returns the license type that is currently in use
-houdiniVersion (-hv) Returns the houdini version that is currently in use
-houdiniEngineVersion (h-ev) Returns the houdini engine version that is currently in use
-buildHoudiniVersion (-bhv) Returns the houdini version that was built with
-buildHoudiniEngineVersion (-bev) Returns the houdini engine version that was build with
-makeTempDir (-mtp) Returns the path of the houdini temp directory, creating it if needed
-saveHIP (-sh) filePath Save the contents of the engine session to the specified hip file

// Some Examples:

houdiniEngine -lic;
// Result: Houdini-Engine // 
houdiniEngine -hv;
// Result: 17.0.354//
houdiniEngine -makeTempDir;
// Result: /usr/tmp/houdini_temp // 


houdiniAsset [-listAssets string] [-loadAsset string string] [-resetSimulation string ] [-cookMessages string ] [-reloadAsset string] [-sync string] [-syncAttributes] [-syncOutputs] [-syncHidden] [-syncTemplatedGeos] [-autoSyncId string]

Long Name Argument Description
-listAssets (-ls) filePath Returns a string array of the names of assets contained in this hda
-loadAsset (-la) filePath assetName Load the named asset from this hda
-resetSimulation(-rs) assetNode reset the simulation for the asset node
-cookMessages(-cm) assetNode Returns the cook messages for the asset node
-reloadAsset(-rl) assetName reload the asset definition for the specified asset, from the hda from which it was previously loaded
-sync(-syn) assetNode sync the asset node
-syncAttributes(-sa) if the -sync flag is present, sync only the attributes, not the outputs for the specified asset noded
-syncOutputs(-so) if the -sync flag is present, sync only the outputs, not the attributes
-syncHidden(-shi) when syncing attributes, create attributes for the hidden parms as well
-syncTemplatedGeos(-stm) when syncing outputs, sync templated geos
-autoSyncId(-asi) assetNode Returns the current autoSyncId for this asset, used internally to determine whether there is already an autoSync running, or whether another one should be triggered

// Some Examples:

houdiniAsset -listAssets "/home/julia/houdini17.0/otls/extrudeFaces.hda";
// Result: Object/extrudeFaces //

houdiniAsset -loadAsset "/home/myHomeDir/houdini17.0/otls/extrudeFaces.hda" "Object/extrudeFaces";
// Result: |extrudeFaces1 //

houdiniAsset -sync |extrudeFaces1 -syncOutputs;

Mel Procs

There are a number of global mel procs in the houdiniEngine module. Many of these were put in place to support functionality that is available from the menu, from attribute editor buttons, or from one of the shelves. Only the ones that seem usable for general purpose scripting have been documented here.

Loading and Connecting Assets

  • houdiniEngine_loadAssetLibrary(string $assetLibraryFilePath)
    Load the asset definitions from the asset library (hda)
  • houdiniEngine_loadAsset(string$assetLibraryFilePath, string $asset)
    Instantiate the named asset, loading the specified asset library if needed
  • houdiniEngine_loadAndAddAsset(string $assetFile, string $assetName, string $assignMode)
    load the asset, and attach it to the selected Maya objects according to the $assignMode:
    OPERATOR_SINGLE: connect all the selected objects to the first input.
    OPERATOR_MULTI: connect selected items to inputs in selection order.
    HISTORY: connect to the first selected item as construction history
  • houdiniEngine_autoSyncAssetOutput(string $assetNode, int $autoSyncId)
    check that no other autosync is running, and then sync
  • houdiniEngine_setAssetInput(string $inputAttr, string $objects[])
    assign the objects to to the specified input attribute, merging if necessary
  • houdiniEngine_syncAssetOutput(string $assetNode)
    rebuild the assets output nodes
  • houdiniEngine_syncAsset(string $assetNode)
    sync attributes and outputs
  • houdiniEngine_syncSelectedAsset()
    sync the asset nodes on the selection list
  • houdiniEngine_reloadSelectedAssets()
    reload the asset definition for the selected assets. Note that other nodes using the same asset definition will not update until forced to cook (and then sync)
  • houdiniEngine_getAssetInput(string $inputAttr)
    get all the input nodes connected to the asset node
  • houdiniEngine_getDownstreamAssets( string $inputNode)
    get all the asset nodes immedialtely downstream of the input node
  • houdiniEngine_getSelectedAssetNodes()
    get all the houdini input nodes upstream of the asset
  • houdiniEngine_updateShelf()
    replace the contents of your local Houdini shelf with the version from the current install
  • houdiniEngine_updateToolsShelf()
    rebuild the content of the tools shelf from the contents of the Tools directory in your current engine instll
  • houdiniEngine_buildToolsShelf(string $toolsLocation)
    rebuild the content of the tools shelf from the contents of the specified directory. So you can replace the tools with your own aversions, or add additional tools. Any new tools need to have the corresponding .json file created.

Construction History

  • houdiniEngine_addHistory($assetNode)
    add the assetNode as construction history to the selected mesh, (or to the mesh whose components are selected)
  • houdiniEngine_addSelectedHistory()
    determine if there is a suitable asset node selected, and if there is apply it to the selected mesh
  • houdiniEngine_bakeAsset($assetNode)
    bake the specified asset
  • houdiniEngine_connectHistory(string $inputAttr, string $objects[], string $components[])
    connect the objects to the input attr as history
  • houdiniEngine_deleteHistory(string $node)
    Delete construction history, including any asssets, from this node. (The regular Maya delete History does not cross plugin nodes)
  • houdiniEngine_removeHistory(string $assetNode)
  • houdiniEngine_removeSelectedHistory()

Procs for ScriptJobs

These two procs are used in script jobs to make sure object level shader changes propagate to the output geometry.

  • houdiniEngine_objectShaderChanged()
    For all meshes connected to input geometry nodes, checks if the object shader assigned to a mesh is the same as the one listed on its input geometry node, if it isn't reset it and dirty the input. We use this with a connectionChanged event to track when shader assignment changes on input geometry. It could be used diretcly to update the shader information on all the input geometry nodes.
  • houdiniEngine_shaderChangeCallbacks()
    For all meshes connected to input geometry nodes, set up the shader changed script job on file open.

Houdini Pages and Applications

These mel procs will start start an application or open a web page

  • houdiniEngine_saveHipFile()
  • houdiniEngine_viewInHoudini()
  • houdiniEngine_runHKey()
  • houdiniEngine_launchChangeLog()
  • houdiniEngine_launchForum()
  • houdiniEngine_launchGitHub()
  • houdiniEngine_launchOrboltPageClick()
  • houdiniEngine_launchSubmitBugs()
  • houdiniEngine_onlineDocumentation()


The asset node allows you to register preSync and postSync callbacks by setting the preSyncCallback or postSyncCallback attribute on the asset to the name of the callback script e.g:

setAttr -type "string" myAssetNode.preSyncCallback "myPreSyncCallback";

Callbacks should be of the form:

preSync(string $assetNode, int $syncOnlyAttributes, int $syncOnlyOutputs)
postSync(string $assetNode, int $syncOnlyAttributes, int $syncOnlyOutputs)


import maya.cmds as cmds
import maya.mel as mel

# load the plugin

# load the Maya scene
cmds.file("/tmp/test_sphere.mb", open=True, force=True)

# load the Houdini asset
asset = cmds.houdiniAsset(loadAsset=["/tmp/test_asset.hda", "Sop/test_asset"])

# speicfy the input geometries to be connectd to the asset
input_geos = [ "|pSphere1" ]

# construct a single string that represent a MEL string array
# wrap with { }
mel_string_array = "{{ {} }}".format(
    # separate by comma
    ", ".join(
        # quote each string
        ["\"{}\"".format(s) for s in input_geos]

# source MEL script for houdiniEngine_setAssetInput
cmds.eval("source houdiniEngineAssetInput")

# call MEL function to connect input geometry
# connect to an actual node input
mel.eval("houdiniEngine_setAssetInput {} {}".format(
    asset + ".input[0].inputNodeId",

# connect to an oppath parameter that accepts geometry
mel.eval("houdiniEngine_setAssetInput {} {}".format(
    asset + ".houdiniAssetParm.houdiniAssetParm_objpath1__node",

# call setAttr to set some attribute
cmds.setAttr("{}.houdiniAssetParm.houdiniAssetParm_height".format(asset), 2)

# to "click" a button that does not affect output geometry, use setAttr
cmds.setAttr("{}.houdiniAssetParm.houdiniAssetParm_some_button__button".format(asset), 1)
# may need to call dgeval() to force the click to be processed

# source MEL script for houdiniEngine_syncAssetOutput
cmds.eval("source houdiniEngineAssetSync")

# sync the asset if needed
cmds.eval("houdiniEngine_syncAssetOutput {}".format(asset))