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')