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