pomadd command

Creates a new persistent handle or group.

Replaced by: hou.persistentHandles, hou.PersistentHandle

All Usages Options Examples

See also: pomattach, pomclear, pomdetach, pomls 3 more , pomremove, pomscript, pomset

Usages

  1. pomadd -g [-v] manip_group_name

  2. pomadd [-e on|off] [-p on|off] [-c on|off] [-s on|off] [-m mask] [-r r g b] manip_name type

If you are creating a group with the -g option, you can only specify the group name. If you are creating a handle, you can also specify the display flags (as with the pomset command).

The type can be any of the values returned by the omls command.

Options

-g

Create a group.

-e on|off

Display handle on/off

-p on|off

Display handle when viewing parent ops on/off

-c on|off

Display handle when viewing child ops on/off

-s on|off

Display handle when viewing sibling ops on/off

-r r g b

Sets the handle color. Each component should be a fraction between 0 and 1.

Examples

pomadd "New Xform" xform
Creates a handle of type xform with the name “New Xform”.

pomadd -g "New Group"
Creates a new handle group named “New Group”.

set group_name = `execute("pomadd -g -v NewGroup")`
Creates a new handle group named NewGroup and sets the variable group_name to the actual created name which may differ if a group by the same name already existed.