assembly

ジャンプ先: 概要. 戻り値. キーワード. フラグ. MEL 例.

概要

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] [-listRepTypesProc script] [-listRepresentations] [-listTypes] [-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 は、取り消し可能、照会可能、および編集可能です。

新しいアセンブリ タイプを登録する

listRepTypesProc

新しいアセンブリ タイプが作成できるリプリゼンテーションタイプをリストするプロシージャです。これにより、Maya は実際にアセンブリ ノードを作成することなくアセンブリによって作成できるリプリゼンテーション タイプを照会することができます。

repTypeLabelProc

アセンブリが作成できるリプリゼンテーション タイプのユーザ インタフェースに表示される(場合によってはローカライズされた)ラベルを返すプロシージャです。ラベルは、短くわかりやすい判読可能なリプリゼンテーション タイプの説明である必要があります。

createOptionBoxProc

アセンブリ タイプの作成オプション用のオプション ボックスを生成するプロシージャです。定義されている場合、このプロシージャにより、そのアセンブリのタイプの作成に使用できるオプション ボックスが生成されます。

repPreCreateUIProc

リプリゼンテーションの作成前にダイアログを生成するプロシージャです。定義されている場合、Maya によって呼び出されるため、アセンブリのリプリゼンテーションのタイプを作成する前にユーザがインタラクティブに選択することができます。

postCreateUIProc

アセンブリの作成後にダイアログを生成するプロシージャです。定義されている場合、Maya によって呼び出されるため、アセンブリの作成後にユーザがインタラクティブに選択し、それらをアセンブリに適用することができます。

戻り値

なし

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

キーワード

フラグ

ロング ネーム(ショート ネーム)	引数タイプ	プロパティ
-active(-a)	string
アクティブ リプリゼンテーションを名前で設定するか、またはアクティブ リプリゼンテーションの名前を照会します。編集モードは複数のアセンブリに適用することができます。照会モードでは、単一のアセンブリのみが指定されている場合は単一の文字列を返し、複数のアセンブリが指定されている場合は文字列の配列を返します。名前として空の文字列を使用することは、現在のアクティブ リプリゼンテーションを非アクティブにすることを意味します。
-activeLabel(-al)	string
アクティブ リプリゼンテーションをラベルで設定するか、またはアクティブ リプリゼンテーションのラベルを照会します。編集モードは複数のアセンブリに適用することができます。照会モードでは、単一のアセンブリのみが指定されている場合は単一の文字列を返し、複数のアセンブリが指定されている場合は文字列の配列を返します。
-canCreate(-cc)	string
特定のアセンブリが作成できるリプリゼンテーション タイプを照会します。
-createOptionBoxProc(-cob)	script
特定のアセンブリ タイプのオプション ボックス メニュー プロシージャを設定または照会します。このアセンブリ タイプは、-type フラグを使用してアセンブリ タイプを明示的に指定しない限り、既定のタイプになります。
-createRepresentation(-cr)	string
アセンブリに対して特定のリプリゼンテーション タイプを作成および追加します。リプリゼンテーション タイプが追加のパラメータを必要とする場合は、「input」フラグを使用して指定する必要があります。たとえば、Maya シーン アセンブリ リファレンス実装のキャッシュおよびシーン リプリゼンテーションは入力ファイルを必要とします。
-defaultType(-dt)	string
既定のアセンブリのタイプを設定または照会します。assembly コマンドを使用してアセンブリ オブジェクトではなくアセンブリ タイプで操作を実行する場合、-type フラグを使用してアセンブリ タイプを明示的に指定しない限り、既定のタイプで実行されます。
-deleteRepresentation(-dr)	string
特定のリプリゼンテーションをアセンブリから削除します。
-deregister(-d)	string
登録されているアセンブリ タイプを登録解除します。登録解除したタイプが既定のタイプである場合、既定のタイプは空の文字列に設定されます。
-input(-in)	string
リプリゼンテーション作成時のリプリゼンテーション作成プロシージャの追加パラメータを指定します。このフラグは createRepresentation フラグと一緒に使用する必要があります。
-isAType(-isa)	string
指定したオブジェクトがアセンブリ タイプかどうかを照会します。
-isTrackingMemberEdits(-ite)	string
指定したオブジェクトがメンバー編集をトラッキングするかどうかを照会します。
-label(-lbl)	string
アセンブリ タイプのラベルを設定または照会します。アセンブリ タイプはフラグ「type」で指定されます。タイプが指定されていない場合、既定のタイプが使用されます。
-listRepTypes(-lrt)
指定したアセンブリ タイプでサポートされているリプリゼンテーション タイプを照会します。このアセンブリ タイプは、-type フラグを使用してアセンブリ タイプを明示的に指定しない限り、既定のタイプになります。
-listRepTypesProc(-lrp)	script
アセンブリ タイプでサポートされるリプリゼンテーション タイプのリストを提供するプロシージャを設定または照会します。この手順では引数を使用せず、このアセンブリ タイプで作成できるリプリゼンテーション タイプの完全なセットを表すリプリゼンテーション タイプの文字列配列を返します。このプロシージャが適用されるアセンブリ タイプは、type フラグを使用してアセンブリ タイプを明示的に指定しない限り、既定のタイプになります。
-listRepresentations(-lr)
特定のアセンブリの作成したリプリゼンテーション リストを照会します。-repType フラグを使用すると、リストをフィルタし、1つのリプリゼンテーション タイプのリプリゼンテーションを返すことができます。-repType フラグを使用しない場合、作成したすべてリプリゼンテーションが返されます。
-listTypes(-lt)
サポートされているアセンブリ タイプを照会します。
-name(-n)	string
アセンブリの作成時の名前を指定します。
-newRepLabel(-nrl)	string
リプリゼンテーション ラベルの編集時に設定するリプリゼンテーション ラベルを指定します。
-postCreateUIProc(-aoc)	script
指定したアセンブリ タイプの UI 作成後プロシージャを設定または照会します。このプロシージャは、指定したタイプのアセンブリがスクリプトではなく UI から作成されるとすぐに Maya によって起動されます。このプロシージャを使用してダイアログを起動し、新しく作成したアセンブリの初期パラメータを取得および設定することができます。このアセンブリ タイプは、-type フラグを使用してアセンブリ タイプを明示的に指定しない限り、既定のタイプになります。
-proc(-prc)	script
指定したアセンブリ タイプのリプリゼンテーション UI 作成後または作成前プロシージャを設定するときのプロシージャを指定します。このアセンブリ タイプは、-type フラグを使用してアセンブリ タイプを明示的に指定しない限り、既定のタイプになります。
-renameRepresentation(-rnr)	string
このフラグの引数であるリプリゼンテーションの名前を変更します。新しい名前を提供するには repName フラグを使用しなければなりません。
-repLabel(-rl)	string
指定したアセンブリについて、このフラグの引数であるリプリゼンテーションのラベルを照会または編集します。照会モードと編集モードの両方で、-repLabel フラグはリプリゼンテーションの名前を指定します。編集モードでは、-newRepLabel フラグを使用して新しいリプリゼンテーション ラベルを指定する必要があります。 照会モードでは、このフラグに値が必要になります。
-repName(-rnm)	string
リプリゼンテーションの作成または名前変更時に設定するリプリゼンテーション名を指定します。このフラグは createRepresentation フラグの場合にはオプションです。省略すると、アセンブリはリプリゼンテーションに名前を付けます。これは renameRepresentation フラグの場合には必須です。
-repNamespace(-rns)	string
このアセンブリ ノードのリプリゼンテーションのネームスペースを照会します。返される値は、リプリゼンテーションのアクティブ化によって作成されたノードが追加されるネームスペースを作成するために Maya で使用されます。ネームスペースが親ネームスペースに追加されたときに名前の衝突が発生した場合、Maya は新しい名前で repNamespace を更新します。アセンブリ ノードを処理するときは、(このフラグが影響しない、または照会しない)アセンブリ ノード自体のネームスペースと、そのリプリゼンテーションのネームスペースの 2 つのネームスペースが関係します。リプリゼンテーションのネームスペースは、アセンブリ ノードの子のネームスペースです。アセンブリ ノードのネームスペースは、それに含まれるアセンブリによって設定されるか(ネストされている場合)、最上位のファイルによって設定されます。アセンブリ ノードのネームスペースとリプリゼンテーションのネームスペースのいずれかまたは両方は、空の文字列にすることができます。アセンブリ ノードがネストされている場合、アセンブリ ノードのネームスペースは(そのネストにより)それに含まれるアセンブリのリプリゼンテーションのネームスペースになります。
-repPostCreateUIProc(-poc)	string
特定のリプリゼンテーション タイプ、および特定のアセンブリ タイプの UI 作成後プロシージャを設定または照会します。このプロシージャは 2 つの引数を取ります。1 つはアセンブリへの DAG パス、もう 1 つはリプリゼンテーションの名前です。値は返しません。指定したタイプのリプリゼンテーションがスクリプトからではなく UI から作成されるとすぐに Maya によって起動されます。このプロシージャを使用してダイアログを起動し、新しく作成したリプリゼンテーションの初期パラメータを取得および設定することができます。リプリゼンテーション タイプはこのフラグの引数です。プロシージャ名を指定するには、-proc フラグを使用する必要があります。このアセンブリ タイプは、-type フラグを使用してアセンブリ タイプを明示的に指定しない限り、既定のタイプになります。 照会モードでは、このフラグに値が必要になります。
-repPreCreateUIProc(-pec)	string
特定のリプリゼンテーション タイプ、および特定のアセンブリ タイプの UI 作成前プロシージャを設定または照会します。このプロシージャは引数を取らず、Maya が -createRepresentation フラグを使用して assembly コマンドを起動したときに -input フラグに引数として渡される文字列を返します。リプリゼンテーション作成前プロシージャは、指定したタイプのリプリゼンテーションがスクリプトからではなく UI から作成される直前に Maya によって起動されます。このプロシージャを使用してダイアログを起動し、新しいリプリゼンテーションの作成引数を取得することができます。リプリゼンテーション タイプはこのフラグの引数です。プロシージャ名を指定するには、-proc フラグを使用する必要があります。このアセンブリ タイプは、-type フラグを使用してアセンブリ タイプを明示的に指定しない限り、既定のタイプになります。 照会モードでは、このフラグに値が必要になります。
-repType(-rt)	string
-listRepresentations 照会でフィルタとして使用するリプリゼンテーション タイプを指定します。リプリゼンテーション タイプはこのフラグの引数です。 照会モードでは、このフラグに値が必要になります。
-repTypeLabel(-rtl)	string
特定のリプリゼンテーション タイプのラベルを照会します。 照会モードでは、このフラグに値が必要になります。
-repTypeLabelProc(-rtp)	script
指定したアセンブリ タイプで、リプリゼンテーション タイプのラベルを提供するプロシージャを設定または照会します。プロシージャはリプリゼンテーション タイプを唯一の引数として取り、ローカライズされたリプリゼンテーション タイプのラベルを返します。このプロシージャが適用されるアセンブリ タイプは、-type フラグを使用してアセンブリ タイプを明示的に指定しない限り、既定のタイプになります。
-type(-typ)	string
指定した登録されているアセンブリ タイプのプロパティを設定または照会します。 照会モードでは、このフラグに値が必要になります。

フラグはコマンドの作成モードで表示できます	フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます	コマンド内でフラグを複数回使用できます。

MEL 例

//Create a default type of assembly and name it MyAssembly.
//The assembly name is optional.
//
assembly -name "MyAssembly";
//Create an assembly of type MyAssemblyType and name it MyAssembly.
//
assembly -name "MyAssembly" -type "MyAssemblyType"
//Set the default type to be MyAssemblyType.
//
assembly -edit -defaultType MyAssemblyType;
//Create a representation of type "MyRepType", on assembly myAssembly, and
//name it "MyRepName"
assembly -edit -createRepresentation "MyRepType" -repName "MyRepName" myAssembly
//Rename representation "MyRepName" to "MyNewRepName" on assembly myAssembly.
assembly -edit -renameRepresentation "MyRepName" -repName "MyNewRepName" myAssembly
//Create a representation of type "Locator", on assembly myAssembly, name it
//"myLocator", and add an annotation using the input flag.
assembly -edit -createRepresentation "Locator" -repName "myLocator" -input "An Annotation" myAssembly
//Create a representation of type "Scene", on assembly myAssembly,
//using file "/path/to/mayafile.mb"
assembly -edit -createRepresentation "Scene" -input "/path/to/mayafile.mb" myAssembly
//Delete scene representation from assembly myAssembly
assembly -edit -deleteRepresentation "mayafile.mb" myAssembly
//Delete locator representation from assembly myAssembly
assembly -edit -deleteRepresentation "myLocator" myAssembly
//Set the procedure that provides the representation type label for
//an assembly type.
//
assembly -edit -repTypeLabelProc "MyRepTypeLabelQuery" -type "MyAssembly";
//Set the label for the default assembly type.
//
assembly -edit -label "My Assembly Type";
//Set the procedure that provides the representation type list which the
//default assembly supports.
//
assembly -edit -listRepTypesProc "MyRepTypesProc";
//Set the pre-create UI procedure for a representation type, for a
//specific type of assembly.
//
assembly -edit -repPreCreateUIProc MyRepresentation -proc "MyPreCreateProcedure" -type "MyAssembly";
//Set the post-create UI procedure for a representation type, for the
//default assembly type.
//
assembly -edit -repPostCreateUIProc MyRepresentation -proc "MyPostCreateProcedure";