Go to: Synopsis. Return value. Keywords. Related. Flags. Python examples.
containerProxy([fromTemplate=string], [type=string])
Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.
containerProxy is undoable, queryable, and editable.
Creates a new container with the same published interface, dynamic attributes
and attribute values as the specified container but with fewer container
members. This proxy container can be used as a reference proxy so that values
can be set on container attributes without loading in the full container.
The proxy container will contain one or more locator nodes. The first locator
has dynamic attributes that serve as stand-ins for the original published
attributes. The remaining locators serve as stand-ins for any dag nodes
that have been published as parent or as child and will be placed at the
world space location of the published parent/child nodes.
The expected usage of container proxies is to serve as a reference proxy
for a referenced container. For automated creation, export and setup
of the proxy see the doExportContainerProxy.mel script which is
invoked by the "Export Container Proxy" menu item.
In query mode, return type is based on queried flag.
proxy, container
container, containerTemplate
fromTemplate, type
| Long name (short name) |
Argument types |
Properties |
fromTemplate(ft)
|
string
|
|
|
Specifies the name of a template file which will be used to create the new
container proxy. Stand-in attributes will be created and published for all
the numeric attributes on the proxy.
|
|
type(typ)
|
string
|
|
|
Specifies the type of container node to use for the proxy. This flag is only
valid in conjunction with the fromTemplate flag. When creating a proxy for an
existing container, the type created will always be identical to that of the source
container. The default value for this flag is 'container'.
|
|
|
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 have multiple arguments, passed either as a tuple or a list.
|
import maya.cmds as cmds
# create a proxy for container1
#
cmds.containerProxy('container1')