Go to: Return value. Related commands. Flags. Examples.

Synopsis

cpProperty [flags]

This command creates or assignes a property node.

Return value

The new property node name.

Related commands

cpButton, cpPanel, cpSolver, cpCollision, cpTool, cpConstraint, cpSeam

Flags

addVerts, assign, help, indexList, list, listMeshNodes, listSets, name, query, reassign, remove, removeVerts

Long name (short name)[argument types]Properties
-help (-h) create
Prints a quick help message.
-assign (-a) propertyNameedit
This option assigns the property with the given name to the set of selected panels.
-reassign (-ra) propertySetNameedit
This option assigns the selection to the existing property set node. This is useful for assigning an alterative set of vertices to an existing property set. The selected vertices must belong to the same mesh that the property was previously assigned.
-addVerts (-add) edit
This flag can be used with the -reassign flag to specify that that the given selection list should be added to the property set versus the default action of replace.
-removeVerts (-rv) edit
This flag can be used with the -reassign flag to specify that the selected vertices should be removed from the property set.
-remove (-r) edit
Remove the property nodes from the selected items. This removes the controller node connection from the solver. It does not delete the node.
-list (-l) query
This option returns the names of the property nodes that are in the scene.
-listSets (-ls) query
List the property sets in the scene.
-indexList (-il) string stringquery
Show the index list for the given property set and mesh. The property set is the first argument and the mesh is the second argment. If the mesh is not attached to the property set nothing is returned.
-listMeshNodes (-lmn) stringquery
Show the mesh nodes that belongs to the given property set.
-name (-n) propertyNamecreate
This option uses the given name when creating a property.
-query (-q) query
This option requires a property to be selected and specifies that the command is a query.

Flag can appear in Create mode of command Flag can appear in Edit mode of command
Flag can appear in Query mode of command Flag can be used more than once in a command

Examples


 // Create a new property in the scene.
 cpProperty;

 // List all property nodes in the scene.
 cpProperty -q -list;

 // Assign named property to a set of one or more selected panels.
 cpProperty -assign shirtProperty;