Model.morphhandlecreatenodesnodom#

Model.morphhandlecreatenodesnodom(collectionnode, dcollectionhandle, name)#

Creates handles at nodes on collection with no domain given.

Parameters:
  • collectionnode (Collection) – The collection containing the node entities to create the handles at.

  • dcollectionhandle (Collection) – The collection containing the dependent handle entities. The collection maybe empty.

  • name (hwString) – Name of handle(s) to be created

Example#

Create handles at the nodes on the collection with dependencies on the handles on the collection#
import hm
import hm.entities as ent

model = hm.Model()

model.morphhandlecreatenodesnodom(
    collectionnode=hm.CollectionByInteractiveSelection(model, ent.Node),
    dcollectionhandle=hm.Collection(model, ent.Handle, populate=False),
    name="bob",
)

Note

The domains on which the handles are created are determined automatically based on the node selected. Domains which share a common node are selected in the following order: edges, 2D domains, 3D domains, 1D domains, general domains, and global domains. Handles touching morph volume nodes will not be assigned to any domain.

The name does not need to be unique since this function will create a unique name for each new handle by adding numbers after the name.