ArrayParameter 値

3ds Max の一部のプラグインでは、パラメータ データは MAXScript がアクセス可能な形式で ArrayParameters として保存されます。このため、インデックスでパラメータ データにアクセスし、パラメータ データを反復できます。

コンストラクタ

<MAXWrapper>.parameter

parameter には ArrayParameter が含まれます。

プロパティ

<ArrayParameter>.count

ArrayParameter 内の値の数を返します。調整可能な ArrayParameter が使用されている場所は、MAXWrapper オブジェクトで特に明記していない限り読み込み専用です。

オペレータ

<ArrayParameter>[<integer>]

ArrayParameter の要素を返します。インデックスは 1 から始まります。

<ArrayParameter>[<integer>] = <value>

ArrayParameter の要素を値に設定します。

各 ArrayParameter には、特定のタイプ(浮動小数点など)のデータだけ、またはそのデータ タイプに一致するコントローラだけを含めることができます。showProperties() 関数は、これらの配列パラメータを <type> array で示します。 たとえば、int array、texmap array のようになります。

プラグインでは、ArrayParameter 中の特定のエントリ 1 つをポイントするパラメータ名も定義できます。たとえば、mapAmounts は、ArrayParameter を含む標準マテリアルのプロパティになります。この ArrayParameter 内の各要素には、1 つのマップ チャネルに対するマップ量が含まれます。スクリプト内で簡単にアクセスできるよう、標準 .ambientMapAmount プロパティが mapAmounts\[1\] のエイリアスとして(その他のすべての一般的なマップのエイリアスとともに)提供されます。ambientMapAmount エイリアスのコントローラには、エイリアス上の .controller プロパティあるいは .mapAmounts\[1\] プロパティのいずれかによってアクセスできます。

例:

次のいずれかです。

   $foo.material.ambientMapAmount.controller

または

   $foo.material.mapAmounts[1].controller

これらは、周囲光のマップ量マテリアル プロパティのコントローラを取得できます。

3ds Max 6 以降では、ArrayParameter 値を強制的に Array に置き換えることができます。

例

   mtl = standard()
   mapsArray = mtl.maps as array

次のスクリプトでは、ArrayParameter の要素のデータ タイプを表示する際に、ArrayParameter 要素へアクセスする場合と、プラグインで ArrayParameter の中の 1 つの特定のエントリをポイントするパラメータ名を定義している場合の showProperties() の使い方を示します。

スクリプト

   m=CompositeMaterial() -- create a Composite material
   showproperties m -- show the properties for the material
   m.amount -- show value of parameter amount
   m.amount[1] *= .5 -- reduce the value for one element
   m=standard() -- create a Standard material
   showproperties m -- show it’s properties
   m.ambientMapAmount=13 -- set the value for one element via its alias
   m.mapAmounts[1] -- and show the element was changed

出力

   compositematerial:Composite -- result line 1
   .materialList (Material : material array -- output line 2
   .mixType (Composite Type) : int array -- ArrayParameter elements are integer
   .mapEnables (Map Enable) : boolean array -- ArrayParameter elements are boolean
   .amount : float array -- ArrayParameter elements are float
   OK -- result line 2
   #(100, 100, 100, 100, 100, 100, 100, 100, 100, 100) -- result line 3
   50.0 -- result line 4
   Standardmaterial:Standard -- result line 5
   .mapEnables (Map Enables) : boolean array -- pruned output line 6
   .maps : texmap array
   .mapAmounts (Map Amounts) : percent array
   .ambientMap (alias for maps[0])
   .ambientMapAmount (alias for mapAmounts[0])
   .ambientMapEnable (alias for mapEnables[0])
   .bumpMap (alias for maps[8])
   .bumpMapAmount (alias for mapAmounts[8])
   .bumpMapEnable (alias for mapEnables[8])
   13 -- result line 7
   13.0 -- result line 8
親ページ: Values