Go to: Attributes.
When a reference is unloaded, a reference node keeps track of the changes
made to objects in the reference file. When the reference is reloaded,
the changes stored in the reference node are retored to the reference.
Reference nodes store connections between attributes in a scene and
attributes in the reference; connections between attributes contained
in the reference, but that are not part of the reference file; dynamic
attributes on node in the reference file, but where the attributes
were not defined in the reference file; setAttrs made after the file
was referenced; and internal broken reference connections.
There are four lists of changes that are saved: Connections, setAttrs,
addAttrs, and broken connections.
The connections list is a compound
multi, with one child being a generic attributes which can be connected
and the other being the name of the attribute in the reference file that
used to be connected.
The setAttr list is a multi with a command which sets an attribute to
its state before the reference was unloaded.
The addAttr list is a multi of strings, where each string is a command
to add an attribute to a referenced node.
The brokenConnection list is a multi of strings, when each string is a
command to break a referenced connection.
Node name | Parents | MFn type | Compatible function sets |
---|---|---|---|
reference | dependNode | kReference | kBase kNamedObject kDependencyNode kReference |
addAttrList, brokenConnectionList, connection, connectionAttr, connectionList, deleteAttrList, edits, fileNames, fosterParent, fosterSiblings, locked, multiParent, multiParentList, parentList, placeHolderList, proxyMsg, proxyTag, setAttrList, sharedReference, unknownReference
Long name (short name) | Type | Default | Flags | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
fileNames
(fn )
| string | NULL | |||||||||||||||
connectionList
(cl )
| compound | n/a | |||||||||||||||
| |||||||||||||||||
| |||||||||||||||||
setAttrList
(sl )
| string | NULL | |||||||||||||||
addAttrList
(al )
| string | NULL | |||||||||||||||
deleteAttrList
(dl )
| string | NULL | |||||||||||||||
brokenConnectionList
(bl )
| string | NULL | |||||||||||||||
parentList
(pl )
| string | NULL | |||||||||||||||
fosterParent
(fp )
| Message | n/a | |||||||||||||||
fosterSiblings
(fs )
| Message | n/a | |||||||||||||||
placeHolderList
(phl )
| Generic | NULL | |||||||||||||||
multiParentList
(mpl )
| compound | n/a | |||||||||||||||
| |||||||||||||||||
edits
(ed )
| referenceEdits | NULL | |||||||||||||||
proxyTag
(ptag )
| string | NULL | |||||||||||||||
proxyMsg
(pmsg )
| Message | n/a | |||||||||||||||
unknownReference
(ur )
| Message | n/a | |||||||||||||||
sharedReference
(sr )
| Message | n/a | |||||||||||||||
locked
(lk )
| bool | false | |||||||||||||||