グローバルおよびプライベート カスタム アトリビュートの定義

スクリプト カスタム アトリビュートは、シーン ファイルに正しく保存され、シーン ファイルから正しくロードされます。

固定のグローバル定義 ID をアトリビュート定義に割り当てることができます。

これは、スクリプト プラグインでのクラス ID と同じように作用します。このような定義はカスタム アトリビュートがあるシーン全体にわたってグローバルであるため、グローバル定義のカスタム アトリビュートのインスタンスはすべて同じ形状を持つことになります。この ID は新しいヘッダ パラメータ attribID: を使用して指定します。

attributes <name> attribID: #(<number>, <number>) ( ... ) 				  

MAXScript では、ID 番号のペアは通常 genClassID() 関数を使って生成されるため、一意に選択されます。attribID を含まないアトリビュート定義は、現在の MAX セッションで対してプライベートです。

genClassID [	 returnValue:<boolean>]   

このメソッドは、#(0x9b7ea231, 0xb6db86ef) のようなランダム クラス ID を生成し、それをリスナーに印刷します。このクラス ID を切り取ってスクリプトに貼り付け、生成された ID を使用することができます。オプションの returnValue キーワードを true に設定すると、メソッド呼び出しの結果として値が返されます。

定義はグローバルかプライベートかによって識別されます。

グローバル定義には、グローバルに一意な ID を定義する明示的な attribID: パラメータがあります。これにより、この ID 定義に基づくカスタム アトリビュートを保持するオブジェクトは、確実に同じ定義に従うことになります。特定の attribID: を持つアトリビュート定義を評価するときは常に、その定義に基づくカスタム アトリビュートを持つ全オブジェクトを更新することになり、その attribID のアトリビュートを持つオブジェクトをロードすると、それ自体が現在の定義に更新されます。

プライベート定義には、明示的な attribID: パラメータがありません (実際には、内部的に生成されるランダムなパラメータが含まれます)。以下の再定義で説明されている場合を除き、評価するたびに、独自の内部 ID を使用して完全に別個の定義が作成されます。

グローバル定義とプライベート定義では両方とも、「アトリビュート」定義構文が値として定義を返します。通常はその値をローカルに割り当て、それを使って custAttributes.add () 関数を介してカスタム アトリビュートをオブジェクトに追加します。

local def
def = attributes "Game Data"
(
parameters ...
rollout ...
)
custAttributes.add $box01 def
custAttributes.add $box02 def

この例では、定義されたカスタム アトリビュートの個々のセットを、box01 と box02 に追加しています。この定義は 2 つのボックス間で共有されます。

これはプライベート定義であり、attribID: はありません。このため、再度「def = attributes (...)」を評価する場合、box01 と box02 のアトリビュートは自動的には 更新されず 、前回構築時の更新が使われます。 ただし、定義は新規作成されます。

attributes "Game Data"
redefine:def
(
parameters ...
rollout ...
)

custAttributes.redefine <def> <definition_string>   

local new_def = "attributes \"Game Data\" ( ... )"
custAttributes.re define def new_def

old_def = custAttributes.getDef $box03 1 -- get existing def
old_def_data = custAttributes.getDefData old_def -- get my defData from it
new_def_string = generate_new_def old_def_data ... -- make new def string
custAttributes.redefine old_def new_def_string -- redefine it