環境効果の共通プロパティ、演算子、メソッド

値 > MAXWrapper >Atmospheric > 共通プロパティ、演算子、メソッド

環境効果には、次のような共通プロパティ、演算子、メソッドがあります。

プロパティ

<atmos>.name String default: varies

[環境](Environment)ダイアログリストに表示される名前です。生成パラメータ name: を指定しない場合、既定のクラス名が使用されます。

<atmos>.numGizmos Integer -- read-only

環境効果に割り当てられているギズモの数です。取得したギズモ( getGizmo を使って取得)が、定義されていないことがあります。これは、そのギズモがいったん追加された後で削除されたことを意味します。環境効果では、ギズモの配列が管理されます。すべてのスロットが使用されているとは限りません。 numGizmos は、使用されたスロットの数ではなく、配列のサイズを表します。

メソッド

isActive <atmos>

環境効果がアクティブに設定されている場合は true を、非アクティブの場合は false を返します。

getGizmo <atmos> <index_integer>

インデックスで指定された環境効果のギズモノードを取得します。ギズモノードは、ライトまたは環境効果ヘルパーです。インデックスの基数は 1 です。

deleteGizmo <atmos> <index_integer>

インデックスで指定された環境効果のギズモを削除します。

appendGizmo <atmos> <node>

環境効果のギズモリストにノードを付加します。これは環境効果に適した種類でなければなりません (ボリュームライトのライト、fire_effect のヘルパーギズモなど)。

setActive <atmos> <boolean>

環境効果をアクティブまたは非アクティブに設定します。 <boolean> が true の場合、環境効果がアクティブに設定されます。 false の場合、非アクティブに設定されます。

例

atmos = fire_effect density:20 outer_color:red
appendGizmo atmos $SphereGizmo01

関連するメソッド

次の関数を使うと、グローバルレンダリング環境に環境効果のリストを保持することができます。

addAtmospheric <atmos>

指定された環境効果を[環境効果](Atmospheric Effects)リストに追加します。

getAtmospheric <index_integer>

setAtmospheric <index_integer> <atmos>

[環境効果](Atmospheric Effects)リストのインデックスの位置の環境効果を指定された環境効果に設定します。[環境効果](Atmospheric Effects)ダイアログボックスを表示中にこのメソッドを呼び出すと、表示中の[環境効果](Atmospheric Effects)リストは更新されません。

deleteAtmospheric <index_integer>

[環境効果](Atmospheric Effects)リストのインデックスの位置にある環境効果を削除します。インデックスは基数 1 です。

editAtmosphere <atmos> <node>

[環境](Environment)ダイアログボックスを開き、指定された環境効果のロールアウトが[環境効果](Atmospheric Effects)リストに追加されている場合は、そのロールアウトを開きます。指定されたノードが環境効果のギズモの場合は、そのギズモが環境効果のギズモリストから選択されます。

editAtmospheric <atmos> [gizmo: <node>]

[環境](Environment)ダイアログボックスを開き、指定された環境効果のロールアウトが[環境効果](Atmospheric Effects)リストに追加されている場合は、そのロールアウトを開きます。オプションの gizmo: 引数が指定された場合、指定したノードが環境効果のギズモとなり、環境効果のギズモリスト内でそのギズモが選択されます。

3ds Max 6 以上で editAtmosphere() または editAtmospheric() を引数なしで呼び出すと[環境](Environment)ダイアログボックスが開きます。

システムグローバル変数:

numAtmospherics

この 3ds Max のシステムグローバル変数には、[環境と効果](Environment And Effects)ダイアログボックスの効果リスト上の環境効果の数が含まれます。この値は読み取り専用です。

注:

その他多くの MAXWrapper オブジェクトとは異なり、環境効果をコピーすることはできません。

環境効果の共通プロパティ、演算子、メソッド

関連事項