ジャンプ先: 概要. 戻り値. キーワード. フラグ. Python 例.
assembly([active=string], [activeLabel=string], [canCreate=string], [createOptionBoxProc=script], [createRepresentation=string], [defaultType=string], [deleteRepresentation=string], [deregister=string], [input=string], [isAType=string], [isTrackingMemberEdits=string], [label=string], [listRepTypes=boolean], [listRepTypesProc=script], [listRepresentations=boolean], [listTypes=boolean], [name=string], [newRepLabel=string], [postCreateUIProc=script], [proc=script], [renameRepresentation=string], [repLabel=string], [repName=string], [repNamespace=string], [repPostCreateUIProc=string], [repPreCreateUIProc=string], [repType=string], [repTypeLabel=string], [repTypeLabelProc=script], [type=string])
注: オブジェクトの名前と引数を表す文字列は、カンマで区切る必要があります。これはシノプシスに示されていません。
assembly は、取り消し可能、照会可能、および編集可能です。
アセンブリのシーン アセンブリ フレームワークへの登録、アセンブリの作成、編集、および照会を行うコマンドです。アセンブリ ノードは DAG ノードであるため、さまざまな DAG エディタ(アウトライナ、ハイパーグラフ、ノード エディタ)で表示されます。アセンブリの作成時、ノード名は既定でノード タイプの名前に設定されます。assembly コマンドでは、アセンブリ ノード ベース クラスから派生する任意のノードを作成できます。これらのタイプのレジストリとしても機能するため、さまざまなスクリプト コールバックを assembly コマンドで定義して登録できます。これらのコールバックはアセンブリ ノードの操作中に Maya によって起動され、動作のカスタマイズに使用できます。
新しいアセンブリ タイプを登録する
アセンブリ ノード ベース クラスから派生した新しいタイプのアセンブリを定義する場合、assembly コマンドを使用して多数のプロシージャを定義すると、新しいアセンブリ ノード タイプを Maya に正常に統合することができます。これらのプロシージャの大部分はアセンブリ タイプを Maya ユーザ インタフェースと統合するために使用され、非インタラクティブなスクリプト用には必要ありません。詳細については、Maya API マニュアルの MPxAssembly クラスの説明を参照してください。assembly コマンドを使用して登録することができる重要なプロシージャの一部を次に示します。
- listRepTypesProc
- 新しいアセンブリ タイプが作成できるリプリゼンテーションタイプをリストするプロシージャです。これにより、Maya は実際にアセンブリ ノードを作成することなくアセンブリによって作成できるリプリゼンテーション タイプを照会することができます。
- repTypeLabelProc
- アセンブリが作成できるリプリゼンテーション タイプのユーザ インタフェースに表示される(場合によってはローカライズされた)ラベルを返すプロシージャです。ラベルは、短くわかりやすい判読可能なリプリゼンテーション タイプの説明である必要があります。
- createOptionBoxProc
- アセンブリ タイプの作成オプション用のオプション ボックスを生成するプロシージャです。定義されている場合、このプロシージャにより、そのアセンブリのタイプの作成に使用できるオプション ボックスが生成されます。
- repPreCreateUIProc
- リプリゼンテーションの作成前にダイアログを生成するプロシージャです。定義されている場合、Maya によって呼び出されるため、アセンブリのリプリゼンテーションのタイプを作成する前にユーザがインタラクティブに選択することができます。
- postCreateUIProc
- アセンブリの作成後にダイアログを生成するプロシージャです。定義されている場合、Maya によって呼び出されるため、アセンブリの作成後にユーザがインタラクティブに選択し、それらをアセンブリに適用することができます。
なし
照会モードでは、戻り値のタイプは照会されたフラグに基づきます。
representation, assembly
active, activeLabel, canCreate, createOptionBoxProc, createRepresentation, defaultType, deleteRepresentation, deregister, input, isAType, isTrackingMemberEdits, label, listRepTypes, listRepTypesProc, listRepresentations, listTypes, name, newRepLabel, postCreateUIProc, proc, renameRepresentation, repLabel, repName, repNamespace, repPostCreateUIProc, repPreCreateUIProc, repType, repTypeLabel, repTypeLabelProc, type
フラグはコマンドの作成モードで表示できます
|
フラグはコマンドの編集モードで表示できます
|
フラグはコマンドの照会モードで表示できます
|
フラグに複数の引数を指定し、タプルまたはリストとして渡すことができます。
|
import maya.cmds as cmds
#Create a default type of assembly and name it MyAssembly.
#The assembly name is optional.
#
cmds.assembly(name='MyAssembly')
#Create an assembly of type MyAssemblyType and name it MyAssembly.
#
cmds.assembly(name='MyAssembly', type='MyAssemblyType')
#Set the default type to be MyAssemblyType.
#
cmds.assembly(edit=True, defaultType='MyAssemblyType')
#Create a representation of type "MyRepType", on assembly myAssembly, and
#name it "MyRepName"
#
cmds.assembly(myAssembly, edit=True, createRepresentation='MyRepType',
repName='MyRepName')
#Rename representation "MyRepName" to "MyNewRepName" on assembly myAssembly.
#
cmds.assembly(myAssembly, edit=True, renameRepresentation='MyRepName',
repName='MyNewRepName')
#Create a representation of type "Locator", on assembly myAssembly, name it
#"myLocator", and add an annotation using the input flag.
#
cmds.assembly(myAssembly, edit=True, createRepresentation='Locator',
repName="myLocator", input="An Annotation")
#Create a representation of type "Scene", on assembly myAssembly,
#using file "/path/to/mayafile.mb"
#
cmds.assembly(myAssembly, edit=True, createRepresentation='Scene',
input="/path/to/mayafile.mb")
#Delete scene representation from assembly myAssembly
cmds.assembly(myAssembly, edit=True, deleteRepresentation="mayafile.mb")
#Delete locator representation from assembly myAssembly
cmds.assembly(myAssembly, edit=True, deleteRepresentation="myLocator")
#Set the procedure that provides the representation type label for
#an assembly type.
#
cmds.assembly(edit=True, repTypeLabelProc='MyRepTypeLabelQuery', type='MyAssembly')
#Set the label for the default assembly type.
#
cmds.assembly(edit=True, label='My Assembly Type')
#Set the procedure that provides the representation type list which the
#default assembly supports.
#
cmds.assembly(edit=True, listRepTypesProc='MyRepTypesProc')
#Set the pre-create UI procedure for a representation type, for a
#specific type of assembly.
#
cmds.assembly(edit=True, repPreCreateUIProc='MyRepresentation', proc='MyPreCreateProcedure', type='MyAssembly')
#Set the post-create UI procedure for a representation type, for the
#default assembly type.
#
cmds.assembly(edit=True, repPostCreateUIProc='MyRepresentation', proc='MyPostCreateProcedure' )