3ds Max システムのグローバル変数を使用すると、3ds Max システムの状態に関する情報にアクセスすることができます。

読み込み専用と記述されている場合以外は、グローバル変数に対してアクセスと代入の両方を行うことができます。

• A
• B
• C
• D
• E
• F
• G
• H
• K
• L
• M
• N
• P
• R
• S
• T
• U
• V
• スキャンライン レンダラー固有のシステム グローバル変数

A

activeGrid 

現在アクティブなグリッドが含まれます。ホーム グリッドがアクティブの場合、undefined を返します。

グリッド ノード オブジェクトをこの変数に代入すると、現在のアクティブなグリッドにすることができます。

「ビューポート グリッド」を参照してください。

activegrid = undefined を設定してホーム グリッドに戻ることもできます。

ambientColor 

グローバル レンダリング環境([レンダリング] (Rendering) > [環境] (Environment))の周囲光カラーを定義するカラー値を取得/設定します。

「[環境と効果](Environment and Effects)ダイアログ ボックス」を参照してください。

ambientColorController 

グローバル レンダリング環境([レンダリング] (Rendering) > [環境] (Environment))の周囲光カラー コントローラを定義するコントローラを取得/設定します。

「[環境と効果](Environment and Effects)ダイアログ ボックス」を参照してください。

animateMode

現在のオート キー アニメーション モードを取得または設定します。

animationRange 

現在アクティブなアニメーション範囲の開始および終了位置を定義する間隔値を取得/設定します。

この値は、[時間設定](Time Configuration)ダイアログ ボックスで設定した値と同じです。

「[時間設定](Time Configuration)ダイアログ ボックス」を参照してください。

animButtonEnabled 

ユーザが[アニメート] (Animate)ボタンの状態を変更できるかどうかを指定するブール値です。

false に設定すると、[アニメート] (Animate)ボタンの状態を変更することはできません。

true に設定すると、[アニメート] (Animate)ボタンの状態を変更できます。

スクリプトでは、animButtonEnabled 値に関係なく、animButtonState を使って[アニメート] (Animate)ボタンの状態を変更できます。

「時間コントロール」を参照してください。

animButtonState 

[アニメート] (Animate)ボタンの状態を取得/設定します。

ブール値です。[アニメート] (Animate)がオンの場合は true、オフの場合 false です。

「時間コントロール」を参照してください。

autoBackup.enabled 

自動バックアップが使用可能かどうかを <boolean> で取得/設定します。

autoBackup.time 

自動バックアップの分単位の時間間隔を <integer> で取得/設定します。

B

backgroundColor 

グローバル レンダリング環境([レンダリング] (Rendering) > [環境] (Environment))におけるバックグラウンドのカラーを定義する Color 値を取得/設定します。

「[環境と効果](Environment and Effects)ダイアログ ボックス」を参照してください。

backgroundColorController 

グローバル レンダリング環境([レンダリング] (Rendering) > [環境] (Environment))のバックグラウンド カラー コントローラを定義するコントローラ値を取得および設定します。

「[環境と効果](Environment and Effects)ダイアログ ボックス」を参照してください。

backgroundImageFileName 

ビューポート バックグラウンド イメージのビットマップ ファイル名を定義する文字列値を取得および設定します。

この変数には、[ビューポート バックグラウンド](Viewport Background)ダイアログ ボックスに設定されたビットマップ ファイル名が含まれます。

「ビューポート バックグラウンド イメージ」を参照してください。

C

cui.commandPanelOpen 

コマンド パネルを表示するかどうかを取得および設定します。

ブール値です。コマンド パネルが表示される場合は true、表示されない場合は false です。

「コマンド パネル」を参照してください。

currentMaterialLibrary 

現在開いているマテリアル ライブラリに対応するマテリアルの仮想配列と、ルート レベルのマップが含まれています。

ライブラリのマテリアルは配列のインデックスによって取得でき、for ループで繰り返し使用できます。

配列は番号や名前でインデックスを付けることができ、文字列を使用してマテリアル名を選択することが可能です。

この変数は読み取り専用です。「MaterialLibrary 値」を参照してください。

D

displayGamma 

ガンマの基本設定を定義する実数値を表示します。

これには、[基本設定] (Preferences)ダイアログ ボックスの[ガンマ] (Gamma)タブで設定した対応値が含まれます。

このグローバル変数を使って、MAXScript によって作成したビットマップにガンマを設定できます。

例:

b = bitmap 320 240 gamma:displayGamma
render camera:c to:b

これにより、レンダリングされたビットマップがロールアウト ビットマップ、またはボタン イメージとして使われている場合に、それを現在のディスプレイ ガンマ設定で表示します。

ガンマ関係のプロパティとメソッドの詳細については、「fileInGamma」、「fileOutGamma」、および「インタフェース: IDisplayGamma」も参照してください。

displaySafeFrames 

アクティブなビューポートに対して[セーフ フレーム表示]がオンであるかどうかを取得/設定します。

ブール値です。[セーフ フレーム表示]がオンの場合 true、オフの場合 false です。

E

environmentMap 

グローバル レンダリング環境([レンダリング] (Rendering) > [環境] (Environment))の環境マップを定義する TextureMap 値を取得/設定します。

「[環境と効果](Environment and Effects)ダイアログ ボックス」を参照してください。

環境マップのオン/オフ状態のコントロールについては、システム グローバル変数「useEnvironmentMap」 も参照してください。

errTracebackDisabled

ランタイム エラーが発生する式を実行する直前に、このグローバル変数を設定して、エラー トレースバックをリスナーに送信するかどうかをコントロールします。内部またはテスト目的での使用に限ります。

F

flyOffTime 

フライアウトをアクティブにするために、フライアウト上でマウスのボタンを押し続ける必要のある時間をミリ秒で定義する整数値を取得/設定します。

この変数には、[基本設定] (Preferences)ダイアログ ボックスの[一般] (General)タブで設定した対応値が含まれます。

システム グローバル変数 preferences.flyOffTime と同じです。

 fileInGamma fileOutGamma 

ガンマの基本設定を定義する実数値を取得/設定します。

これには、[基本設定] (Preferences)ダイアログ ボックスの[ガンマ] (Gamma)タブで設定した対応値が含まれます。

これらのグローバル変数を使って、MAXScript によって作成したビットマップにガンマを設定できます。

「displayGamma」も参照してください。

frameRate 

現在のシーンのフレーム レートを定義する整数値(1 秒間のフレーム数)を取得/設定します。

この値は、[時間設定](Time Configuration)ダイアログ ボックスで設定した値と同じです。

「[時間設定](Time Configuration)ダイアログ ボックス」を参照してください。

G

globalTracks 

トップ レベルのグローバル トラック ノードを定義する MAXTVNode 値がトラック ビューに含まれます。

この変数は読み取り専用です。

「トラック ビュー ノード」を参照してください。

H

hardwareLockID 

3ds Max ハードウェアのロック ID を定義する整数値が含まれます。

この変数は読み取り専用です。

hotspotAngleSeparation 

[ホットスポット/フォールオフの角度差](Hot Spot/FallOff Angle Separation)の値を定義する実数値が含まれます。

この変数には、[基本設定] (Preferences)ダイアログ ボックスの[レンダリング] (Rendering)タブで設定した対応値が含まれます。

この変数は読み取り専用です。

K

keyboard.shiftPressed keyboard.controlPressed keyboard.altPressed keyboard.escPressed 

これらの読み取り専用変数は、[Shift]、[Ctrl]、[Alt]、[Esc]キーの現在の状態にアクセスします。

変数を読み込んだときのキーの状態に応じて true または false を返します。

L

lightLevel 

グローバル レンダリング環境([レンダリング] (Rendering) > [環境] (Environment))の[グローバル照明のティント レベル](Global Lighting Tint Level)を定義する実数値を取得/設定します。

「[環境と効果](Environment and Effects)ダイアログ ボックス」を参照してください。

lightLevelController 

グローバル レンダリング環境([レンダリング] (Rendering) > [環境] (Environment))の[グローバル照明のティント レベル](Global Lighting Tint Level)コントローラを定義するコントローラ値を取得/設定します。

「[環境と効果](Environment and Effects)ダイアログ ボックス」を参照してください。

lightTintColor 

グローバル レンダリング環境([レンダリング] (Rendering) > [環境] (Environment))の[グローバル照明のティント カラー](Global Lighting Tint color)を定義するカラー値を取得/設定します。

「[環境と効果](Environment and Effects)ダイアログ ボックス」を参照してください。

lightTintColorController 

グローバル レンダリング環境([レンダリング] (Rendering) > [環境] (Environment))の[グローバル照明のティント カラー](Global Lighting Tint color)コントローラを定義するコントローラ値を取得/設定します。

「[環境と効果](Environment and Effects)ダイアログ ボックス」を参照してください。

listener 

読み込み専用のシステム グローバル変数です。リスナー編集ウィンドウの WindowStream 値です。

localTime 

現在のローカルの日付と時間を定義する文字列値が含まれます。

この変数は読み取り専用です。

以下に、localtime に保管される値の例を示します。

s = localTime
"4/14/97 10:24:57 AM"

この文字列のフォーマットは、Windows の地域設定コントロール パネルで選択した日付フォーマットによりコントロールされます。

「ローカル時間とユニバーサル時間」も参照してください。

logsystem.quietmode 

エラー ログ抑制モードが有効であるかどうかを取得/設定します。

この変数はブール値で、true に設定すると、レンダラーからのメッセージを表示するダイアログ ボックスが開きません。

false に設定すると、レンダラーからのエラー メッセージを表示するダイアログ ボックスが開きます。

ネットワーク レンダリングの実行中は、対応する内部変数が 3ds Max によって true に設定され、「マップがありません」や「マップ座標がありません」などのエラー メッセージは表示されません。

この変数を true に設定すると、レンダラーはエラー メッセージを生成して終了します。

抑制モードが有効に設定されていると、ユーザはレンダラーからのエラー メッセージを確認できません。抑制モードを終了したら、必ず抑制モードを無効にしてください。

ログ システム関係のメソッドについては、「logsystem_Struct」も参照してください。

M

macroRecorder 

読み取り専用のシステム グローバル変数です。マクロ レコーダ編集ウィンドウの WindowStream 値です。

manipulateMode 

3ds Max 操作モードを取得/設定します。

true の場合、操作モードはアクティブです。

詳細については、「スクリプト化されたマニピュレータ」のトピックを参照してください。

maxFileName 

現在開いているシーンのファイル名を定義する文字列値が含まれています。

この変数は読み取り専用です。

「現在のシーンのファイル名を取得する方法を教えてください」(よくある質問(FAQ))と「3ds Max ファイルのロードと保存」を参照してください。

maxFilePath 

現在開いているシーンのディレクトリ パスを定義する文字列値が含まれています。

この変数は読み取り専用です。

maxOps.productAppID : enum : Read productAppID enums: {#none|#max|#viz|#gmax} 

返される enum 値は、以下のとおりです。

#none - ID なし

#max - 3ds Max

#viz - Autodesk VIZ

#gmax - gmax

meditMaterials 

マテリアル エディタのスロットに対応するマテリアルの仮想配列とルート レベルのマップが含まれています。

マテリアル エディタのマテリアルとルート レベルのマップへは、配列のインデックスからアクセスし、for ループで繰り返し使用できます。

配列はスロット番号を指定する番号や、名前、またはマテリアルやルート レベル マップの名前を選択する文字列でインデックスできます。

例

b=box()
b.material = meditMaterials[1]
meditMaterials["01 - Default"].diffuse = red
for m in meditMaterials do print m.diffuseMap
meditMaterials[1]=standard()
print meditMaterials.count-- number of slots

この変数は読み込み専用ですが、要素(スロット内のマテリアル)は割り当て可能です。

「MaterialLibrary 値」を参照してください。

マテリアルとマップをマテリアル エディタ スロットに割り当てる方法については、「マテリアル エディタ」を参照してください。

N

numEffects

[レンダリング] (Rendering) > [効果] (Effects)ダイアログ ボックス リストで定義されている現在のレンダリング効果の数を定義する整数値が含まれます。

この変数は読み取り専用です。

「RenderEffect」を参照してください。

numAtmospherics 

[レンダリング] (Rendering) > [環境] (Environment)に表示されている環境効果イベントの数を定義する整数値が含まれます。

この変数は読み取り専用です。

「[環境と効果](Environment and Effects)ダイアログ ボックス」を参照してください。

numSubObjectLevels 

モディファイヤ スタックで現在選択されているオブジェクトまたはモディファイヤによって、サポートされているサブオブジェクトのレベル数を取得します。

[修正] (Modify)パネルが開いていない場合、またはオブジェクトが選択されていない場合、グローバル変数の値は undefined になります。「[修正] (Modify)パネル」を参照してください。

subObjectLevel および numSubObjectLevels システム グローバル変数は、[モーション] (Motion)パネルで「undefined」以外の値を返します。

[モーション] (Motion)パネルの最上部には、[選択レベル](Selection Level)/[サブオブジェクト] (Sub-Object)ドロップダウン リストがあります。このオプションは、[軌道] (Trajectory)モードの場合に、[Keys SO]モードのインとアウトを切り替えます。

このため、テスト(subobjectlevel != undefined)を実行しても、[修正] (Modify)パネルが開いているかどうかは確認できません。

代わりに、test (getCommandPanelTaskMode() == #modify) を使用します。

P

playActiveOnly 

アクティブなビューポートのみを再生するかどうかを取得/設定します。

この値は、[時間設定](Time Configuration)ダイアログ ボックスで設定した値と同じです。

ブール値です。[アクティブ ビューポートのみ再生](Active Viewport Only)がオンの場合は true、オフの場合は false です。「[時間設定](Time Configuration)ダイアログ ボックス」を参照してください。

preferences.autoKeyDefaultKeyOn 

このシステム グローバル変数は、キーを持たないコントローラが preferences.autoKeyDefaultKeyTime で設定された値と異なる時刻にオート キー モードでアニメートされる場合に、現在の値を持つ既定のキーが作成されるかどうかをコントロールします。3ds Max 2017 以降で使用可能です。

メイン メニュー > [カスタマイズ] (Customize) > [基本設定] (Preferences) > [アニメーション] (Animation) > [オート キー既定フレーム](Auto Key Default Frame)コントロール グループに表示されるチェックボックスに対応しています。

既定値は True です。

False に設定すると、新しいキーは現在時刻にのみ作成され、コントローラの元の値は失われます。

preferences.autoKeyDefaultKeyTime 

このシステム グローバル変数は、キーを持たないコントローラが異なる時刻にオート キー モードでアニメートされる場合に、現在の値を持つ既定のキーが作成されるフレームをコントロールします。3ds Max 2017 以降で使用可能です。

メイン メニュー > [カスタマイズ] (Customize) > [基本設定] (Preferences) > [アニメーション] (Animation) > [オート キー既定フレーム](Auto Key Default Frame)コントロール グループに表示される値スピナーに対応しています。

既定値は 0 です。

この値は任意の有効なフレーム番号に設定できます。

3ds Max 2017 より前のバージョンでは、既定のキー タイムの有効な設定値は 0 または 1 のみです。

preferences.constantReferenceSystem 

3ds Max ツールバーの[移動] (Move)、[回転] (Rotate)、[スケール] (Scale)ツールに同じ座標系を使用するかどうかを取得/設定します。

ブール値です。[一定] (Constant)がオンの場合は true、オフの場合は false です。

この変数は、[カスタマイズ] (Customize) > [基本設定] (Preferences)の[一般] (General)ページにある[一定] (Constant)チェック ボックスの状態と一致します。

preferences.displayCollapseMessage

3ds Max 2024 の新機能: スタック集約の警告の表示/非表示を切り替えます。この警告は、モディファイヤ スタックの集約を選択すると表示されます。警告ダイアログ ボックスでこの警告をオフにできます。既定値は true です。

この設定は、[基本設定](Preference Settings)ダイアログ ボックスの[一般] (General)タブにある[スタック集約の警告を表示](Display Stack Collapse Warning)設定と同じです。

preferences.displayTopoMessage

3ds Max 2024 の新機能: トポロジ従属の警告の表示/非表示を切り替えます。モディファイヤとサブオブジェクト選択のあるオブジェクトで、モディファイヤ スタックの一番下のベース オブジェクトまたはモディファイヤを編集しようとすると、この警告が表示されます。これは、そうした編集がオブジェクト トポロジに負の影響を及ぼす可能性があるためです。警告ダイアログ ボックスでこの警告をオフにできます。既定値は true です。

この設定は、[基本設定](Preference Settings)ダイアログ ボックスの[一般] (General)タブにある[トポロジ従属の警告を表示](Display Topology-Dependence Warning)設定と同じです。

preferences.displayScriptEditorOnError

3ds Max 2024 の新機能: スクリプト エディタでエラーが発生したときにスクリプトを表示するかどうかを指定するブール値です。この設定は、[カスタマイズ] (Customize) > [基本設定] (Preferences)ダイアログ ボックスの[MAXScript]タブにも表示され、設定がセッション全体で保持されます。この設定は、scriptEditor.displayOnError のように表示されることもあります。

preferences.dontRepeatRefMsg 

参照メッセージの伝達に関連するメッセージ通知システムの最適化が 3ds Max 6 に導入され、既定で有効になりました。この最適化を行うと、同じ参照変更メッセージが同じオブジェクトに繰り返し送信されることがなくなります。この最適化により、複数のアニメーション コントローラを使用する複雑なリグを使用する場合や、1 回の変更で多数の参照変更メッセージが送信されることがある場合などに、処理速度が向上します。

true に設定した場合、最適化が使用可能になり、重複した通知が送信されなくなります。

false に設定した場合、システムは 3ds Max 5 以前と同様に動作します。

preferences.EnableOptimizeDependentNotifications 

内部でのみ使用されます。

関連するメソッド:

<array>GetOptimizeDependentNotificationsStatistics() 

最適化された従属通知統計を 2 つの Integer64 値からなる配列として返します。

<void>ResetOptimizeDependentNotificationsStatistics()

統計カウンタをゼロにリセットします。

preferences.flyOffTime 

フライアウトをアクティブにするために、フライアウト上でマウスのボタンを押し続ける必要のある時間をミリ秒で定義する整数値を取得/設定します。

この変数には、[カスタマイズ] (Customize) > [基本設定] (Preferences)の[一般] (General)ページで設定した対応値が含まれます。

システム グローバル変数 flyOffTime と同じです。

preferences.InvalidateTMOpt 

3ds Max 7 では、ノードが変更されたという通知をその従属ノートに送信する前に、ノードが既に無効になっているかどうかを調べる最適化が導入されました。特に新しいエクスポーズ トランスフォーム ヘルパーを含んだ複雑な装置を高速化しています。

true に設定した場合、最適化が有効になり、複数の通知は送信されません。

false に設定した場合、アニメーション システムは 3ds Max 6 以前と同様に動作します。

既定値は true です。

preferences.maximumGBufferLayers 

レンダリング中に生成される G バッファ レイヤの最大値を指定する整数値を取得/設定します。

preferences.playPreviewWhenDone 

createPreview() によって作成されたプレビューを自動的に再生または表示するか、[プレビューを作成](Make Preview)ダイアログ ボックスを使用するかを指定します。

3ds Max 2020 以降で使用可能です。

preferences.spinnerWrap 

スピナーの値をドラッグして調整するとき、カーソルの位置合わせをスピナーの近くの領域に制限するかどうかを定義するブール値を取得/設定します。

この変数には、[カスタマイズ] (Customize) > [基本設定] (Preferences)の[一般] (General)ページで設定した対応値が含まれます。

preferences.spinnerPrecision 

この整数値は、スピナーが表示する 10 進数の桁数を定義する整数値です。

[カスタマイズ] (Customize) > [基本設定] (Preferences) > [一般] (General)の[スピナー] (Spinners)領域の[精度] (Precision)値に相当します。

preferences.spinnerSnap 

この浮動小数点値は、スピナーのスナップ値を定義します。

[カスタマイズ] (Customize) > [基本設定] (Preferences) > [一般] (General)の[スピナー] (Spinners)領域の[スナップ] (Snap)値に相当します。

preferences.useSpinnerSnap 

このブール値は、スピナー スナップを使用するかどうかを定義します。

[カスタマイズ] (Customize) > [基本設定] (Preferences) > [一般] (General)の[スピナー] (Spinners)領域の[スナップを使用](Use Snap)チェックボックスに相当します。

preferences.useLargeVertexDots 

頂点をドットとして表示する場合に、小さなドットを使用するか、大きなドットを使用するかを取得および設定します。

この変数はブール値で、頂点をドットとして表示するときに、大きなドットにする場合 true です。

この変数の値は、UseVertexDots が true に設定されている場合にのみ有効です。

この変数には、[カスタマイズ] (Customize) > [基本設定] (Preferences)の[ビューポート] (Viewports)ページで設定した対応値が含まれます。

preferences.useTransformGizmos 

[変換ギズモ](Transform Gizmos)を使用するかどうかを取得/設定します。

ブール値です。オンの場合は true、オフの場合は false です。

この変数には、[カスタマイズ] (Customize) > [基本設定] (Preferences)の[ビューポート] (Viewports)ページで設定した対応値が含まれます。

preferences.useVertexDots 

頂点をドットとして表示するかどうかを取得および設定します。

この変数はブール値で、メッシュで頂点をドットとして表示する場合 true です。false に設定されている場合、ティックが使用されます。

この変数には、[カスタマイズ] (Customize) > [基本設定] (Preferences)の[ビューポート] (Viewports)ページで設定した対応値が含まれます。

R

realTimePlayback 

リアルタイム モードで再生するかどうかを取得/設定します。この値は、[時間設定](Time Configuration)ダイアログ ボックスで設定した値と同じです。

ブール値です。[リアルタイム](Real Time) がオンの場合は true、オフの場合は false になります。

「[時間設定](Time Configuration)ダイアログ ボックス」を参照してください。

renderer 

3ds Max 6 以前のバージョンでは、このグローバル変数は、レンダラーのタイプ(#production または #draft)を取得/設定するために使用されていました。

#draft レンダラー オプションは、3ds Max 6 から削除され、この変数は廃止されています。

現在は #production を受けとって返すだけであり、この値をチェックしていた以前のバージョンとのスクリプトの後方互換性のために残されています。

renderDisplacements 

レンダリング中にディスプレイスメント マッピングを実行するかどうかを取得/設定します。

ブール値です。ディスプレイスメント マッピングを実行する場合は true、実行しない場合は false です。

renderEffects 

シーンのレンダリング後にレンダリング効果を実行するかどうかを取得/設定します。

ブール値: レンダリング効果を実行する場合は true、実行しない場合は false です。

renderHeight 

アクティブ レンダラーの出力の高さを定義する整数値を取得/設定します。

[シーンをレンダリング](Render Scene)ダイアログ ボックスには対応する値のセットが含まれます。

「[シーンをレンダリング](Render Scene)ダイアログ ボックス」を参照してください。

renderPixelAspect 

アクティブ レンダラーの出力のピクセル比を定義する整数値を取得/設定します。

[シーンをレンダリング](Render Scene)ダイアログ ボックスには対応する値のセットが含まれます。

renderWidth 

アクティブ レンダラーの出力の幅を定義する整数値を取得/設定します。

[シーンをレンダリング](Render Scene)ダイアログ ボックスには対応する値のセットが含まれます。

「[シーンをレンダリング](Render Scene)ダイアログ ボックス」を参照してください。

rendOutputFilename 

アクティブ レンダラーの出力ファイル名を定義する文字列値を取得/設定します。

[シーンをレンダリング](Render Scene)ダイアログ ボックスには対応する値のセットが含まれます。

このグローバル変数が "" に設定されている場合、[シーンをレンダリング](Render Scene)ダイアログ ボックスの[ファイルを保存](Save File)チェック ボックスはオフになります。

rendSimplifyAreaLights 

*true* に設定した場合、エリア ライトが検査され、適切な場合にはポイント ライト ソースに変換されます。

rootNode 

シーンのルート ノードを定義する Node 値が含まれます。

ルート ノードは物理的にはシーン内に存在せず、別のノードにリンクしないすべてのノードの親ノードとなる特別なノードです。

シーン オブジェクトには、ルート ノードの children プロパティを使ってアクセスできます。

ルート ノード上で他のノード操作を実行すると、ランタイム エラーが発生します。

rootScene 

スクリプトのシーン ルートおよびマクロ レコーダ出力を表します。

rootScene の subAnims にはノード階層、マテリアル エディタ、トラック ビュー、および シーン マテリアル ライブラリなどが含まれます。

「rootScene システム グローバル変数」を参照してください。

3ds Max 2011 以降で使用可能です。

S

sceneMaterials 

シーン内に存在するマテリアルとルート レベルのマップに対応するマテリアルの仮想配列と、ルート レベルのマップが含まれます。

シーンのマテリアルとルート レベルのマップは、配列のインデックスによって取得でき、for ループで繰り返し使用できます。

配列に、番号、名前、またはマテリアルやルート レベルのマップ名を選択する文字列によってインデックスを付けることができます。

この変数は読み取り専用です。

「MaterialLibrary 値」を参照してください。

scriptsPath 

現在の Scripts ディレクトリへのパスを定義する文字列値が含まれます。

この変数は読み取り専用です。

selectionSets 

3ds Max ツールバーの[名前付き選択セット](Named Selection Set)ドロップダウン リストには、現在のすべての名前付きノード選択セットの仮想配列が表示されます。

名前付き選択は配列のインデックスによって取得でき、for ループで繰り返し使用できます。

配列に番号、名前、または名前付き選択によって選択する文字列でインデックスを付けることができます。

名前付き選択の変更、追加、および削除を行うには、selectionSets 配列の標準配列メソッドを使用します。

「SelectionSetArray 値」を参照してください。

showEndResult 

[修正] (Modify)パネルの[最終結果を表示](Show End Result)アイコンの状態を取得/設定します。

ブール値です。[最終結果を表示](Show End Result)アイコンがオンの場合は true、オフの場合は false になります。「[修正] (Modify)パネル」を参照してください。

skipRenderedFrames 

レンダリング時に、レンダリングされたフレームをスキップするかどうかを取得/設定します。

ブール値です。レンダリングされたフレームをスキップする場合は true、スキップしない場合は false です。

sliderTime 

3ds Max タイム スライダに関連付けられた時間を定義する時間値を取得/設定します。

「時間コントロール」を参照してください。

snapMode.active 

スナップの切り替えの状態を定義するブール値を取得/設定します。オン(true)またはオフ(false)になります。

「ステータス バーのボタン」トピックおよび「snapMode 構造体」トピックを参照してください。

snapMode.type 

現在のスナップ タイプを定義する Name 値を 2D (#2D)、2.5D (#2_5D)、または 3D (#3D)のいずれかで取得/設定します。

「ステータス バーのボタン」トピックおよび「snapMode 構造体」トピックを参照してください。

snapMode.snapPreviewRadius 

スナップ プレビュー 半径の値を取得および設定するシステム グローバル変数。

既定値は 30 です。

3ds Max 7 以降で使用可能です。

「snapMode 構造体」 トピックを参照してください。

snapMode.snapRadius 

半径をスナップの値を取得および設定するシステム グローバル変数。

既定値は 20 です。

3ds Max 7 以降で使用可能です。

「snapMode 構造体」 トピックを参照してください。

snapMode.hilite 

スナップ マーカーのカラー値を取得/設定するシステム グローバル。

3ds Max 7 以降で使用可能です。

snapMode.markSize 

スナップ マーカーのサイズを取得および設定するシステム グローバル。

整数値です。

3ds Max 7 以降で使用可能です。

snapMode.toFrozen 

フリーズされたオブジェクトにスナップするかどうかを取得および設定するシステム グローバル。

ブール値です。

3ds Max 7 以降で使用可能です。

snapMode.axisConstraint 

スナップで軸コンストレイントを使用するかどうかをブール値として取得および設定するシステム グローバル。

[グリッド/スナップ設定](Grid and Snap Settings)ダイアログ ボックスの[オプション] (Options)タブにあるチェックボックスに対応します。

3ds Max 7 以降で使用可能です。

snapMode.displayRubberBand 

ラバー バンドを表示するかどうかをブール値として取得および設定するシステム グローバル。

[グリッド/スナップ設定](Grid and Snap Settings)ダイアログ ボックスの[オプション] (Options)タブにあるチェックボックスに対応します。

3ds Max 7 以降で使用可能です。

snapMode.useAxisCenterAsStartSnapPoint 

[軸中心をスナップ ポイント始点として使用](Use Axis Center As Start Snap Point)オプションの状態をブール値として取得および設定するシステム グローバル。

[グリッド/スナップ設定](Grid and Snap Settings)ダイアログ ボックスの[オプション] (Options)タブにあるチェックボックスに対応します。

3ds Max 7 and 以降、3ds Max 2010 以前で使用可能です。

3ds Max 2011 で廃止されました。

このプロパティへのアクセスを試行すると次の結果になります。

-- ランタイム エラー: このスナップ オプションを設定できません。これは、3ds Max 2011で廃止されています。

snapMode.display 

スナップ マーカーを表示するか取得および設定するシステム グローバル。

ブール値です。

3ds Max 7 以降で使用可能です。

snapMode.strength 

スナップ強度を整数値で取得および設定するシステム グローバル。

3ds Max 7 以降で使用可能です。

snapMode.hit 

マーカーが現在何かにスナップされている場合は true、スナップされていない場合は false を含むシステム グローバル。

スナップがアクティブでない場合は undefined が含まれます。

読み込み専用。

3ds Max 7 以降で使用可能です。

snapMode.node 

現在スナップされている対象のノードを含むシステム グローバル。

ノードにスナップされていない場合、またはスナップがアクティブでない場合は undefined が含まれます。

読み込み専用。

3ds Max 7 以降で使用可能です。

snapMode.flags 

スナップ システム フラグを整数として含むシステム グローバル。

スナップがアクティブでない場合は undefined が含まれます。

読み込み専用。

3ds Max 7 以降で使用可能です。

snapMode.hitPoint 

最後のスナップ ポイントを Point3 座標としてスナップ対象のノードのローカル座標内に含むシステム グローバル。

スナップがアクティブでない場合は undefined が含まれます。

読み込み専用。

3ds Max 7 以降で使用可能です。

snapMode.worldHitpoint 

最後のスナップ ポイントを Point3 ワールド座標として含むシステム グローバル。

スナップがアクティブでない場合は undefined が含まれます。

読み込み専用。

3ds Max 7 以降で使用可能です。

snapMode.screenHitPoint 

最後のスナップ ポイントを Point3 画面座標として含むシステム グローバル。

スナップがアクティブでない場合は undefined が含まれます。

読み込み専用。

3ds Max 7 以降で使用可能です。

snapMode.OKForRelativeSnap 

少なくとも 1 つのスナップ ポイントが記録されている場合に true を含むシステム グローバル。

スナップがアクティブでない場合は undefined が含まれます。

読み込み専用。

3ds Max 7 以降で使用可能です。

snapMode.refPoint 

最後のスナップ ポイントを Point3 ワールド座標として含むシステム グローバル。

スナップがアクティブでない場合は undefined が含まれます。

読み込み専用。

3ds Max 7 以降で使用可能です。

snapMode.topRefPoint 

最初のスナップ ポイントを Point3 ワールド座標として含むシステム グローバル。

スナップがアクティブでない場合は undefined が含まれます。

読み込み専用。

3ds Max 7 以降で使用可能です。

snapMode.numOSnaps 

OSnaps の数を整数として含むシステム グローバル。

読み込み専用。

現在、6 セットの OSnap があります(詳細については以下を参照)。

3ds Max 7 以降で使用可能です。

subObjectLevel 

[修正] (Modify)パネルが開いている場合に、その中でサブオブジェクト レベルを取得/設定できます。このグローバル変数は、0 以上の整数で、最大値は現在開いているモディファイヤでサポートされるサブオブジェクト レベル数です。通常、この値は[サブオブジェクト] (Sub-Object)ドロップダウン リストに表示される順番になります。

subObjectLevel がゼロの場合は、サブオブジェクト モードがオフであることを意味します。

[修正] (Modify)パネルが開いていなかったり、サブオブジェクト レベルが現在のモディファイヤで設定できない場合には、このグローバル変数の値は undefined になります。

numSubObjectLevels グローバル変数は、subObjectlevel の最大有効値にアクセスするために使用します。

「[修正] (Modify)パネル」を参照してください。

例

b=box()-- create a box
em=edit_mesh()-- create an Edit Mesh modifier
addModifier b em-- add edit mesh mod
max modify mode-- open mod panel
select b-- select object Box001
print subObjectLevel-- print the current subobject level
subObjectLevel = 2-- set sub-object level to Edge

subObjectLevel および numSubObjectLevels システム グローバル変数は、[モーション] (Motion)パネルで「undefined」以外の値を返します。

[モーション] (Motion)パネルの最上部には、[選択レベル](Selection Level)/[サブオブジェクト] (Sub-Object)ドロップダウンがあります。このオプションは、[軌道] (Trajectory)モードの場合に、[Keys SO]モードのインとアウトを切り替えます。

このため、テスト(subobjectlevel != undefined)を実行しても、[修正] (Modify)パネルが開いているかどうかは確認できません。代わりに、テスト (getCommandPanelTaskMode() == #modify). を使用します。

sysInfo.DesktopSize 

ピクセル単位のデスクトップ サイズを <point2> 値で取得する読み込み専用変数です。

「システム情報」および「その他の関数」の getMAXWindowSize() を参照してください。

sysInfo.DesktopBPP 

ビット/ピクセル単位のデスクトップ カラー深度を <integer> 値で取得する読み込み専用変数です。

「システム情報」も参照してください。

sysInfo.MAXPriority 

3ds Maxの処理優先順位を <name> 値で取得/設定します。有効な優先順位の値は、#high、#normal、および #low です。

「システム情報」も参照してください。

T

ticksPerFrame 

システムの時間解像度を定義する整数値の取得および設定を行います。

常に毎秒 4800 ティックです。つまり、ticksPerFrame は 1 秒間のフレーム数のレート(ticksPerFrame * frameRate == 4800)に依存します。

timeConfiguration.playActiveOnly 

アクティブなビューポートのみを再生するかどうかを取得/設定します。

この値は、[時間設定](Time Configuration)ダイアログ ボックスで設定した値と同じです。

ブール値です。[アクティブ ビューポートのみ再生](Active Viewport Only)がオンの場合は true、オフの場合は false です。

「[時間設定](Time Configuration)ダイアログ ボックス」を参照してください。

playActiveOnly System Global と同じです。

timeConfiguration.realTimePlayback 

リアルタイム モードで再生するかどうかを取得/設定します。

この値は、[時間設定](Time Configuration)ダイアログ ボックスで設定した値と同じです。

ブール値です。[リアルタイム](Real Time) がオンの場合は true、オフの場合は false になります。

「[時間設定](Time Configuration)ダイアログ ボックス」を参照してください。

realTimePlayback System Global と同じです。

timeConfiguration.PlaybackSpeed 

ビューポートの再生速度モードを取得/設定します。

「[時間設定](Time Configuration)ダイアログ ボックス」を参照してください。

timeConfiguration.PlaybackLoop 

ビューポートの再生をループするかどうかを取得/設定します。timeConfiguration . realTimePlayback が true. に設定されている場合のみ使用されます。

「[時間設定](Time Configuration)ダイアログ ボックス」を参照してください。

3ds Max 8 以降で使用可能です。

timeConfiguration.useTrackBar 

[時間設定](Time Configuration)ダイアログ ボックスの[キー ステップ/トラック バーを使用](Key Steps/Use TrackBar)チェック ボックスの状態を取得および設定します。

ブール値です。チェックマークを付けると true、チェックマークを消すと false です。

「[時間設定](Time Configuration)ダイアログ ボックス」を参照してください。

timeDisplayMode 

再生時の[時間表示設定](Time Display)モードを取得/設定します。[時間設定](Time Configuration)ダイアログ ボックスで Name 値として設定されている、対応する値が含まれます。

3ds Max 2008 以降で使用可能です。従来、Avguard DLX Extension で提供されていた機能です。

有効な値は次のとおりです。#frames, #smpte, #frameTicks, #timeTicks.

toolmode.axisConstraints 

3ds Max 軸コンストレイントを取得/設定します。

軸コンストレイント値は次のとおりです。

#X #Y #Z #XY #YZ #ZX 

「メイン ツールバー」を参照してください。

toolmode.commandmode 

3ds Max コマンド モードを取得/設定します。

コマンド モードの取得時に返される値は、認識されているコマンド モードの場合は <name> 値、それ以外の場合は整数値です。

認識されているコマンド モードは次のとおりです。

#SELECT #MOVE #ROTATE #NUSCALE #USCALE #SQUASH #VIEWPORT #HIERARCHY #CREATE #MODIFY #MOTION #ANIMATION #CAMERA #NULL #DISPLAY #SPOTLIGHT #PICK 

3ds Max コマンド モードを設定する場合、次のコマンド モードのみが有効です。

#SELECT #MOVE #ROTATE #NUSCALE #USCALE #SQUASH 

「メイン ツールバー」を参照してください。

toolMode.coordSysNode 

ノード値または undefined を含む読み込み/書き込み変数。

この変数は、ノードがある場合は、現在の参照座標系ノードを反映します。

この変数への代入はノード値でなければなりません。

「メイン ツールバー」を参照してください。

toolmode.commandmodeID 

3ds Max のコマンド モードを整数 ID として取得します。

読み込み専用です。

有効な値は次のとおりです。

1 - 移動

2 - 回転

3 - 不均等スケール

4 - 均等スケール

5 - 押し潰しスケール

6 - 選択

「メイン ツールバー」を参照してください。

trackbar.filter 

トラックバーに表示するキー タイプを指定するフィルタを取得/設定します。

Name 値です。有効な値は、#all、#TMOnly、#currentTM、#object、および #mat です。

trackbar.visible 

トラックバーを表示するかどうかを取得/設定します。

ブール値です。トラックバーを表示する場合は true、表示しない場合は false です。

trackViewNodes 

トップレベルのワールド ノードを定義する MAXTVNode 値がトラック ビューに含まれます。

この変数は読み取り専用です。「トラック ビュー ノード」を参照してください。

U

units.DisplayType 

現在の表示タイプを <name> で取得/設定します。

有効な単位表示タイプは次のとおりです。

#Generic #Metric #US #custom 

「Units 構造体: システム単位および表示単位へのアクセス」を参照してください。

units.MetricType 

現在のメートル単位の表示タイプを <name> で取得/設定します。

有効なメートル単位の表示タイプは次のとおりです。

#Millimeters #Centimeters #Meters #Kilometers 

「Units 構造体: システム単位および表示単位へのアクセス」を参照してください。

units.USType 

現在の US 標準単位の表示タイプを <name> で取得/設定します。

有効な US 標準単位の表示タイプは次のとおりです。

#Frac_In #Dec_In #Frac_Ft #Dec_Ft #Ft_Frac_In #Ft_Dec_In 

「Units 構造体: システム単位および表示単位へのアクセス」を参照してください。

units.USFrac 

現在の US 分数の表示タイプを <name> で取得/設定します。

有効な US 分数の表示タイプは次のとおりです。

#Frac_1_1 #Frac_1_2 #Frac_1_4 #Frac_1_8 #Frac_1_10 #Frac_1_16 #Frac_1_32 #Frac_1_64 #Frac_1_100 

「Units 構造体: システム単位および表示単位へのアクセス」を参照してください。

units.CustomName 

現在のカスタム単位名を <string>

「Units 構造体: システム単位および表示単位へのアクセス」を参照してください。

units.CustomValue 

現在のカスタム単位値を <float>

「Units 構造体: システム単位および表示単位へのアクセス」を参照してください。

units.CustomUnit 

現在のカスタム単位タイプを <name> で取得/設定します。

有効なカスタム単位の表示タイプは次のとおりです。

#Inches #Feet #Miles #Millimeters #Centimeters #Meters #Kilometers 

****「Units 構造体: システム単位および表示単位へのアクセス」を参照してください。

units.SystemScale 

現在のシステム単位スケールの値を <float> で取得/設定します。

これは、[カスタマイズ > 単位設定 > システム単位設定... > システム単位設定 > システム単位スケール] (Customize > Units Setup... > System Units Setup > System Units Scale)領域に表示される値です。

「Units 構造体: システム単位および表示単位へのアクセス」を参照してください。

units.SystemType 

現在のシステム単位スケールのタイプを <name> で取得/設定します。これは、[カスタマイズ]/[単位設定]/[システム単位設定]ボタン/[システム単位設定]ダイアログ ボックス/[システム単位スケール]領域に表示される単位です。

有効なシステム単位のタイプは次のとおりです。

#Inches #Feet #Miles #Millimeters #Centimeters #Meters #Kilometers 

「Units 構造体: システム単位および表示単位へのアクセス」を参照してください。

useEnvironmentMap 

グローバル レンダリング環境([レンダリング] (Rendering) > [環境] (Environment))の[マップを使用](Use Map)の値を取得/設定します。[マップを使用](Use Map)がオンの場合は true、オフの場合は false になります。「[環境と効果](Environment and Effects)ダイアログ ボックス」を参照してください。

V

videoPostTracks 

トップレベルのビデオポスト トラック ビュー ノードを定義する MAXTVNode 値が含まれます。

この変数は読み取り専用です。「トラック ビュー ノード」を参照してください。

viewport.activeViewport 

アクティブ ビューポートのインデックスを取得および設定します。

「アクティブ ビューポートの情報、タイプ、変換へのアクセス」を参照してください。

viewport.numViews 

現在のビューポート レイアウト内のビューポート数が含まれます。

この変数は読み取り専用です。「アクティブ ビューポートの情報、タイプ、変換へのアクセス」を参照してください。

スキャンライン レンダラー固有のシステム グローバル変数

次の 3ds Max システム グローバル変数は、3ds Max で既定のスキャンライン A バッファ レンダリングに特有のものです。

これらの変数は、現在のレンダラーが既定の 3ds Max スキャンライン A バッファ レンダラーでない場合は undefined を返します。

scanlineRender.antiAliasFilter 

アンチエイリアシング フィルタを取得および設定します。

例

scanlineRender.antiAliasFilter = quadratic()

すべてのアンチエイリアシング フィルタの一覧を取得するには、次のスクリプトを使います。

例

showClass "*:filter*"
-->Area : filter {77912301,0}
-->Quadratic : filter {77912304,0}
-->cubic : filter {77912305,0}
-->Catmull_Rom : filter {77912306,0}
-->Blackman : filter {77912313,0}
-->Sharp_Quadratic : filter {77912314,0}
-->Video : filter {77912319,0}
-->Plate_Match_MAX_R2 : filter {7791231b,0}
-->Cook_Variable : filter {77912330,0}
-->Soften : filter {77912331,0}
-->Mitchell_Netravali : filter {77912350,0}
-->Blendfilter : filter {77912352,0}
-->Filter_kernel_plug_in_not_found : filter {ffffffff,0}
-->OK

アンチエイリアシング フィルタとそのパラメータについては、「3ds Max のスキャンライン A バッファ レンダリングのアンチエイリアシング フィルタ」を参照してください。

scanlineRender.antiAliasFilterSize 

アンチエイリアシング フィルタのサイズを定義する実数値が含まれます。

scanlineRender.enablePixelSampler 

グローバル スーパー サンプリングのオンとオフを切り替えます。

ブール値です。[すべてのサンプラーを使用不能にする](Disable all Samplers)がオフの場合は true、オンの場合は false です。