file

ジャンプ先: 概要. 戻り値. 関連項目. フラグ. Python 例.

概要

file( string , [activate=boolean], [activeProxy=boolean], [anyModified=boolean], [applyTo=string], [buildLoadSettings=boolean], [channels=boolean], [cleanReference=string], [command=[string, string]], [compress=boolean], [constraints=boolean], [constructionHistory=boolean], [copyNumberList=boolean], [defaultExtensions=boolean], [defaultNamespace=boolean], [deferReference=boolean], [editCommand=string], [errorStatus=boolean], [executeScriptNodes=boolean], [exists=boolean], [expandName=boolean], [exportAll=boolean], [exportAnim=boolean], [exportAnimFromReference=boolean], [exportAsReference=boolean], [exportAsSegment=boolean], [exportSelected=boolean], [exportSelectedAnim=boolean], [exportSelectedAnimFromReference= boolean], [exportSelectedNoReference=boolean], [exportUnloadedReferences=boolean], [expressions=boolean], [flushReference=string], [force=boolean], [groupLocator=boolean], [groupName=string], [groupReference=boolean], [i=boolean], [ignoreVersion=boolean], [importReference=boolean], [lastFileOption=boolean], [lastTempFile=boolean], [list=boolean], [loadAllDeferred=boolean], [loadAllReferences=boolean], [loadNoReferences=boolean], [loadReference=string], [loadReferenceDepth=string], [loadSettings=string], [location=boolean], [lockContainerUnpublished=boolean], [lockFile=boolean], [lockReference=boolean], [mapPlaceHolderNamespace=[string, string]], [mergeNamespacesOnClash=boolean], [modified=boolean], [moveSelected=boolean], [namespace=string], [newFile=boolean], [open=boolean], [options=string], [parentNamespace=boolean], [postSaveScript=string], [preSaveScript=string], [preserveName=boolean], [preserveReferences=boolean], [prompt=boolean], [proxyManager=string], [proxyTag=string], [reference=boolean], [referenceDepthInfo=uint], [referenceNode=string], [removeDuplicateNetworks=boolean], [removeReference=boolean], [rename=string], [renameAll=boolean], [renameToSave=boolean], [renamingPrefix=string], [renamingPrefixList=boolean], [replaceName=[string, string]], [resetError=boolean], [returnNewNodes=boolean], [save=boolean], [saveDiskCache=string], [saveReference=boolean], [saveReferencesUnloaded=boolean], [saveTextures=string], [sceneName=boolean], [segment=string], [selectAll=boolean], [shader=boolean], [sharedNodes=string], [sharedReferenceFile=boolean], [shortName=boolean], [strict=boolean], [swapNamespace=[string, string]], [type=string], [uiConfiguration=boolean], [unloadReference=string], [unresolvedName=boolean], [usingNamespaces=boolean], [withoutCopyNumber=boolean], [writable=boolean])

注意: オブジェクト名や引数を表す文字列はカンマで区切ります。これは概要には示されていません。

file は 「元に戻す」が可能、「照会」が可能、「編集」が可能 です。

• 追加の詳細事項:
• 通常は file コマンドでファイル名を引数として指定しますが、ファイル名が指定されていない場合は、ルートのシーンが使用されます。
• 詳細と制限事項については、各フラグの説明を参照してください。

戻り値

戻り値の型は照会モードでは照会フラグが基になります。

関連項目

フラグ

ロング ネーム（ショート ネーム）	引数型	プロパティ
activeProxy(ap)	boolean
このフラグは、ファイル リファレンス中の内部使用に限られます。リファレンス フラグと一緒に使用して、ファイルがロードされるときにアクティブ プロキシになるファイルを指定します。また、referenceDepthInfo フラグと一緒に使用して、プリロード情報を参照するファイルでアクティブ プロキシになるファイルを指定します。
anyModified(amf)	boolean
これは照会専用フラグです。メモリ常駐ファイルのいずれかで保存を実行する必要がある場合は、1 が返されます。
buildLoadSettings(bls)	boolean
「o/open」フラグと一緒に使用すると、指定したファイルが階層情報を参照するためにだけ読み込まれるよう指定します。 この情報は、「mplicitLoadSettings」という名前で一時的なロード設定に格納されます。このフラグを使用すると、指定したシーン ファイルがロードされません。つまり、オブジェクトやノードが作成されたり変更されたりすることはありません。 注: ほとんどの場合、このフラグまたはこのフラグから作成される「implicitLoadSettings」を使用する必要はありません。ファイル > シーンを開く（File > Open）で表示される開くオプション ウィンドウで「選択的プリロード（Selective Load）」オプションを設定すれば、同じ機能にアクセスできます。
command(c)	[string, string]
ファイル操作の前に実行するコールバックを指定します。 これはファイル フォーマットでのみ使用される内部フラグです。
constructionHistory(ch)	boolean
exportSelected と一緒に使用し、アタッチされたコンストラクション ヒストリをエクスポートに含めるかどうかを指定します。
channels(chn)	boolean
exportSelected と一緒に使用し、アタッチされたチャンネルをエクスポートに含めるかどうかを指定します。
copyNumberList(cnl)	boolean
照会すると、このフラグは、ファイルが使用される各インスタンスを固有に識別する番号を含む文字配列を返します。
constraints(con)	boolean
exportSelected と一緒に使用し、アタッチされたコンストレインをエクスポートに含めるかどうかを指定します。
cleanReference(cr)	string
渡されるリファレンス ノードから編集箇所を削除します。 リファレンスはアンロードされた状態にしてください。特定タイプの編集箇所を削除するには、editCommand フラグを使用します。フラグを指定しない場合は、すべての編集箇所が削除されます。
editCommand(ec)	string
cleanReference と一緒に使用します。指定したタイプの編集箇所だけを削除します。 サポートされている編集は、setAttr、addAttr、deleteAttr、connectAttr、disconnectAttr と parent です。
defaultExtensions(de)	boolean
デフォルトの拡張子を使って、ファイルの名前を変更します。 このデフォルトは true ですが、指定された Maya のセッション内では設定が持続されます。つまり、これを true または false に設定すると、新しい値が設定されるまでその値がその後のファイル コマンドでも継続して使用されます。
defaultNamespace(dns)	boolean
デフォルトのネームスペースを使用して、インポートと参照を行います。これは詳細設定オプションです。設定してからインポートまたは参照を行うと、Maya はネーム クラッシュの解決アルゴリズムを呼び出さずに、インポートまたは参照されたファイルのすべてのノードをルート（デフォルト）のネームスペースに直接配置しようとします。ルート ネームスペースに新規オブジェクトのいずれかの名前が存在する場合、エラーが発生します。 このフラグを使用する場合、ネーム クラッシュなどのエラーを避けるため、Maya 以外でネーム クラッシュ アルゴリズムの手段を作成します。注: このフラグで想定されているのは、API によって記述されたカスタム ファイル トランスレータと一緒に使用する場合だけです。ユーザの責任で使用してください。
errorStatus(err)	boolean
最後のファイル読み込みのエラー ステータスを照会します。最後のファイル読み込み中にエラーが発生した場合に true を返します。
deferReference(dr)	boolean
-reference フラグと組み合わせて使用すると、このフラグによって、リファレンスをロードするか、またはロードを保留するかどうかが決まります。 C: デフォルトは false です。 Q: 照会すると、リファレンスを保留する場合は true 、保留しない場合は false を返します。-rfn/referenceNode と一緒に使用する場合は、-rfn フラグを -q フラグよりも前に置く必要があります。
exportAll(ea)	boolean
すべての項目を単一のファイルにエクスポートします。 エクスポートされたファイルの名前を返します。
exportAnim(ean)	boolean
シーン内のすべてのオブジェクトのすべてのアニメーション ノードとアニメーション ヘルパ ノードをエクスポートします。 生成されたアニメーションのエクスポート ファイルには、アニメーション ファイルには含まれていないオブジェクトへのコネクションが含まれています。このため、このファイルをインポートまたは参照するには、同じ名前のオブジェクトが表示されるように指定する必要があります。そうしないと、エラーが発生します。 -sns/swapNamespace フラグは、指定したオブジェクトのネームスペースを別のネームスペースと入れ替えるために使用できます。このネームスペースは、一貫した命名規則を使用してアニメーション ファイルの対象を複数にするために利用できます。 exportAnim フラグではアニメーション レイヤはエクスポートされません。animLayers およびその他のタイプのノードの一般的なエクスポートについては、exportEdits コマンドを参照するか、レイヤのエクスポート（Export Layers）機能を使用してください。
exportSelectedAnim(eas)	boolean
シーン内の選択したオブジェクトからすべてのアニメーション ノードとアニメーション ヘルパ ノードをエクスポートします。アニメーション ファイル使用の詳細については、-ean/exportAnim フラグの説明を参照してください。
exportAnimFromReference( ear)	boolean
すべてのリファレンス オブジェクトからメイン シーンのアニメーション ノードとアニメーション ヘルパ ノードをエクスポートします。-rfn/referenceNode フラグと組み合わせて使用すると、指定したリファレンス ファイルからアニメーション ノードだけをエクスポートするように制限できます。アニメーション ファイル使用の詳細については、-ean/exportAnim フラグの説明を参照してください。
exportAsReference(er)	boolean
選択したオブジェクトに特定の名前を付けてリファレンス ファイルにエクスポートします。ファイルはプロセス中にディスクに保存されます。 作成されたリファレンスの名前を返します。
exportSelected(es)	boolean
選択したオブジェクトを指定したファイルにエクスポートします。 エクスポートされたファイルの名前を返します。
exportSelectedAnimFromReference( esa)	boolean
選択したリファレンス オブジェクトからメイン シーンのアニメーション ノードとアニメーション ヘルパ ノードをエクスポートします。-rfn/referenceNode フラグと組み合わせて使用すると、指定したリファレンス ファイルの選択したノードから、アニメーション ノードだけをエクスポートするように制限できます。アニメーション ファイル使用の詳細については、-ean/exportAnim フラグの説明を参照してください。
executeScriptNodes(esn)	boolean
true の場合、適切なスクリプト ノードで実行できます。false の場合、スクリプト ノードのスクリプトでは実行できません。 詳細については、script ノードのマニュアルを参照してください。 デフォルト: true。
exists(ex)	boolean
ファイルが存在するかどうかを照会します。ファイルが存在する場合、true を返します。
expandName(exn)	boolean
これは、ファイルのファイル パス名を照会するために利用できる照会専用フラグです。
expressions(exp)	boolean
exportSelected と一緒に使用し、アタッチされたエクスプレッションをエクスポートに含めるかどうかを指定します。
force(f)	boolean
アクションを強制的に実行させます （新規作成、オープン、保存）。
flushReference(fr)	string
このフラグは、渡されたリファレンス ノードに関連するリファレンス ファイルをアンロードし、関連するすべてのリファレンス ノードとシーン ファイルを維持します。**このオプションは、ネームスペースを使用しているときのみ有効です。** 詳細: このフラグは、主にカスタム アセット管理システムの一部として使用するように想定されています。このフラグは、子リファレンスを含むリファレンスのロードを、子リファレンスに関する情報を消失することなく保留するために使用できます。子リファレンスを含むフラッシュ済みリファレンスをリロードする前には、子の Maya ASCII ファイルから「createNode reference」の行を手動で削除してください。この処理を行わないと、余分なリファレンス ノードが作成されます。
groupLocator(gl)	boolean
-r フラグと -gr フラグと一緒にしか使用しません。 groupReference の出力をロケータの下にグループ化するために使用します。
groupName(gn)	string
-gr フラグと一緒にしか使用しません。 オプションとして、インポートまたは参照した項目をグループ化するトランスフォームの名前を設定するために使用します。
groupReference(gr)	boolean
-r または -i フラグと一緒にしか使用しません。 単一のトランスフォームでインポートまたは参照されたすべての項目をグループ化するために使用されます。
ignoreVersion(iv)	boolean
正式にサポートされているバージョンより前または後のバージョンのファイルを開くために使用します。 データの損失、破損、またはオープン失敗などの可能性はありますが、できる限り正常に読み込もうとします。-o フラグと一緒に使用する必要があります。
lockReference(lck)	boolean
リファレンス ファイルのアトリビュートとノードをロックします。
lockFile(lf)	boolean
メインのシーンをロックまたはロック解除します。このシーンを参照するすべてのファイルは、すべてのアトリビュートとノードを自動的にロックします。また、編集済みのリファレンスが親ファイルから保存されないようにします。
lockContainerUnpublished( lcu)	boolean
このファイルにあるすべてのコンテナに対してパブリッシュ解除のロック状態を設定します。これでメイン シーンのアトリビュートが直接ロックされることはありませんが、このシーンを参照する任意のファイルによって、コンテナのすべてがパブリッシュ解除のロック済みとなります。
i(i)	boolean
指定したファイルをインポートします。 インポートされたファイルの名前を返します。
importReference(ir)	boolean
指定したファイル内でデータの周りのリファレンスのカプセル化を削除します。これにより指定したファイルの内容がカレント シーンの一部となり、オリジナル ファイルのすべてのリファレンスが失われます。 インポートされたリファレンスの名前が返されます。
list(l)	boolean
すべてのファイルをリスト表示します。 すべてのセグメント/リファレンス ファイルの名前を文字配列で返し、複製は削除します。つまり、ファイルが複数回参照され、-withoutCopyNumber フラグを設定している場合は、シーン内で 1 度リスト表示されます。
loadReferenceDepth(lrd)	string
ロードするリファレンスを指定するために使用します。有効なタイプは「all」、「none」、「topOnly」で、それぞれ、すべてのリファレンスのロード、リファレンスをロードしない、最上位のリファレンスのみロードを指定します。-open、-import、-reference、-loadReference フラグと一緒に使用する必要があります。「none」 を -loadReference と一緒に使用すると、パス認証のみが実行されます。これを使用すると、リロードをトリガせずにリファレンスを置き換えることができます。
mergeNamespacesOnClash( mnc)	boolean
同名のネームスペースがすでにある場合に、-import または -reference フラグと一緒に使用して 新しいネームスペースが作成されないようにします。たとえば、インポートするファイルが「ref:pSphere1」を参照しているのに、すでに「ref」 という名前のネームスペースが定義されているとします。-mergeNamespacesOnClash が true の場合、既存の ref というネームスペースは再利用されて pSphere1 はこの既存のネームスペースに移動します。-mergeNamespacesOnClash が false の場合、 新しいネームスペースが作成されて（この例では「ref1"） pShere1 は ref1 という ネームスペースに移動します。デフォルト値は false です。
loadAllDeferred(lad)	boolean
このフラグはサポートしていません。loadReferenceDepth フラグに置き換えられました。-open フラグと一緒に使用して、ファイルで読み込み中に -deferReference フラグが機能するかどうかを定義します。true が渡されると、すべてのリファレンスがロードされます。false が渡されると、-deferReference フラグが機能します。
loadAllReferences(lar)	boolean
このフラグはサポートしていません。loadReferenceDepth フラグに置き換えられました。-open フラグと一緒に使用すると、すべてのリファレンスがロードされます。
loadNoReferences(lnr)	boolean
このフラグはサポートしていません。loadReferenceDepth フラグに置き換えられました。-open フラグと一緒に使用すると、リファレンスがロードされません。-import、-reference、-loadReference フラグと一緒に使用すると、最上位のリファレンスのみがロードされます。
location(loc)	boolean
特定のファイル名の場所を照会します。
loadReference(lr)	string
このフラグは、ファイルをロードして渡されたリファレンス ノードにコネクトします。リファレンス ノードが存在しない場合、このコマンドは失敗します。ファイルがすでにロードされている場合、同じファイルがリロードされます。 ファイルが指定されない場合、このコマンドは最後に使用されたリファレンス ファイルをロード（リロード)します。
loadSettings(ls)	string
「o/open」フラグと一緒に使用すると、このフラグはどのリファレンス ロード設定を使用するかを指定します。リファレンス ロード設定では、どのリファレンスをロードしてどのリファレンスをアンロードするかを指定します。アンロードされるリファレンス ファイルは、通常、Maya で読み込んだり解釈したりする必要はありません。これによって、Maya がシーン全体のロードに要する時間を短縮できる可能性があります。 「ls/loadSettings」フラグが指定されなかったか、または、フラグ引数として空の文字列（「」）を使用した場合は、デフォルトのロード設定が使用されます。デフォルトのロード設定は、ファイルが最後に保存されたときのすべてのリファレンスの状態を示します。ロード設定「implicitLoadSettings」は、「bls/buildLoadSettings」フラグで生成されて「loadSettings」コマンドを使って編集された一時的なロード設定を参照します。 現在は、デフォルトで暗黙のロード設定がサポートされています。
lastTempFile(ltf)	boolean
照会されると、このフラグはファイルの保存中に使用された一時的なファイル名を返します。保存に失敗すると、一時的なファイルは同じディレクトリにこのファイル名で残されます。
modified(mf)	boolean
ファイルの変更状態を設定します。変更されたファイルは、新しいファイルを開閉する前に、保存しておく必要があります。オブジェクトが作成または修正されるたびにファイルの状態が自動に更新されるため、通常はこのフラグを編集する必要はありません。 状態を編集する場合、以下の例に示されるように、編集フラグを使用せずに実行されます。 照会モードでは、ファイルが修正されていると 1 を返します。それ以外は 0 が返されます。
newFile(new)	boolean
シーンを初期化します。 無題のシーンがデフォルト位置で返されます。
namespace(ns)	string
インポートと参照中に、すべてのオブジェクトをグループ化するために使用されるネームスペース名です。 指定したリファレンス ファイルのすべてのオブジェクトをグループ化するために使用されるネームスペースを変更します。リファレンスは「Using Namespaces」オプションで作成し、ロードしておく必要があります。既存のネームスペースに含まれる参照されないノードも新しいネームスペースに移動されます。このコマンドでは新しいネームスペースが作成されます。既に存在するネームスペースを使用することはできません。古いネームスペースは削除されます。
open(o)	boolean
指定したファイルを開きます。 開いたファイルの名前を返します。
options(op)	string
現在設定されているファイル オプションを設定/照会します。
lastFileOption(lfo)	boolean
照会の場合、ファイル コマンドが最後に使用したオプション文字列を返します。
prompt(pmt)	boolean
このフラグはダイアログを要求するファイルの表示をコントロールします。 ダイアログを要求するファイルの例としては、ユーザによる確認や見つからないファイルの参照ダイアログを要求するエラー メッセージが挙げられます。一度このフラグが使用されると、ファイル コマンドのすべてのインスタンスはこのフラグで最後に設定された値を使用します。 一部のインタラクティブなファイル操作では、フラグが false に設定されていてもダイアログを表示するものがありますが、作成されたファイル コマンドの場合、このフラグが false に設定されていればダイアログを表示することはありません。デフォルト値は true です。
parentNamespace(pns)	boolean
リファレンス ファイルの親ネームスペースの名前を返します。
preserveReferences(pr)	boolean
import フラグまたは export フラグと一緒に使用すると、このフラグはインポータまたはエクスポータに、リファレンスをコピーではなくリファレンスとしてインポートまたはエクスポートするように通知します。
exportUnloadedReferences( eur)	boolean
preserveReferences の使用時のみ有効です。 exportAll フラグと一緒に使用すると、エクスポータに対してアンロード されたリファレンスをすべてエクスポートするよう通知されます。 exportSelected フラグと一緒に使用すると、エクスポータに対して 選択されたノードに関連するアンロードされたプロキシ リファレンスを すべてエクスポートするよう通知されます。
preSaveScript(prs)	string
save フラグと一緒に使用すると、ファイルを保存する前に、指定したスクリプトが実行されます。
postSaveScript(pos)	string
save フラグと一緒に使用すると、ファイルを保存した後に、指定したスクリプトが実行されます。
proxyManager(pm)	string
1 つまたは複数のプロキシ リファレンスを既存のファイル リファレンスに追加する場合に、プロキシ管理ノードを使用してそのリファレンスにコネクトされたプロキシを定義します。このフラグは activeProxy フラグと proxyTag フラグと一緒に使用して、目的の proxyManager を指定します。また、referenceDepthInfo フラグと一緒に使用して、プリロード情報を参照するファイルでプロキシ リファレンスの proxyManager を指定します。
proxyTag(pt)	string
このフラグはファイルのロードまたはプリロード中の内部使用に限られます。プロキシ タグは、プロキシ リファレンスをリファレンス エディタから管理しやすいように、プロキシ リファレンスに割り当てる名前です。プロキシ タグは指定したプロキシ セット内で固有です。このフラグは proxyManager フラグと組み合わせて使用する必要があります。
reference(r)	boolean
指定したファイルにリファレンスを作成します。ファイル リファレンスの名前を返します。 指定したファイルからすべてのファイル リファレンスを照会します。
renameAll(ra)	boolean
-import でのみ利用可能です。 true の場合、既存のノードとクラッシュする名前のノードだけでなく、新たに作成されたすべてのノードの名前を変更します。 -import でのみ利用可能です。
referenceDepthInfo(rdi)	uint
このフラグを使用して Maya ASCII ファイル（.ma）とコネクトされているプリファレンスをロードするリファレンスを格納します。このフラグは、ファイルの読み取り/書き出し中のみに使用されます。必要なければ、使用しなくても構いません。
referenceNode(rfn)	string
照会すると、このフラグはファイルに関連するリファレンス ノードの名前を返します。ファイルがリファレンスでないか、リファレンス ノードが含まれていない場合、空の文字列が返されます。 このフラグは照会モードでは値を受け入れます。
rename(rn)	string
シーンの名前を変更します。 ほとんどの場合、保存中に saveAs の名前を設定するときに使用されます。 シーンの新しい名前を返します。
returnNewNodes(rnn)	boolean
開く、インポート、loadReference、とリファレンス操作の戻り値を制御するために使用します。カレント シーンに追加された新規ノードのリストを返す file コマンドを強制的に発行させます。
renamingPrefixList(rpl)	boolean
このフラグはファイルが使用するすべての名前変更プリフィックスのリストを返します。
renamingPrefix(rpr)	string
このファイルのすべてのオブジェクトのプリフィックスとして使用される文字列です。 このフラグは -ns/namespace に置き換えられました。
removeReference(rr)	boolean
指定したファイル リファレンスを親から削除します。これにより、このファイルが参照するすべての項目も削除されます。 削除されたファイルの名前を返します。
renameToSave(rts)	boolean
true の場合、シーンを保存する前に、この名前を変更する必要があります。照会すると、このフラグは、シーンを保存する前に名前を変更する必要がある場合に、true を返します。 デフォルトは false です。
save(s)	boolean
指定したファイルを保存します。 保存されたファイルの名前を返します。
saveReference(sr)	boolean
リファレンス ノードの編集箇所とリファレンス ファイルへのコネクションを保存します。 新たに追加されたヒストリやアニメーションが保存中のリファレンスの外部のオブジェクトに適用されていない場合は、これらも保存対象となります。
compress(cmp)	boolean
保存で使用すると、ファイルを圧縮（gzip）して出力します。
preserveName(pn)	boolean
圧縮で使用すると、.gz をアペンドせずに、通常の拡張子を保持します。
removeDuplicateNetworks( rdn)	boolean
これを設定すると、インポートされたネットワークと同じネットワークがカレント シーンで検出された場合に、インポートされたネットワークを削除します。このフラグは、import フラグと一緒に使用した場合のみに使用できます。
resetError(rer)	boolean
既存のグローバル ファイル エラーをすべてオフにします。
selectAll(sa)	boolean
このファイルと子ファイルのすべてのコンポーネントを選択します。指定するファイルは、この Maya セッションですでに開かれているファイルでなければならない点に注意してください。
saveDiskCache(sdc)	string
このフラグはジグル ディスク キャッシュの saveAs オプションを設定します。 有効な入力値は次の 2 つです。「always」- 常にファイル テクスチャを新しい位置にコピーする。「never」- まったくコピーしない。 C: デフォルトは「always」です。 Q: 照会すると、文字列（「always」、「never」）を返します。
shader(sh)	boolean
exportSelected と一緒に使用し、アタッチされたシェーダをエクスポートに含めるかどうかを指定します。
sharedNodes(shd)	string
このフラグは「-r/-reference」フラグを変更して、リファレンス内の特定タイプのノードを共有ノードとして扱うようにします。共有ノードはすべてデフォルトのネームスペースに配置されます。コピーがすでにデフォルトのネームスペースにある場合は、共有ノードのコピーは新しく作成されません。代わって共有ノードと既存のノードがマージされます。2 つのノードをマージする場合の動作は、ノード タイプによって異なります。一般的には、アトリビュート値はマージされない、つまり、既存の共有ノードの値セットが保持され、マージされるノードの値は無視されます。 有効なオプションは、「displayLayers」、「shadingNetworks」、「renderLayersByName」、「renderLayersById」です。このフラグは多目的に使用できます。つまり複数回指定して、たとえばディスプレイ レイヤとシェーディング ネットワークの両方を共有することができます。2 つのシェーディング ネットワークは、同一の場合のみマージされます。 つまり、1 つのシェーディング グループに属するノードのネットワークを、名前とタイプが同じ等価のノードと同じように配置する必要があります。また、ネットワークがアニメートされていたり、DAG オブジェクトまたはエクスプレッションが含まれる場合は、マージできません。 このフラグは -srf/sharedReferenceFile と組み合わせて使用することはできません。
shortName(shn)	boolean
メインの照会フラグと一緒に使用すると、返されるファイル名がショート ネーム（ディレクトリ パスを除いてファイル名だけにした名前）になるように指定します。このフラグが存在しない場合、フル ネームとディレクトリ パスを返します。
sceneName(sn)	boolean
カレント シーンの名前を返します。
swapNamespace(sns)	[string, string]
-r/reference フラグまたは -i/import フラグと組み合わせる場合にしか使用できません。このフラグは、指定したネームスペースをすべて、代替として指定したネームスペースに置き換えます。このネームスペースの「入れ替え」は、ファイルが参照されたときに発生します。このフラグは 2 つの文字列引数を取ります。最初の引数は置き換えるネームスペースを指定します。2 番目の引数は、代替ネームスペースを指定します。このフラグは暗黙的にネームスペースの使用を可能にし、deferReference と一緒に使用することはできません。
sharedReferenceFile(srf)	boolean
-r/reference フラグと -ns/namespace フラグとの組み合わせでのみ使用できます（プリフィックスはサポートしません）。このフラグは「-r/-reference」フラグを修正して、そのリファレンス内のすべてのノードが共有ノードとして扱われるようにします。すでにコピーが存在する場合は、そのノードの新しいコピーは作成されません。その代わりに、共有ノードは既存のノードにマージされます。2 つのノードをマージする場合の動作は、ノード タイプによって異なります。 このフラグは -shd/sharedNodes とは一緒に使用できません。
saveReferencesUnloaded( sru)	boolean
このフラグは、save フラグと一緒に使用した場合のみに使用できます。これはアンロードされたすべてのリファレンスもファイルと一緒に保存するように指定します。
strict(str)	boolean
厳密なファイル パスの解決を設定します。true にすると、相対パスと絶対パスの両方とも、すべてのパスを正確に一致させます。相対パスは、プロジェクトのルート ディレクトリからの相対位置とみなされます。-open、-import、-importReference、-reference と一緒に使用する必要があります。
saveTextures(stx)	string
このフラグは、3D ペイント ファイル テクスチャの saveAs オプションを設定します。 有効な入力値は次の 3 つです。「always」- 常にファイル テクスチャを新しい位置にコピーします。「unlessRef」- リファレンス ファイル テクスチャでない場合にのみコピーします。「never」- まったくコピーしません。 C: デフォルトは「unlessRef」です。 Q: 照会すると、文字列（「always」、「unlessRef」、「never」）を返します。
type(typ)	string
このファイルのタイプを設定します。デフォルトでは、以下のいずれかになります。 「mayaAscii」、「mayaBinary」、「mel」、「OBJ」、「directory」、「plug-in」、「audio」、「move」、「EPS」、「Adobe(R) Illustrator(R)」、「image」のプラグインは、独自のタイプも定義することがあります。 このファイルと一致するファイル タイプの文字配列を返します。
uiConfiguration(uc)	boolean
uiConfiguration スクリプト ノードにシーンと一緒に UI 設定を保存します（たとえば、panes）。現在のデフォルトはオンで、initialStartup.mel に設定されます。
usingNamespaces(uns)	boolean
ブーリアンを返します。 指定したリファレンス ファイルがネームスペースまたは名前変更プリフィックスを使用するかどうかを照会します。
unresolvedName(un)	boolean
このフラグをメインの照会フラグと一緒に使用すると、返されるファイル名が未解決になるように指定します（つまり、ファイルが Maya にロードされたときに指定したパス名になります。このパスは環境変数を含み、ディスクに存在しない場合があります）。このフラグが存在しない場合、解決済みの名前を返します。
unloadReference(ur)	string
このフラグは、渡されたリファレンス ノードに関連するリファレンス ファイルをアンロードします。
writable(w)	boolean
カレント シーンで特定のファイルが書き込み可能かどうかを照会します。メインのシーン ファイルの場合、これはカレント ユーザによってファイル システムへの書き込みが可能であることを意味します。メインのシーン ファイルによって参照されるファイルの場合、常に書き込みは不可能です（リファレンス ファイルは元々読み取り専用です）。カレント シーンにないファイルは、常に false を返します。
withoutCopyNumber(wcn)	boolean
このフラグをメインの照会フラグと一緒に使用すると、返されるファイル名の末尾にコピー番号がアペンドされないように指定します。このフラグが存在しない場合、返されたファイル名の最後にコピー番号がアペンドされることがあります。
segment(seg)	string
このフラグは現在サポートしていません。
activate(a)	boolean
このフラグは現在サポートしていません。
exportAsSegment(exs)	boolean
このフラグは現在サポートしていません。
exportSelectedNoReference( esr)	boolean
このフラグは現在サポートしていません。
moveSelected(ms)	boolean
このフラグは現在サポートしていません。
applyTo(at)	string
オフライン編集ファイルのインポート時または参照時に、それを指定のリファレンスに適用します（<main> のマップ先を決定します）。 このため、リファレンス ノード名を指定します。メイン シーン（ルート ネームスペース）のノードに編集を適用するには、「:」で渡します。 ファイル -i/-import または -r/-reference フラグと一緒に使用する必要があります。
mapPlaceHolderNamespace( mns)	[string, string]
指定したリファレンスに placeHolderNamespace をマッピングします。作成モードで、ファイルの -i/-import と -r/-reference フラグと一緒に使用する必要があります。 1 番目の文字列はプレース ホルダのネームスペースで山括弧（例：<foo>）を含みます。2 番目の文字列はリファレンス ノードで、そのネームスペースはマップ先（例：refRN）を示します。ネームスペースのマップ先がルートのネームスペースである場合は、「:」を使用します。
replaceName(rep)	[string, string]
検索/置換文字列を定義します。検索/置換はリーフ ノード名に適用します。検索文字列には、ネームスペースとワイルドカードを含めることができますが、DAG 階層のリーフ ノードにのみ適用できます。オフラインの編集ファイルと併用します。-import/-i ファイル または -reference/-r ファイルと併用する必要があります。また、ネストしたリファレンスが代入を定義する場合は、ネストしたリファレンスのロード時にアクティブな代入テーブルになります。 注: -edit/-e フラグと併用する場合、置換は次にリファレンスをロードする際にのみ適用されます。 サンプル: -replace "*pCube1" "prop" will change "foo:pCube1" to "foo:prop" and "|A:pCube1|B:pCube1" to "|A:pCube1|prop".

: コマンドの作成モードで使用可能なフラグ	: コマンドの編集モードで使用可能なフラグ
: コマンドの照会モードで使用可能なフラグ	: タプルまたはリストとして渡された複数の引数を持てるフラグ

Python 例

import maya.cmds as cmds

# save the current scene to an ascii file named "fred.ma"
#
cmds.file( rename='fred.ma' )
cmds.file( save=True, type='mayaAscii' )

# save the current scene to an ascii file without the ".ma" extension
#
cmds.file( rename='tmp' )
cmds.file( save=True, de=False, type='mayaAscii' )

# open the file fred.ma, using the default load settings. Any references will
# be brought in in the same state they were in when fred.ma was last saved.
#
cmds.file( 'fred.ma', o=True )

# reference the file wilma.ma
#
cmds.file( 'C:/mystuff/wilma.mb', r=True )

# reference the file barney.mb into a namespace called "rubble".
#
cmds.file( 'C:/maya/projects/default/scenes/barney.ma', r=True, type='mayaAscii', namespace='rubble' )

# change the namespace containing barney.mb.
#
cmds.file( 'C:/maya/projects/default/scenes/barney.ma', e=True, namespace='purpleDinosaur' )

# retrieve a string array of all files referenced in the scene
#
cmds.file( q=True, l=True )
# Result: C:/maya/projects/default/scenes/fred.ma C:/mystuff/wilma.mb C:/maya/projects/default/scenes/barney.ma

# Select "betty" and export betty to a separate file called "betty.mb".
# Reference the new betty file into this scene, replacing the
# previous betty object from this scene with the reference to betty.
#
cmds.file( 'c:/mystuff/betty.mb', type='mayaBinary', namespace='rubble', er=True )

# Select all the objects associated with file betty.mb
#
cmds.file( 'c:/mystuff/betty.mb', sa=True )
# Result: rubble:betty

# Remove the reference file betty.mb. All nodes in betty.mb will
# be removed from the scene
cmds.file( 'c:/mystuff/betty.mb', rr=True )

# Query whether the file named "foo.mb" exists on disk
#
cmds.file( 'foo.mb', q=True, ex=True )
# Result: 0 #

# Query whether the reference node "rubble:betty is deferred loaded.
# Note, -rfn flag has to come before -q flag.
cmds.file(rfn='rubbleRN', q=True, dr=True )

# Query the last temp file during file save
#
cmds.file( query=True, lastTempFile=True)

####################################/
#/   Example for the '-buildLoadSettings' and '-loadSettings' flags  #/
####################################/

# Build load settings for "ref.ma"
cmds.file( 'ref.ma', o=True, buildLoadSettings=True )
# Edit those settings, to indicate that some reference should
# be brought in unloaded.
# Note: the following command is primarily intended for internal
# use. It may not be easy to determine the numeric ID of a given
# reference ("2" in this case) .
# cmds.loadSettings( '2', deferReference=1 )
# Use the edited settings when opening the file
cmds.file('ref.ma', o=True, loadSettings='implicitLoadSettings')

#
#   Example for the '-cleanReference' and '-editCommand' flags
#

# Create a simple reference to a sphere
#
cmds.file( f=True, new=True )
cmds.polySphere()
cmds.file( rename='ref.ma' )
cmds.file( f=True, type='mayaAscii', save=True )
cmds.file( f=True, new=True )
cmds.file( 'ref.ma', r=True, ns='ref' )

# Scale the sphere
#
cmds.setAttr( 'ref:pSphere1.s', 5, 5, 5 )
cmds.getAttr( 'ref:pSphere1.s' )
# Result: 5 5 5 #

# The 'cleanReference' and 'editCommand' flags only work on
# unloaded references.
#
cmds.file( unloadReference='refRN' )

# Query the setAttr edits:
#
cmds.reference( rfn='refRN', q=True, editCommand=True )
# Result: setAttr ref:pSphere1.s -type "double3" 5 5 5 setAttr ref:lightLinker1.lnk -s 2 #

# Remove all setAttr edits on refRN:
#
cmds.file( cleanReference='refRN', editCommand='setAttr' )
cmds.reference( rfn='refRN', q=True, editCommand=True )
# Note that nothing is returned

cmds.file( loadReference='refRN' )

cmds.getAttr( 'ref:pSphere1.s' )
# Result: 1 1 1 #
# Note that scale has returned to 1 1 1

# apply the edit file to a reference
cmds.file("translateSphere.editMA", r=True, applyTo="refRN")
# Result: maps <main> to refRN's namespace

# apply the edit file to nodes in the main scene
cmds.file("translateSphere.editMA", i=True, applyTo=":")
# Result: maps <main> to the root namespace

# apply the edit file to a reference, but it also has connections between two refs
cmds.file("connectionsBetweenRefs.editMA", r=True, applyTo="refRN", mapPlaceHolderNamespace=("<otherRef>", "otherRefRN"))
# Result: maps <main> to refRN's namespace and <otherRef> to otherRefRN's namespace

# Change the modified state of the file.
cmds.file(modified=True)