Go to:
Related nodes. Attributes.
This node defines a logical collection of objects, object components,
and node attributes. ObjectSets (sets) are very useful and are used
heavily in the application. Sets are used to define which parts of an
object to deform. Sets are used to define which objects should be have
the same shading properties and are called shading groups or renderable
sets. Anything that can be selected using the 'select' command can be
added to an objectSet. An objectSet is created and edited using the "sets"
command.
ObjectSets may be connected to a partition. Partitions define a
collection of mutually exclusive sets. If a set is connected to a
partition, a member of the set cannot also be a member of another set
which is also connected to that same partition. Mutual exclusivity is
maintained by the "sets" and "partition" commands. The shading groups
mentioned above are connected to the renderPartition.
Membership in a set is defined by establishing connections between
another node's attribute and one of two attributes of the objectSet.
Connections to an objectSet's "dagSetMembers" attribute should be made
if the object is a dagNode and the attribute is the "instObjGroups"
or "objectGroups" attribute. Connecting to the "instObjGroups"
attribute means the whole object is in the set. Connecting to the
"objectGroups" attribute means that a part (component) of
the object is in the set. Otherwise, connections to any other
attribute of any node should be made to the objectSet's "dnSetMembers"
attribute. Connections to this attribute simply mean that the
attribute is a member of the set.
An objectSet can have associated with it an index (0-7) to one of the
user defined display colors. If the memberWireframeColor attribute has
a value of 0-7, any components of objects (such as surface CVs) which
are a member of the set will be displayed in the user defined color
identified by that index. If the value is -1, the components will be
drawn in their normal color. This is useful for visually identifying
which parts of an object are in which set.
An objectSet can also have an annotation which is a text string
associated with the set and can be used to describe the purpose or
contents of the set.
Sets are special when it comes to selection. The MEL command "select
set1;" causes the members of set1 to be put on the active list instead
of set1 itself. To put set1 on the active list, you need to use
"select -noExpand set1;".
Node name | Parents | MFn type | Compatible function sets |
---|
objectSet | entity | kSet | kBase kNamedObject kDependencyNode kSet |
Related nodes
groupParts, groupId
Attributes (13)
annotation, dagSetMembers, dnSetMembers, edgesOnlySet, editPointsOnlySet, facetsOnlySet, groupNodes, isLayer, memberWireframeColor, partition, renderableOnlySet, usedBy, verticesOnlySet
Long name (short name) | Type | Default | Flags |
---|
|
dagSetMembers
(dsm )
| generic typed data | NULL | |
|
|
dnSetMembers
(dnsm )
| generic typed data | NULL | |
|
|
memberWireframeColor
(mwc )
| short | -1 | |
|
|
annotation
(an )
| string | NULL | |
|
|
isLayer
(il )
| bool | false | |
|
|
verticesOnlySet
(vo )
| bool | false | |
|
|
edgesOnlySet
(eo )
| bool | false | |
|
|
facetsOnlySet
(fo )
| bool | false | |
|
|
editPointsOnlySet
(epo )
| bool | false | |
|
|
renderableOnlySet
(ro )
| bool | false | |
|
|
partition
(pa )
| Message | n/a | |
|
|
groupNodes
(gn )
| Message | n/a | |
|
|
usedBy
(ub )
| Message | n/a | |
|