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

概要

file( string , [activate=boolean], [activeProxy=boolean], [add=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], [loadReferencePreview=string], [loadSettings=string], [location=boolean], [lockContainerUnpublished=boolean], [lockFile=boolean], [lockReference=boolean], [mapPlaceHolderNamespace=[string, string]], [mergeNamespaceWithParent=boolean], [mergeNamespaceWithRoot=boolean], [mergeNamespacesOnClash=boolean], [modified=boolean], [moveSelected=boolean], [namespace=string], [newFile=boolean], [open=boolean], [options=string], [parentNamespace=boolean], [postSaveScript=string], [preSaveScript=string], [preserveName=boolean], [preserveReferences=boolean], [preview=boolean], [prompt=boolean], [proxyManager=string], [proxyTag=string], [reference=boolean], [referenceDepthInfo=uint], [referenceNode=string], [relativeNamespace=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 は、取り消し可能、照会可能、および 編集可能 です。

ファイルのオープン、読み込み、書き出し、参照、保存、名前変更を行う

このコマンドでは、1 つのメイン フラグで、実行するアクションを指定する必要があります。一部のメイン フラグには、そのアクションを修正するオプションの 2 次フラグが続くものもあります。

メインフラグを以下に示します。
cr ea ean ear eas er esa es
esn ex fr i ir l lr lrp
loc ltf mf new o op ot pmt
r rdi rn rr rts s sa sdx
st stx typ uc ur w

o/open は、次の 2 次フラグで修飾できます。
f lad lad lnr rnn

es/exportSelected は、次の 2 次フラグで修飾できます。
ch chn con exp sh

r/reference は、次の 2 次フラグで修飾できます。
dns dr gr gl gn mnc ns rfn rpr sns srf shd rnn

i/import は、次の 2 次フラグで修飾できます。
dns dr gr gn mnc pr ra rdn rnn rpr sns

n/news/save は、次の 2 次フラグで修飾できます。
f

er/exportAsReference は、次の 2 次フラグで修飾できます。
ns rpr

ea/exportAlles/exportSelected は、次の 2 次フラグで修飾できます。
f pr

ean/exportAnimeas/exportSelectedAnim は、次の 2 次フラグで修飾できます。
f

ear/exportAnimFromReferenceesa/exportSelectedAnimFromReference は、次の 2 次フラグで修飾できます。
f rfn

ファイルに関する情報を照会する

このコマンドは、実行する照会を指定する主要な照会フラグ 1 つと、その照会を修正するオプションの 2 次フラグを必要とします。

主要な照会フラグを以下に示します。
amf ch chn con dr err ex exn
exp l loc ltf mf ns op ot
pmt pns r rfn rpl rpr rts sdc
sh sn stx typ uc w

dr/deferReference は、次の 2 次フラグで修飾できます。
rfn

exn/expandNamel/listr/referencesn/sceneName は、次の 2 次フラグで修飾できます。
un shn wcn

ファイル名を照会する

ファイル名を照会する際には、結果をフォーマットする方法がいくつかあります。

解決された名前と未解決の名前:
ファイルを(開くまたは参照することで) Maya にロードする際に、ファイル パスが完全ではない場合があります。たとえば、相対パス(「scenes/myScene.ma」など)であったり、環境変数(「$PRODUCTION_DIR/myScene.ma」など)を含んでいたり、単にローカル ディスク上に存在しないパスである場合などがあります。このような場合はそれぞれ、Maya ではいくつかの手順を経てパスを解決し、ディスク上でファイルを探します。既定で「file」コマンドは、解決されたファイル名(Maya が実際にファイルを読み込んでいる場所など)を返しますが、un/unresolved フラグを使用した場合は、未解決のファイル(元々指定されていたファイルなど)を返します。
フル ネームとショート ネーム:
既定で「file」コマンドはファイルへのフル パスを返しますが、shn/shortName フラグを使用した場合は、ファイル名だけが返されます。
コピー番号付きとコピー番号なし:
同じファイルを 2 回以上ロードする(同じファイルを 2 回参照するなど)ときに、Maya はファイル名の最後にコピー番号を付加してコピー ファイルを区別します。初めてファイルを読み込んだときには、コピー番号はアペンドされません。ファイルを 2 回目に読み込んだときに「¥{1¥}」がアペンドされ、3 回目は「¥{2¥}」というふうに続きます。既定で「file」コマンドは、コピー番号を付加したファイル名を返しますが、wcn/withoutCopyNumber フラグを使用した場合は、コピー番号なしでファイル名を返します。

追加の詳細事項:

戻り値

string大部分のアクションでは、指定したファイルの名前です。returnNewNodes フラグを使用すると、読み込まれたノードの名前を示す文字配列が返されます。

照会モードでは、戻り値のタイプは照会されたフラグに基づきます。

関連

getFileList, namespace, namespaceInfo, referenceEdit, referenceQuery, workspace

フラグ

activate, activeProxy, add, anyModified, applyTo, buildLoadSettings, channels, cleanReference, command, compress, constraints, constructionHistory, copyNumberList, defaultExtensions, defaultNamespace, deferReference, editCommand, errorStatus, executeScriptNodes, exists, expandName, exportAll, exportAnim, exportAnimFromReference, exportAsReference, exportAsSegment, exportSelected, exportSelectedAnim, exportSelectedAnimFromReference, exportSelectedNoReference, exportUnloadedReferences, expressions, flushReference, force, groupLocator, groupName, groupReference, i, ignoreVersion, importReference, lastFileOption, lastTempFile, list, loadAllDeferred, loadAllReferences, loadNoReferences, loadReference, loadReferenceDepth, loadReferencePreview, loadSettings, location, lockContainerUnpublished, lockFile, lockReference, mapPlaceHolderNamespace, mergeNamespaceWithParent, mergeNamespaceWithRoot, mergeNamespacesOnClash, modified, moveSelected, namespace, newFile, open, options, parentNamespace, postSaveScript, preSaveScript, preserveName, preserveReferences, preview, prompt, proxyManager, proxyTag, reference, referenceDepthInfo, referenceNode, relativeNamespace, removeDuplicateNetworks, removeReference, rename, renameAll, renameToSave, renamingPrefix, renamingPrefixList, replaceName, resetError, returnNewNodes, save, saveDiskCache, saveReference, saveReferencesUnloaded, saveTextures, sceneName, segment, selectAll, shader, sharedNodes, sharedReferenceFile, shortName, strict, swapNamespace, type, uiConfiguration, unloadReference, unresolvedName, usingNamespaces, withoutCopyNumber, writable
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
activeProxy(ap) boolean create
このフラグは、ファイル リファレンス中の内部使用に限られます。リファレンス フラグと一緒に使用して、ファイルがロードされるときにアクティブ プロキシになるファイルを指定します。また、referenceDepthInfo フラグと一緒に使用して、プリロード情報を参照するファイルでアクティブ プロキシになるファイルを指定します。
anyModified(amf) boolean query
これは照会専用フラグです。メモリ常駐ファイルのいずれかで保存を実行する必要がある場合は、1 が返されます。
buildLoadSettings(bls) boolean create
「o/open」フラグと一緒に使用すると、指定したファイルが階層情報を参照するためにだけ読み込まれるよう指定します。この情報は、「mplicitLoadSettings」という名前で一時的なロード設定に格納されます。このフラグを使用すると、指定したシーン ファイルがロードされません。つまり、オブジェクトやノードが作成されたり変更されたりすることはありません。注: ほとんどの場合、このフラグまたはこのフラグから作成される「implicitLoadSettings」を使用する必要はありません。ファイル > シーンを開く(File > Open)で表示される開くオプション ウィンドウで「選択的プリロード(Selective Load)」オプションを設定すれば、同じ機能にアクセスできます。
command(c) [string, string] createquery
ファイル操作の前に実行するコールバックを指定します。これはファイル フォーマットでのみ使用される内部フラグです。
constructionHistory(ch) boolean createquery
exportSelected と一緒に使用し、アタッチされたコンストラクション ヒストリを書き出しに含めるかどうかを指定します。
channels(chn) boolean createquery
exportSelected と一緒に使用し、アタッチされたチャネルを書き出しに含めるかどうかを指定します。
copyNumberList(cnl) boolean query
照会すると、このフラグは、ファイルが使用される各インスタンスを固有に識別する番号を含む文字配列を返します。
constraints(con) boolean createquery
exportSelected と一緒に使用し、アタッチされたコンストレイントを書き出しに含めるかどうかを指定します。
cleanReference(cr) string create
渡されるリファレンス ノードから編集箇所を除去します。リファレンスはアンロードされた状態にしてください。特定タイプの編集箇所を除去するには、editCommand フラグを使用します。フラグを指定しない場合は、すべての編集箇所が除去されます。
editCommand(ec) string create
cleanReference と一緒に使用します。指定したタイプの編集箇所だけを除去します。サポートされている編集は、setAttr、addAttr、deleteAttr、connectAttr、disconnectAttr と parent です。
defaultExtensions(de) boolean createquery
既定の拡張子を使って、ファイルの名前を変更します。この既定は true ですが、指定された Maya のセッション内では設定が持続されます。つまり、これを true または false に設定すると、新しい値が設定されるまでその値がその後のファイル コマンドでも継続して使用されます。
defaultNamespace(dns) boolean create
既定のネームスペースを使用して、読み込みと参照を行います。これは詳細設定オプションです。設定してから読み込みまたは参照を行うと、Maya はネーム クラッシュの解決アルゴリズムを呼び出さずに、読み込みまたは参照されたファイルのすべてのノードをルート(既定)のネームスペースに直接配置しようとします。ルート ネームスペースに新規オブジェクトのいずれかの名前が存在する場合、エラーが発生します。このフラグを使用する場合、ネーム クラッシュなどのエラーを避けるため、Maya 以外でネーム クラッシュ アルゴリズムの手段を作成します。: このフラグで想定されているのは、API によって記述されたカスタム ファイル トランスレータと一緒に使用する場合だけです。ユーザの責任で使用してください。
errorStatus(err) boolean query
最後のファイル読み込みのエラー ステータスを照会します。最後のファイル読み込み中にエラーが発生した場合に true を返します。
deferReference(dr) boolean createquery
-reference フラグと組み合わせて使用すると、このフラグによって、リファレンスをロードするか、またはロードを保留するかどうかが決まります。
C: 既定は false です。
Q: 照会すると、リファレンスを保留する場合は true 、保留しない場合は false を返します。-rfn/referenceNode と一緒に使用する場合は、-rfn フラグを -q フラグよりも前に置く必要があります。
exportAll(ea) boolean create
すべての項目を単一のファイルに書き出します。書き出されたファイルの名前を返します。
exportAnim(ean) boolean create
シーン内のすべてのオブジェクトのすべてのアニメーション ノードとアニメーション ヘルパ ノードを書き出します。生成されたアニメーションの書き出しファイルには、アニメーション ファイルには含まれていないオブジェクトへの接続が含まれています。このため、このファイルを読み込みまたは参照するには、同じ名前のオブジェクトが表示されるように指定する必要があります。そうしないと、エラーが発生します。-sns/swapNamespace フラグは、指定したオブジェクトのネームスペースを別のネームスペースと入れ替えるために使用できます。このネームスペースは、一貫した命名規則を使用してアニメーション ファイルの対象を複数にするために利用できます。exportAnim フラグではアニメーション レイヤは書き出されません。animLayers およびその他のタイプのノードの一般的な書き出しについては、exportEdits コマンドを参照するか、レイヤの書き出し(Export Layers)機能を使用してください。
exportSelectedAnim(eas) boolean create
シーン内の選択したオブジェクトからすべてのアニメーション ノードとアニメーション ヘルパ ノードを書き出します。アニメーション ファイル使用の詳細については、-ean/exportAnim フラグの説明を参照してください。
exportAnimFromReference(ear) boolean create
すべてのリファレンス オブジェクトからメイン シーンのアニメーション ノードとアニメーション ヘルパ ノードを書き出します。-rfn/referenceNode フラグと組み合わせて使用すると、指定したリファレンス ファイルからアニメーション ノードだけを書き出すように制限できます。アニメーション ファイル使用の詳細については、-ean/exportAnim フラグの説明を参照してください。
exportAsReference(er) boolean create
選択したオブジェクトに特定の名前を付けてリファレンス ファイルに書き出します。ファイルはプロセス中にディスクに保存されます。作成されたリファレンスの名前を返します。
exportSelected(es) boolean create
選択したオブジェクトを指定したファイルに書き出します。書き出されたファイルの名前を返します。
exportSelectedAnimFromReference(esa) boolean create
選択したリファレンス オブジェクトからメイン シーンのアニメーション ノードとアニメーション ヘルパ ノードを書き出します。-rfn/referenceNode フラグと組み合わせて使用すると、指定したリファレンス ファイルの選択したノードから、アニメーション ノードだけを書き出すように制限できます。アニメーション ファイル使用の詳細については、-ean/exportAnim フラグの説明を参照してください。
executeScriptNodes(esn) boolean create
true の場合、適切なスクリプト ノードで実行できます。false の場合、スクリプト ノードのスクリプトでは実行できません。
詳細については、script ノードのマニュアルを参照してください。
既定: true.
exists(ex) boolean query
ファイルが存在するかどうかを照会します。ファイルが存在する場合、true を返します。
expandName(exn) boolean query
これは、ファイルのファイル パス名を照会するために利用できる照会専用フラグです。
expressions(exp) boolean createquery
exportSelected と一緒に使用し、アタッチされたエクスプレッションを書き出しに含めるかどうかを指定します。
force(f) boolean create
アクションを強制的に実行させます(新規作成、開く、保存、リファレンスの除去)。removeReference と一緒に使用し、リファレンス ネームスペースを、内容が含まれていても強制的に除去します。リファレンスがルート ネームスペースにある場合は、removeReference と一緒に使用することはできません。
flushReference(fr) string create
このフラグは、渡されたリファレンス ノードに関連するリファレンス ファイルをアンロードし、関連するすべてのリファレンス ノードとシーン ファイルを維持します。**このオプションは、ネームスペースを使用しているときのみ有効です。**** 詳細: このフラグは、主にカスタム アセット管理システムの一部として使用するように想定されています。このフラグは、子リファレンスを含むリファレンスのロードを、子リファレンスに関する情報を消失することなく保留するために使用できます。子リファレンスを含むフラッシュ済みリファレンスをリロードする前には、子の Maya ASCII ファイルから「createNode reference」の行を手動で除去してください。この処理を行わないと、余分なリファレンス ノードが作成されます。
groupLocator(gl) boolean create
-r フラグと -gr フラグと一緒にしか使用しません。groupReference の出力をロケータの下にグループ化するために使用します。
groupName(gn) string create
-gr フラグと一緒にしか使用しません。オプションとして、読み込みまたは参照した項目をグループ化するトランスフォームの名前を設定するために使用します。
groupReference(gr) boolean create
-r または -i フラグと一緒にしか使用しません。単一のトランスフォームで読み込みまたは参照されたすべての項目をグループ化するために使用されます。
ignoreVersion(iv) boolean create
正式にサポートされているバージョンより前または後のバージョンのファイルを開くために使用します。データの損失、破損、またはオープン失敗などの可能性はありますが、できる限り正常に読み込もうとします。-o フラグと一緒に使用する必要があります。
lockReference(lck) boolean create
リファレンス ファイルのアトリビュートとノードをロックします。
lockFile(lf) boolean create
メインのシーンをロックまたはロック解除します。このシーンを参照するすべてのファイルは、すべてのアトリビュートとノードを自動的にロックします。また、編集済みのリファレンスが親ファイルから保存されないようにします。
lockContainerUnpublished(lcu) boolean create
このファイルにあるすべてのコンテナに対してパブリッシュ解除のロック状態を設定します。これでメイン シーンのアトリビュートが直接ロックされることはありませんが、このシーンを参照する任意のファイルによって、コンテナのすべてがパブリッシュ解除のロック済みとなります。
i(i) boolean create
指定したファイルを読み込みます。読み込まれたファイルの名前を返します。
importReference(ir) boolean create
指定したファイル内でデータの周りのリファレンスのカプセル化を除去します。これにより指定したファイルの内容が現在のシーンの一部となり、オリジナル ファイルのすべてのリファレンスが失われます。読み込まれたリファレンスの名前が返されます。
list(l) boolean query
すべてのファイルをリスト表示します。すべてのセグメント/リファレンス ファイルの名前を文字配列で返し、複製は除去します。つまり、ファイルが複数回参照され、-withoutCopyNumber フラグを設定している場合は、シーン内で 1 度リスト表示されます。
loadReferenceDepth(lrd) string create
ロードするリファレンスを指定するために使用します。有効なタイプは「all」、「none」、「topOnly」で、それぞれ、すべてのリファレンスのロード、リファレンスをロードしない、最上位のリファレンスのみロードを指定します。-open、-import、-reference、-loadReference フラグと一緒に使用する必要があります。「none」 を -loadReference と一緒に使用すると、パス認証のみが実行されます。これを使用すると、リロードをトリガせずにリファレンスを置き換えることができます。
mergeNamespacesOnClash(mnc) boolean create
Maya に同名のネームスペースが既にある場合に、このオプションを import、reference、または edit フラグと一緒に使用すると、新しいネームスペースは作成されません。既定値は false です。たとえば、読み込むオブジェクト「pSphere1」がネームスペース「ref」を参照している場合に、「ref」という名前のネームスペースが既に Maya に定義されているとします。mergeNamespacesOnClash が true の場合、既存の「ref」というネームスペースは再利用されて pSphere1 はこの既存のネームスペースに移動されます。このネームスペースに「pSphere1」という名前のオブジェクトがさらにある場合、読み込まれたものは数字が増分され(「pSphere2」)名前変更されます。一方、mergeNamespacesOnClash が false の場合、数字が増分されて新しいネームスペースが作成され(最初の場合では「ref1」)、pShere1 は ref1 というネームスペースに移動されます。このフラグではネストされたネームスペースもサポートしています。たとえば、読み込まれて「ref:foo」というネームスペースを参照する「pSphere1」というオブジェクトで mergeNamespacesOnClash が今回 true の場合、既存の「ref:foo」が再利用されオブジェクトは「ref:foo」に移動されます。mergeNamespacesOnClash が false の場合、新しいネームスペース「ref:foo1」が作成されて、「pSphere1」がその新しいネームスペースに移動されます。
mergeNamespaceWithParent(mnp) boolean create
removeReference フラグと一緒に使用します。ファイル リファレンスとネームスペースを除去する場合、残りのネームスペースの内容を親ネームスペースに移動します。リファレンスがルート ネームスペースにある場合は使用できません。
mergeNamespaceWithRoot(mnr) boolean create
removeReference フラグと一緒に使用します。ファイル リファレンスとネームスペースを除去する場合、残りのネームスペースの内容をルート ネームスペースに移動します。リファレンスがルート ネームスペースにある場合は使用できません。
loadAllDeferred(lad) boolean create
このフラグはサポートしていません。loadReferenceDepth フラグに置き換えられました。-open フラグと一緒に使用して、ファイルで読み込み中に -deferReference フラグが機能するかどうかを定義します。true が渡されると、すべてのリファレンスがロードされます。false が渡されると、-deferReference フラグが機能します。
loadAllReferences(lar) boolean create
このフラグはサポートしていません。loadReferenceDepth フラグに置き換えられました。-open フラグと一緒に使用すると、すべてのリファレンスがロードされます。
loadNoReferences(lnr) boolean create
このフラグはサポートしていません。loadReferenceDepth フラグに置き換えられました。-open フラグと一緒に使用すると、リファレンスがロードされません。-import、-reference、-loadReference フラグと一緒に使用すると、最上位のリファレンスのみがロードされます。
location(loc) boolean query
特定のファイル名の場所を照会します。
loadReference(lr) string createquery
このフラグは、ファイルをロードして渡されたリファレンス ノードに接続します。リファレンス ノードが存在しない場合、このコマンドは失敗します。ファイルがすでにロードされている場合、同じファイルがリロードされます。
ファイルが指定されない場合、このコマンドは最後に使用されたリファレンス ファイルをロード(リロード)します。
loadReferencePreview(lrp) string create
このフラグは、リファレンス ファイルの特別なプレビューのみのロードを実行します。プレビューのみのリファレンス ファイルは完全にはロードされず、含まれるネストされたリファレンスなどの特定の情報を判断できるよう部分的にロードされます。プレビューされたネストされたリファレンスは、プレビューのみの特別な状態で残ります。
loadSettings(ls) string create
「o/open」フラグと一緒に使用すると、このフラグはどのリファレンス ロード設定を使用するかを指定します。リファレンス ロード設定では、どのリファレンスをロードしてどのリファレンスをアンロードするかを指定します。アンロードされるリファレンス ファイルは、通常、Maya で読み込んだり解釈したりする必要はありません。これによって、Maya がシーン全体のロードに要する時間を短縮できる可能性があります。「ls/loadSettings」フラグが指定されなかったか、または、フラグ引数として空の文字列(「」)を使用した場合は、既定のロード設定が使用されます。既定のロード設定は、ファイルが最後に保存されたときのすべてのリファレンスの状態を示します。ロード設定「implicitLoadSettings」は、「bls/buildLoadSettings」フラグで生成されて「loadSettings」コマンドを使って編集された一時的なロード設定を参照します。現在は、既定で暗黙のロード設定がサポートされています。
lastTempFile(ltf) boolean query
照会されると、このフラグはファイルの保存中に使用された一時的なファイル名を返します。保存に失敗すると、一時的なファイルは同じディレクトリにこのファイル名で残されます。
modified(mf) boolean createquery
ファイルの変更状態を設定します。変更されたファイルは、新しいファイルを開閉する前に、保存しておく必要があります。オブジェクトが作成または修正されるたびにファイルの状態が自動に更新されるため、通常はこのフラグを編集する必要はありません。状態を編集する場合、以下の例に示されるように、編集フラグを使用せずに実行されます。照会モードでは、ファイルが修正されていると 1 を返します。それ以外は 0 が返されます。
newFile(new) boolean create
シーンを初期化します。無題のシーンが既定位置で返されます。
namespace(ns) string edit
読み込みと参照中に、すべてのオブジェクトをグループ化するために使用されるネームスペース名です。指定したリファレンス ファイルのすべてのオブジェクトをグループ化するために使用されるネームスペースを変更します。リファレンスは「Using Namespaces」オプションで作成し、ロードしておく必要があります。既存のネームスペースに含まれる参照されないノードも新しいネームスペースに移動されます。このコマンドでは新しいネームスペースが作成されます。既に存在するネームスペースを使用することはできません。古いネームスペースは除去されます。
open(o) boolean create
指定したファイルを開きます。開いたファイルの名前を返します。
options(op) string createquery
現在設定されているファイル オプションを設定/照会します。Maya ファイルの保存時、ファイル オプションを使用します。現在のファイルのコマンドでサポートされている 2 つのファイル オプション フラグは vp です。
  • v (冗長)は、ファイルの保存時、アトリビュート名およびコマンド フラグ名に長い名前を使用したか短い名前を使用したかを示します。Maya ASCII および Maya バイナリ ファイル フォーマットの両方で使用されます。
    0 または 1 のみ有効です。
    v=1 を設定すると、長いアトリビュート名およびコマンド フラグ名を使用することを示します。既定では、または v=0 を設定すると、短いアトリビュート名が使用されます。
  • p (精度)は、ファイルの保存時の Maya ファイルの IO の精度を定義します。Maya ASCII ファイル フォーマットでのみ使用します。
    これは整数値です。既定値は 17 です。
  • オプションのフォーマットは「flag1=XXX;flag2=XXX」です。Maya では最後の vp を最終結果として使用します。
    注:
    1. 複数のフラグを区切るにはセミコロン(「;」)を使用します。2. オプション文字列には空のスペース(「 」)は許可されません。
    lastFileOption(lfo) boolean query
    照会の場合、ファイル コマンドが最後に使用したオプション文字列を返します。
    preview(pv) boolean create
    任意の -exportXXX フラグと一緒に使用すると、Maya では書き出されるファイルをディスクに実際に書き込まずに、書き出されるノード リストを返します。
    prompt(pmt) boolean createquery
    このフラグはダイアログを要求するファイルの表示をコントロールします。ダイアログを要求するファイルの例としては、ユーザによる確認や見つからないファイルの参照ダイアログを要求するエラー メッセージが挙げられます。一度このフラグが使用されると、ファイル コマンドのすべてのインスタンスはこのフラグで最後に設定された値を使用します。一部のインタラクティブなファイル操作では、フラグが false に設定されていてもダイアログを表示するものがありますが、作成されたファイル コマンドの場合、このフラグが false に設定されていればダイアログを表示することはありません。既定値は true です。
    parentNamespace(pns) boolean query
    リファレンス ファイルの親ネームスペースの名前を返します。
    preserveReferences(pr) boolean create
    import フラグまたは export フラグと一緒に使用すると、このフラグはインポータまたはエクスポータに、リファレンスをコピーではなくリファレンスとして読み込むまたは書き出すように通知します。
    exportUnloadedReferences(eur) boolean create
    preserveReferences の使用時のみ有効です。exportAll フラグと一緒に使用すると、エクスポータに対してアンロード されたリファレンスをすべて書き出すよう通知されます。exportSelected フラグと一緒に使用すると、エクスポータに対して 選択されたノードに関連するアンロードされたプロキシ リファレンスを すべて書き出すよう通知されます。
    preSaveScript(prs) string create
    save フラグと一緒に使用すると、ファイルを保存する前に、指定したスクリプトが実行されます。
    postSaveScript(pos) string create
    save フラグと一緒に使用すると、ファイルを保存した後に、指定したスクリプトが実行されます。
    proxyManager(pm) string create
    1 つまたは複数のプロキシ リファレンスを既存のファイル リファレンスに追加する場合に、プロキシ管理ノードを使用してそのリファレンスに接続されたプロキシを定義します。このフラグは activeProxy フラグと proxyTag フラグと一緒に使用して、目的の proxyManager を指定します。また、referenceDepthInfo フラグと一緒に使用して、プリロード情報を参照するファイルでプロキシ リファレンスの proxyManager を指定します。
    proxyTag(pt) string create
    このフラグはファイルのロードまたはプリロード中の内部使用に限られます。プロキシ タグは、プロキシ リファレンスをリファレンス エディタから管理しやすいように、プロキシ リファレンスに割り当てる名前です。プロキシ タグは指定したプロキシ セット内で固有です。このフラグは proxyManager フラグと組み合わせて使用する必要があります。
    reference(r) boolean query
    指定したファイルにリファレンスを作成します。ファイル リファレンスの名前を返します。
    指定したファイルからすべてのファイル リファレンスを照会します。
    renameAll(ra) boolean create
    -import でのみ利用可能です。true の場合、既存のノードとクラッシュする名前のノードだけでなく、新たに作成されたすべてのノードの名前を変更します。-import でのみ利用可能です。
    referenceDepthInfo(rdi) uint create
    このフラグを使用して Maya ASCII ファイル(.ma)と接続されているプリファレンスをロードするリファレンスを格納します。このフラグは、ファイルの読み取り/書き出し中のみに使用されます。必要なければ、使用しなくても構いません。
    referenceNode(rfn) string query
    照会すると、このフラグはファイルに関連するリファレンス ノードの名前を返します。ファイルがリファレンスでないか、リファレンス ノードが含まれていない場合、空の文字列が返されます。

    照会モードでは、このフラグは値を受け入れることができます。

    rename(rn) string create
    シーンの名前を変更します。ほとんどの場合、保存中に saveAs の名前を設定するときに使用されます。シーンの新しい名前を返します。
    returnNewNodes(rnn) boolean create
    開く、読み込み、loadReference、とリファレンス操作の戻り値を制御するために使用します。現在のシーンに追加された新規ノードのリストを返す file コマンドを強制的に発行させます。
    renamingPrefixList(rpl) boolean query
    このフラグはファイルが使用するすべての名前変更プリフィックスのリストを返します。
    renamingPrefix(rpr) string createquery
    このファイルのすべてのオブジェクトのプリフィックスとして使用される文字列です。このフラグは -ns/namespace に置き換えられました。
    removeReference(rr) boolean create
    指定したファイル リファレンスを親から除去します。これにより、このファイルが参照するすべての項目も除去されます。除去されたファイルの名前を返します。そのネームスペースにリファレンスのみがある場合、ネームスペースを除去します。ファイル リファレンスの除去後、ネームスペースにオブジェクトが残っている場合、既定で、ネームスペースに残りのオブジェクトを残します。ネームスペースに残っているオブジェクトを親またはルート ネームスペースとマージする場合、mergeNamespaceWithParent または mergeNamespaceWithRoot フラグを使用します。これで空のファイル リファレンス ネームスペースが除去されます。すべてのオブジェクトを強制削除するには force フラグを使用します。これで空のファイル リファレンス ネームスペースが除去されます。
    renameToSave(rts) boolean createquery
    true の場合、シーンを保存する前に、この名前を変更する必要があります。照会すると、このフラグは、シーンを保存する前に名前を変更する必要がある場合に、true を返します。
    既定は false です。
    save(s) boolean create
    指定したファイルを保存します。保存されたファイルの名前を返します。
    saveReference(sr) boolean create
    リファレンス ノードの編集箇所とリファレンス ファイルへの接続を保存します。新たに追加されたヒストリやアニメーションが保存中のリファレンスの外部のオブジェクトに適用されていない場合は、これらも保存対象となります。
    compress(cmp) boolean create
    保存で使用すると、ファイルを圧縮(gzip)して出力します。
    preserveName(pn) boolean create
    圧縮で使用すると、.gz をアペンドせずに、通常の拡張子を保持します。
    removeDuplicateNetworks(rdn) boolean create
    これを設定すると、読み込まれたネットワークと同じネットワークが現在のシーンで検出された場合に、読み込まれたネットワークを除去します。このフラグは、import フラグと一緒に使用した場合のみに使用できます。
    resetError(rer) boolean create
    既存のグローバル ファイル エラーをすべてオフにします。
    selectAll(sa) boolean create
    このファイルと子ファイルのすべてのコンポーネントを選択します。指定するファイルは、この Maya セッションですでに開かれているファイルでなければならない点に注意してください。既定では既存のセレクションが置き換えられます。「add」フラグと一緒に使用すると、アクティブなセレクション リストが保持されます。
    add(add) boolean create
    selectAll と一緒に使用すると、アクティブ リストの既存の項目を除去することなく、指定した項目をアクティブ リストに追加することを示します。
    saveDiskCache(sdc) string createquery
    このフラグはジグル ディスク キャッシュの saveAs オプションを設定します。有効な入力値は次の 2 つです。「always」- 常にファイル テクスチャを新しい位置にコピーする。「never」- まったくコピーしない。
    C: 既定は「always」です。
    Q: 照会すると、文字列(「always」、「never」)を返します。
    shader(sh) boolean createquery
    exportSelected と一緒に使用し、アタッチされたシェーダを書き出しに含めるかどうかを指定します。
    sharedNodes(shd) string createmultiuse
    このフラグは「-r/-reference」フラグを変更して、リファレンス内の特定タイプのノードを共有ノードとして扱うようにします。共有ノードはすべて既定のネームスペースに配置されます。コピーがすでに既定のネームスペースにある場合は、共有ノードのコピーは新しく作成されません。代わって共有ノードと既存のノードがマージされます。2 つのノードをマージする場合の動作は、ノード タイプによって異なります。一般的には、アトリビュート値はマージされない、つまり、既存の共有ノードの値セットが保持され、マージされるノードの値は無視されます。有効なオプションは、「displayLayers」、「shadingNetworks」、「renderLayersByName」、「renderLayersById」です。このフラグは多目的に使用できます。つまり複数回指定して、たとえばディスプレイ レイヤとシェーディング ネットワークの両方を共有することができます。2 つのシェーディング ネットワークは、同一の場合のみマージされます。つまり、1 つのシェーディング グループに属するノードのネットワークを、名前とタイプが同じ等価のノードと同じように配置する必要があります。また、ネットワークがアニメートされていたり、DAG オブジェクトまたはエクスプレッションが含まれる場合は、マージできません。このフラグは -srf/sharedReferenceFile と組み合わせて使用することはできません。
    shortName(shn) boolean query
    メインの照会フラグと一緒に使用すると、返されるファイル名がショート ネーム(ディレクトリ パスを除いてファイル名だけにした名前)になるように指定します。このフラグが存在しない場合、フル ネームとディレクトリ パスを返します。
    sceneName(sn) boolean query
    現在のシーンの名前を返します。
    swapNamespace(sns) [string, string] createmultiuse
    -r/reference フラグまたは -i/import フラグと組み合わせる場合にしか使用できません。このフラグは、指定したネームスペースをすべて、代替として指定したネームスペースに置き換えます。このネームスペースの「入れ替え」は、ファイルが参照されたときに発生します。このフラグは 2 つの文字列引数を取ります。最初の引数は置き換えるネームスペースを指定します。2 番目の引数は、代替ネームスペースを指定します。このフラグは暗黙的にネームスペースの使用を可能にし、deferReference と一緒に使用することはできません。
    sharedReferenceFile(srf) boolean create
    -r/reference フラグと -ns/namespace フラグとの組み合わせでのみ使用できます(プリフィックスはサポートしません)。このフラグは「-r/-reference」フラグを修正して、そのリファレンス内のすべてのノードが共有ノードとして扱われるようにします。すでにコピーが存在する場合は、そのノードの新しいコピーは作成されません。その代わりに、共有ノードは既存のノードにマージされます。2 つのノードをマージする場合の動作は、ノード タイプによって異なります。このフラグは -shd/sharedNodes とは一緒に使用できません。
    saveReferencesUnloaded(sru) boolean create
    このフラグは、save フラグと一緒に使用した場合のみに使用できます。これはアンロードされたすべてのリファレンスもファイルと一緒に保存するように指定します。
    strict(str) boolean create
    厳密なファイル パスの解決を設定します。true にすると、相対パスと絶対パスの両方とも、すべてのパスを正確に一致させます。相対パスは、プロジェクトのルート ディレクトリからの相対位置とみなされます。-open、-import、-importReference、-reference と一緒に使用する必要があります。
    saveTextures(stx) string createquery
    このフラグは、3D ペイント ファイル テクスチャの saveAs オプションを設定します。有効な入力値は次の 3 つです。「always」- 常にファイル テクスチャを新しい位置にコピーします。「unlessRef」- リファレンス ファイル テクスチャでない場合にのみコピーします。「never」- まったくコピーしません。
    C: 既定は「unlessRef」です。
    Q: 照会すると、文字列(「always」、「unlessRef」、「never」)を返します。
    type(typ) string query
    このファイルのタイプを設定します。既定では、以下のいずれかになります。「mayaAscii」、「mayaBinary」、「mel」、「OBJ」、「directory」、「plug-in」、「audio」、「move」、「EPS」、「Adobe(R) Illustrator(R)」、「image」のプラグインは、独自のタイプも定義することがあります。
    このファイルと一致するファイル タイプの文字配列を返します。
    uiConfiguration(uc) boolean createquery
    uiConfiguration スクリプト ノードにシーンと一緒に UI 設定を保存します(たとえば、panes)。現在の既定はオンで、initialStartup.mel に設定されます。
    usingNamespaces(uns) boolean query
    ブーリアンを返します。指定したリファレンス ファイルがネームスペースまたは名前変更プリフィックスを使用するかどうかを照会します。
    unresolvedName(un) boolean query
    このフラグをメインの照会フラグと一緒に使用すると、返されるファイル名が未解決になるように指定します(つまり、ファイルが Maya にロードされたときに指定したパス名になります。このパスは環境変数を含み、ディスクに存在しない場合があります)。このフラグが存在しない場合、解決済みの名前を返します。
    unloadReference(ur) string create
    このフラグは、渡されたリファレンス ノードに関連するリファレンス ファイルをアンロードします。
    writable(w) boolean query
    現在のシーンで特定のファイルが書き込み可能かどうかを照会します。メインのシーン ファイルの場合、これは現在のユーザによってファイル システムへの書き込みが可能であることを意味します。メインのシーン ファイルによって参照されるファイルの場合、常に書き込みは不可能です(リファレンス ファイルは元々読み取り専用です)。現在のシーンにないファイルは、常に false を返します。
    withoutCopyNumber(wcn) boolean query
    このフラグをメインの照会フラグと一緒に使用すると、返されるファイル名の末尾にコピー番号がアペンドされないように指定します。このフラグが存在しない場合、返されたファイル名の最後にコピー番号がアペンドされることがあります。
    segment(seg) string
    このフラグは現在サポートしていません。
    activate(a) boolean
    このフラグは現在サポートしていません。
    exportAsSegment(exs) boolean
    このフラグは現在サポートしていません。
    exportSelectedNoReference(esr) boolean
    このフラグは現在サポートしていません。
    moveSelected(ms) boolean edit
    このフラグは現在サポートしていません。
    applyTo(at) string create
    オフライン編集ファイルの読み込み時または参照時に、それを指定のリファレンスに適用します(<main> のマップ先を決定します)。このため、リファレンス ノード名を指定します。メイン シーン(ルート ネームスペース)のノードに編集を適用するには、「:」で渡します。ファイル -i/-import または -r/-reference フラグと一緒に使用する必要があります。
    mapPlaceHolderNamespace(mns) [string, string] createqueryeditmultiuse
    指定したリファレンスに placeHolderNamespace をマッピングします。作成モードで、ファイルの -i/-import と -r/-reference フラグと一緒に使用する必要があります。1 番目の文字列はプレース ホルダのネームスペースで山括弧(例:「<foo>」)を含みます。2 番目の文字列はリファレンス ノードで、そのネームスペースはマップ先(例:refRN)を示します。ネームスペースのマップ先がルートのネームスペースである場合は、「:」を使用します。
    replaceName(rep) [string, string] createqueryeditmultiuse
    検索/置換文字列を定義します。検索/置換はリーフ ノード名に適用します。検索文字列には、ネームスペースとワイルドカードを含めることができますが、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".
    relativeNamespace(rns) string create
    このフラグを exportSelected および exportAll 操作と一緒に使用することで、書き出されたファイルのノードが指定されたネームスペースに相対して出力されるように指定することができます。これは、ノード名の書き出し時にノード名からネームスペースの不要なレベルを除去する機能です。relativeNamespace 値は、書き出されたノードの相対ルートとして使用されるネームスペースを指定し、絶対ネームスペースとして指定される必要があります。指定の相対ネームスペースに存在しない書き出されたファイルのノードは、絶対ネームスペース名を使用して書き込まれます。注: このフラグは preserveReferences フラグと一緒に使用することはできません。

    フラグはコマンドの作成モードで表示できます フラグはコマンドの編集モードで表示できます
    フラグはコマンドの照会モードで表示できます フラグに複数の引数を指定し、タプルまたはリストとして渡すことができます。

    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, defaultExtensions=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', open=True )
    # reference the file wilma.ma
    #
    cmds.file( 'C:/mystuff/wilma.mb', reference=True )
    # reference the file barney.mb into a namespace called "rubble".
    #
    cmds.file( 'C:/maya/projects/default/scenes/barney.ma', reference=True, type='mayaAscii', namespace='rubble' )
    # change the namespace containing barney.mb.
    #
    cmds.file( 'C:/maya/projects/default/scenes/barney.ma', edit=True, namespace='purpleDinosaur' )
    # retrieve a string array of all files such as main scene and reference files in the scene
    #
    cmds.file( query=True, list=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', exportAsReference=True )
    # Select all the objects associated with file betty.mb
    #
    cmds.file( 'c:/mystuff/betty.mb', selectAll=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', removeReference=True )
    # Query whether the file named "foo.mb" exists on disk
    #
    cmds.file( 'foo.mb', query=True, exists=True )
    # Result: 0 #
    # Query whether the reference node "rubble:betty is deferred loaded.
    # Note, -referenceNode flag has to come before -q flag.
    cmds.file(referenceNode='rubbleRN', query=True, deferReference=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', open=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', open=True, loadSettings='implicitLoadSettings')
    #
    #   Example for the '-cleanReference' and '-editCommand' flags
    #
    # Create a simple reference to a sphere
    #
    cmds.file( force=True, new=True )
    cmds.polySphere()
    cmds.file( rename='ref.ma' )
    cmds.file( force=True, type='mayaAscii', save=True )
    cmds.file( force=True, new=True )
    cmds.file( 'ref.ma', reference=True, namespace='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( referenceNode='refRN', query=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( referenceNode='refRN', query=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", reference=True, applyTo="refRN")
    # Result: maps <main> to refRN's namespace
    # apply the edit file to nodes in the main scene
    cmds.file("translateSphere.editMA", import=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", reference=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)
    # Set the file options
    cmds.file( force=True, save=True, options='v=1;p=17',type='mayaAscii');
    # Result:The saved file uses full names for attributes on nodes and flags in command.Also the precision of values in file is 17.
    # Load Reference Preview
    # Create a nested reference with a child reference under a parent reference.
    cmds.file( force=True, new=True )
    cmds.polySphere()
    cmds.file( rename='child.ma' )
    cmds.file( force=True, type='mayaAscii', save=True )
    cmds.file( force=True, new=True )
    cmds.file( 'child.ma', reference=True, namespace='child_namespace' )
    cmds.file( rename='parent.ma' )
    cmds.file( force=True, type='mayaAscii', save=True )
    # Preview the unloaded child reference under the unloaded parent reference.
    cmds.file( force=True, new=True )
    cmds.file( 'parent.ma', reference=True, namespace='parent_namespace' )
    cmds.file( 'parent.ma', unloadReference=True )
    cmds.file( 'parent.ma', loadReferencePreview=True )
    #
    #			   Example for 'mergeNamespacesOnClash'
    #
    # Create a reference
    cmds.file( force=True, new=True )
    cmds.namespace( add="bar" )
    cmds.namespace( set="bar" )
    cmds.polySphere();
    cmds.file( rename="ref.ma" )
    cmds.file( force=True, type='mayaAscii', save=True )
    # Create a scene with some namespaces and objects
    cmds.file( force=True, new=True )
    cmds.namespace( add="ref:foo:bar" )
    cmds.namespace( set="ref:foo:bar" )
    cmds.polySphere();
    # Merge into root
    cmds.file('ref.ma', reference=True, mergeNamespacesOnClash=True, namespace=':');
    # Merge into nested namespace
    cmds.file('ref.ma', import=True, mergeNamespacesOnClash=True, namespace=':ref:foo');
    # Don't merge namespace
    cmds.file('ref.ma', reference=True, mergeNamespacesOnClash=False, namespace=':ref:foo');
    # Now Edit the new namespace and merge it
    cmds.file('ref.ma', edit=True, mergeNamespacesOnClash=True, namespace=':ref:foo');
    ###############################################/
    #/ Example for export with relativeNamespace  #/
    ###############################################/
    cmds.file(new=True,force=True)
    cmds.sphere(name=":A:sphereA")
    cmds.sphere(name=":A:B:sphereB")
    cmds.sphere(name=":A:B:C:sphereC")
    cmds.sphere(name=":D:sphereD")
    # Select all the spheres.
    #
    cmds.select(":A:sphereA", replace=True)
    cmds.select(":A:B:sphereB",add=True)
    cmds.select(":A:B:C:sphereC",add=True)
    cmds.select(":D:sphereD",add=True)
    # Export all these spheres with -relativeNamespace flag.
    #
    cmds.file(rename="exp.ma")
    cmds.file(force=True, exportSelected=True, type="mayaAscii", relativeNamespace=":A:B")
    # The result in the exported file:
    # :A:sphereA
    # :C:sphereC
    # :D:sphereD
    # -sphereB
    #