Go to: Synopsis. Return value. Keywords. Related. Flags. Python examples.

Synopsis

selLoadSettings([activeProxy=string], [deferReference=boolean], [fileName=string], [numSettings=uint], [proxyManager=string], [proxySetFiles=string], [proxySetTags=string], [proxyTag=string], [referenceNode=string], [shortName=boolean], [unresolvedName=boolean])

Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.

selLoadSettings is NOT undoable, queryable, and editable.

This command is used to edit and query information about the implicit load settings. Currently this is primarily intended for internal use within the Preload Reference Editor. selLoadSettings acts on load setting IDs. When implict load settings are built for a target scene, there will be one load setting for each reference in the target scene. Each load setting has a numerical ID which is its index in a pre-order traversal of the target reference hierarchy (with the root scenefile being assigned an ID of 0). Although the IDs are numerical they must be passed to the command as string array. Example: Given the scene: 
        a
       / \
      b   c
         / \
        d   e
where: a references b and c c references d and e the IDs will be as follows: a = 0 b = 1 c = 2 d = 3 e = 4 selLoadSettings can be used to change the load state of a reference: whether it will be loaded or unloaded (deferred) when the target scene is opened. Note: selLoadSettings can accept multiple command parameters, but the order must be selected carefully such that no reference is set to the loaded state while its parent is in the unlaoded state. Given the scene: 
a
|
b [-]
|
c [-]
where: a references b b references c a = 0 b = 1 c = 2 and b and c are currently in the unloaded state. The following command will succeed and change both b and c to the loaded state: selLoadSettings -e -deferReference 0 "1" "2"; whereas the following command will fail and leave both b and c in the unloaded state: selLoadSettings -e -deferReference 0 "2" "1"; Bear in mind that the following command will also change both b and c to the loaded state: selLoadSettings -e -deferReference 0 "1"; This is because setting a reference to the loaded state automatically sets all child references to the loaded state as well. And vice versa, setting a reference the the unloaded state automatically sets all child reference to the unloaded state.

Return value

stringFor query execution.

In query mode, return type is based on queried flag.

Keywords

selective, load, setting, preload, reference

Related

file

Flags

activeProxy, deferReference, fileName, numSettings, proxyManager, proxySetFiles, proxySetTags, proxyTag, referenceNode, shortName, unresolvedName
Long name (short name) Argument types Properties
activeProxy(ap) string createqueryedit
Change or query the active proxy of a proxy set. In query mode, returns the proxyTag of the active proxy; in edit mode, finds the proxy in the proxySet with the given tag and makes it the active proxy.
deferReference(dr) boolean createqueryedit
Change or query the load state of a reference.
fileName(fn) string createquery
Return the file name reference file(s) associated with the indicated load setting(s).
numSettings(ns) uint createquery
Return the number of settings in the group of implicit load settings. This is equivalent to number of references in the scene plus 1.
proxyManager(pm) string createquery
Return the name(s) of the proxy manager(s) associated with the indicated load setting(s).
proxySetFiles(psf) string createquery
Return the name(s) of the proxy(ies) available in the proxy set associated with the indicated load setting(s).
proxySetTags(pst) string createquery
Return the name(s) of the proxy tag(s) available in the proxy set associated with the indicated load setting(s).
proxyTag(pt) string createquery
Return the name(s) of the proxy tag(s) associated with the indicated load setting(s).
referenceNode(rfn) string createquery
Return the name(s) of the reference node(s) associated with the indicated load setting(s).
shortName(shn) boolean createquery
Formats the return value of the 'fileName' query flag to only return the short name(s) of the reference file(s).
unresolvedName(un) boolean createquery
Formats the return value of the 'fileName' query flag to return the unresolved name(s) of the reference file(s). The unresolved file name is the file name used when the reference was created, whether or not that file actually exists on disk. When Maya encounters a file name which does not exist on disk it attempts to resolve the name by looking for the file in a number of other locations. By default the 'fileName' flag will return this resolved value.
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.

Python examples

import maya.cmds as cmds

# Given the scene:
#
#
#        a [+]
#       /     \
#      b [-]   c [+]
#             /     \
#            d [-]   e [+]
#
# With the IDs:
#    a = 0
#    b = 1
#    c = 2
#    d = 3
#    e = 4
# set c, d, and e to the unloaded state
cmds.selLoadSettings( '2', '3', '4', e=True, deferReference=1 )
# this will also set c, d, and e to the unloaded state
cmds.selLoadSettings( '2', e=True, deferReference=1 )
# set b to the loaded state
cmds.selLoadSettings( '1', e=True, deferReference=0 )
# set b and d to the loaded state
cmds.selLoadSettings( '1', '3', e=True, deferReference=0 )