ジャンプ先: 概要. 戻り値. キーワード. 関連. フラグ. Python 例.
dataStructure([asFile=string], [asString=string], [format=string], [name=string], [remove=boolean], [removeAll=boolean])
注: オブジェクトの名前と引数を表す文字列は、カンマで区切る必要があります。これはシノプシスに示されていません。
dataStructure は、取り消し可能、照会可能、および編集不可能です。
ストラクチャの説明を取得し、使用可能なデータ ストラクチャのリストに追加して作成します。ストラクチャの定義は、asString フラグで指定するか、または asFile フラグによって参照されるファイル内に存在します。
remove フラグが name フラグとともに指定されている場合、データ ストラクチャは除去されます。これは、データ ストラクチャの作成、除去、照会に別々のコマンドを作成するのではなく、1 つのコマンドですべてのストラクチャの操作を維持するためです。removeAll フラグを使用すると、既存のすべてのメタデータ ストラクチャが除去されます。注意して使用してください。除去されたストラクチャは除去後もメタデータ ストリーム内で使用されている可能性がありますが、新しいストリームの作成には使用できなくなります。
作成モードと除去モードは両方とも、元に戻すことができません。
既存のストラクチャの(名前を含む)完全な複製の作成が、新しいストラクチャを実際に作成することなくサイレントに成功します。既存のストラクチャと同じ名前の重複しないストラクチャを新しく作成しようとすると、同じ名前の 2 つのストラクチャを区別する方法がないため、失敗します。
モードの照会は、作成したストラクチャと登録されているストラクチャ シリアライゼーション フォーマットの両方の情報を表示するように定義されています。シリアライゼーション フォーマットでは、ストラクチャの情報をテキスト(raw、XML、JSON など)として保持します。raw ストラクチャ タイプは組み込まれているため、何も指定しない場合は raw が前提となります。
フラグを使用しない一般的な照会では、現在存在するすべてのストラクチャの名前のリストが返されます。
format フラグを照会すると、登録されているすべてのストラクチャ シリアライゼーション フォーマットのリストが返されます。
query フラグの前に format を指定して照会すると、その特定のストラクチャ シリアライゼーション フォーマットの詳細な説明が表示されます。
query フラグの前にストラクチャ名とシリアライゼーション フォーマットとともに asString フラグを照会すると、名前を指定したデータ ストラクチャを表す文字列が format フラグで指定されたシリアライゼーション フォーマットで返されます。フォーマットがストラクチャを作成したフォーマットと同じであっても、照会で返される文字列は同一でないことがあります。照会された値が標準的な方法でフォーマットされていて、元のフォーマットが保持されていないためです。
query フラグの前にストラクチャ名を指定して asFile フラグを照会すると、ストラクチャが生成された元のファイルが返されます。asString フラグまたは API を使用してストラクチャが作成された場合、空の文字列が返されます。
name フラグを照会すると、これまでに作成されたすべてのストラクチャのリストが返されます。
string | 結果のストラクチャの名前。ストラクチャの説明に定義されている名前と一致する必要があります。 |
string[] | 削除されたストラクチャの名前。 |
照会モードでは、戻り値のタイプは照会されたフラグに基づきます。
metadata, component
addMetadata, applyMetadata, editMetadata, getMetadata, hasMetadata
asFile, asString, format, name, remove, removeAll
フラグはコマンドの作成モードで表示できます
|
フラグはコマンドの編集モードで表示できます
|
フラグはコマンドの照会モードで表示できます
|
フラグに複数の引数を指定し、タプルまたはリストとして渡すことができます。
|
import maya.cmds as cmds
import maya.cmds as cmds
cmds.dataStructure( query=True, format=True )
# Result: ['raw', 'debug'] #
cmds.dataStructure( format='raw', asString='name=NameAndID:string=name:int32=ID' )
# Result: 'NameAndID' #
# Note that this file doesn't exist, it's just an example of how to read
# from the file after you've created it. The file contents should look
# like this:
# name=FileBasedStructure
# string=fileInformation
cmds.dataStructure( asFile='someFile.raw' )
cmds.dataStructure( query=True )
# Result: ['NameAndID', 'FileBasedStructure'] #
cmds.dataStructure( name='NameAndID', format='raw', query=True, asString=True )
# Result: 'name=NameAndID:string=name:int32=ID' #
cmds.dataStructure( remove=True, name='NameAndID' )
# Result: 'NameAndID' #
cmds.dataStructure( query=True )
# Result: ['FileBasedStructure'] #
cmds.dataStructure( removeAll=True )
# Result: ['FileBasedStructure'] #