移動先: 概要 戻り値 キーワード. 関連項目. フラグ. MEL 例.
selLoadSettings [-activeProxy string] [-deferReference boolean] [-fileName string] [-numSettings uint] [-proxyManager string] [-proxySetFiles string] [-proxySetTags string] [-proxyTag string] [-referenceNode string] [-shortName] [-unresolvedName]
selLoadSettings は 「元に戻す」が不可能、「照会」が可能、「編集」が可能 です。
このコマンドを使用して、暗黙的なロード設定に関する情報を編集と照会します。これは現在、主にプリロード リファレンス エディタ（Preload Reference Editor）での内部的な使用が目的です。selLoadSettings はロード設定 ID に作用します。ターゲット シーンに暗黙的なロード設定が構築される場合、ターゲット シーンのリファレンスごとに 1 つのロード設定が存在します。各ロード設定は、ターゲット リファレンス階層の先行順走査のインデックスである数値 ID を持ちます（ルート シーン ファイルの ID には 0 が割り当てられます）。ID は数値数字で表しますが、文字配列としてコマンドに渡す必要があります。
例:
シーン例:
a
/ \
b c
/ \
d e
条件:
a は b と c を参照し、
c は d と e を参照する場合、
ID は次のとおりになります。
a = 0
b = 1
c = 2
d = 3
e = 4
selLoadSettings を使用して、リファレンスのロード状態（ターゲット シーンを開くときに、リファレンスをロードするかアンロードする（据え置く）か）を変更できます。
注: selLoadSettings には複数のコマンド パラメータを指定できますが、親リファレンスがアンロード状態の場合に子リファレンスがロード状態に設定されていないよう、順序を慎重に選択する必要があります。
シーン例:
a
|
b [-]
|
c [-]
条件:
a は b を参照し、
b は c を参照する場合、ID は
a = 0
b = 1
c = 2
となり、b と c はアンロードされた状態です。
次のコマンドを実行すると成功し、b と c をロードされた状態に変更します。
selLoadSettings -e -deferReference 0 "1" "2";
一方、次のコマンドを実行すると失敗し、b と c はアンロード状態のままになります。
selLoadSettings -e -deferReference 0 "2" "1";
次のコマンドも b と c をロードされた状態に変更します。
selLoadSettings -e -deferReference 0 "1";
これは、リファレンスをロード状態に設定すると、すべての子リファレンスも自動的にロード状態に設定されるためです。逆にリファレンスをアンロード状態に設定すると、すべての子リファレンスも自動的にアンロード状態に設定されます。
戻り値の型は照会モードでは照会フラグが基になります。
selective, load, setting, preload, reference
file
activeProxy, deferReference, fileName, numSettings, proxyManager, proxySetFiles, proxySetTags, proxyTag, referenceNode, shortName, unresolvedName
| ロング ネーム（ショート ネーム） |
引数型 |
プロパティ |
-deferReference(-dr)
|
boolean
|
  
|
|
|
-unresolvedName(-un)
|
|
|
|
fileName 照会フラグの戻り値をフォーマットし、リファレンス ファイルの未解決名を返します。未解決のファイル名は、ファイルがディスク上に存在するかどうかに関わらず、リファレンスが作成されたときに使用されるファイル名です。Maya はディスクに存在しないファイル名を発見すると、ファイルが他の場所にあるかどうかを検索し、その名前の解決を試みます。デフォルトでは、fileName フラグは解決された値を返します。
|
|
-shortName(-shn)
|
|
|
|
fileName 照会フラグの戻り値をフォーマットし、リファレンス ファイルのショート ネームのみを返します。
|
|
-fileName(-fn)
|
string
|
|
|
指定したロード設定にコネクトされたファイル名のリファレンス ファイルを返します。
|
|
-referenceNode(-rfn)
|
string
|
|
|
指定したロード設定にコネクトされたファイル名のリファレンス ノードを返します。
|
|
-proxyManager(-pm)
|
string
|
|
|
指定したロード設定にコネクトされたプロキシ マネージャの名前を返します。
|
|
-activeProxy(-ap)
|
string
|
|
|
プロキシ セットのアクティブ プロキシを変更または照会します。照会モードの場合、アクティブ プロキシの proxyTag を返します。編集モードの場合は、指定したタグの proxySet にあるプロキシを検出し、それをアクティブ プロキシにします。
|
|
-proxyTag(-pt)
|
string
|
|
|
指定したロード設定にコネクトされたプロキシ タグの名前を返します。
|
|
-proxySetTags(-pst)
|
string
|
|
|
指定したロード設定にコネクトされたプロキシ セットで、使用可能なプロキシ タグの名前を返します。
|
|
-proxySetFiles(-psf)
|
string
|
|
|
指定したロード設定にコネクトされたプロキシ セットで、使用可能なプロキシの名前を返します。
|
|
-numSettings(-ns)
|
uint
|
|
|
暗黙的なロード設定のグループにある設定の数を返します。これはシーンのリファレンスの数に 1 を足した数と同じです。
|
|
|
: コマンドの作成モードで使用可能なフラグ
|
: コマンドの編集モードで使用可能なフラグ
|
|
: コマンドの照会モードで使用可能なフラグ
|
: 1 つのコマンドで複数回使用可能なフラグ
|
// 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
selLoadSettings -e -deferReference 1 "2" "3" "4";
// this will also set c, d, and e to the unloaded state
selLoadSettings -e -deferReference 1 "2";
// set b to the loaded state
selLoadSettings -e -deferReference 0 "1";
// set b and d to the loaded state
selLoadSettings -e -deferReference 0 "1" "3";