カスタム アトリビュートを追加する

custAttributes.add <object_or_collection> <attributes_definition> [		#unique] [		BaseObject:<bool>] 	 

オブジェクトまたはコレクションにアトリビュートのセットを追加します。特定のアトリビュート定義のカスタム アトリビュート セットのうち、オブジェクトに追加できるのは 1 つだけです。ただし、異なる複数の定義から取得したさまざまなアトリビュートを、必要な数だけ持つことができます。 

#unique 

custAttributes.add() 関数を使ってオブジェクトにカスタム アトリビュートを追加する場合、オプションの #unique キーワードを 3 番目の引数として指定できます。これを実行する場合、追加先の各オブジェクトには、定義の独自プライベート コピーを含むカスタム アトリビュートが追加されることになるため、元の定義は共有 されません 。元のアトリビュート定義を後で再定義しても、これらのカスタム アトリビュートは更新されません。個々のオブジェクトのアトリビュートを更新するには、 custAttributes.getDef を使ってオブジェクトから一意の定義を取得し、次の 2 つの方法のいずれかを使用して再定義します。

BaseObject:<bool> 

オプションのキーワード引数 baseObject が true (既定値)に設定されている場合、指定されているオブジェクトがノードであれば、そこでは基本オブジェクトが動作します。 false の場合、ノードそのものがそこで動作します。

custAttributes.add $weapon01 weaponData

custAttributes.add() 関数をオブジェクト コレクションに適用して、オブジェクト グループにアトリビュート セットを一度に追加することができます。

custAttributes.add $weapon* the_weaponData

スクリプト プラグイン と同様に、アトリビュート定義はパラメータおよびロールアウト句のセットを任意の数だけ保持できるため、追加されたアトリビュートを必要に応じて複数のロールアウトに整理できます。

MAXScript では、オブジェクトまたはモディファイヤに追加されたスクリプト カスタム アトリビュートにアクセスできます。これらには、追加先のオブジェクトのプロパティとして直接アクセスできます。カスタム アトリビュートのすべての名前がホスト オブジェクトの既存のプロパティと同じ名前の場合、カスタム アトリビュートに直接アクセスしようとしても、カスタム アトリビュートは実際には表示されません。代わりに、そのアトリビュート定義名によって追加された各カスタム アトリビュート ブロックにアクセスできます。その際、個々のアトリビュートにはブロック内のプロパティとしてアクセスできます。

the_weaponData = attributes weaponData
(
parameters main rollout:params
(
hitPoints type: #float ui:hits default:10
cost type: #float ui:cost default:100
sound type: #string
)
rollout params "Weapon Parameters"
( 
	 spinner hits "Hit Points" type: #float
  spinner cost "Cost" type: #float
  dropdownlist sound_dd "Sound" items:# ("boom","sparkle","zap","fizzle")
 )
)

$box01.hitPoints 
$box01.cost 
$box01.sound 

$box01.weaponData.hitPoints 
$box01.weaponData.cost 
$box01.weaponData.sound 

次のトピック

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