3ds Max 8 の MAXScript 言語に関する改良点

MAXScript デバッガ

MAXScript デバッガでは、3ds Max のメインスレッドを中断したり、3ds Max スレッドが動作していない間にグローバル変数とローカル変数の値の調査と変更を行ったり、コマンドラインから MAXScript コマンドを実行したり、MAXScript コード内からメソッドを呼び出して実行を中断することができます。デバッガでは、中断したコードの実行の停止や継続を行うこともできます。

MAXScript のクラッシュからの回復

クラッシュ時の MaxScript ファイルの保存

シーンファイルの保存を試みた後、クラッシュハンドラによって MAXScript は変更済みの開いたスクリプトウィンドウの保存を試みることができるようになりました。

コントローラの改善点

これまでは、コントローラをトラックに割り当てると、新しいコントローラがトラックの値を使用していました。新しいコントローラクラスを既存トラックに割り当てる場合、これは正常に動作しますが、すでに値がある既存コントローラをインスタンス化する場合は、予想外の結果となっていました。スクリプトコントローラをトラックに割り当てる場合、割り当て前のスクリプト文字列セットは、トラックの現在の値で常に上書きされていました。

3ds Max 8 ではこれが修正されました。コントローラが「新しくない」場合、フラグが内部的に設定され、インスタンス化されるコントローラの既存データが、フレーム 0 のトラックの値の代わりに使用されます。

スクリプトコントローラ

スクリプトコントローラにおいてはトラックの現行値でスクリプト文字列が置き換えられましたが、前の段落で説明したコントローラの変更により、これは修正されました。スクリプトコントローラか式コントローラの設定を変更した場合、コントローラは「新しくない」とマークされ、既存のスクリプトや式が、ターゲットトラックの値の代わりに使用されます。

式コントローラとスクリプトコントローラにおけるノードの簡潔なリファレンス

ノードを示す式コントローラの変数は、新しい nodeTransformMonitor クラスを使用してノードの参照を維持するようになりました。これにより、ノード変数を含む式コントローラを使用しているシーンの速度が上がります。

copyPasteKeys 関数

選択したキーのコピーと貼り付けを行う新しいメソッドが MAXScript に追加されました。

RCMenu において修正された .Checked プロパティと .Enabled プロパティ

ダイアログに使用される RCMenu のメニュー項目のプロパティ .enabled および .checked が変更された場合に、メニュー項目が正しく更新されます。

ロールアウト値における読み取り専用の .owner プロパティ

ユーティリティおよびロールアウトのプロパティ、メソッド、およびイベントハンドラ

読み取り専用の .owner プロパティがロールアウト値に追加されました。スクリプトプラグインか CA によってロールアウトが表示されている場合、このプロパティにはスクリプトプラグインか CA のインスタンスが含まれます。ロールアウトイベントハンドラでデバッガのブレークが発生したとき、スクリプトプラグインか CA のインスタンスの変数に簡単にアクセスできるようにするため、このプロパティが追加されました。この場合、イベントハンドラの所有者はロールアウトなので、getVar owner.owner を使用してスクリプトプラグインか CA のインスタンスにアクセスできます。

スクリプトプラグインの読み取り専用ローカル変数

スクリプトプラグインにおいて事前定義されている次のローカル変数は、読み取り専用になりました。

すべてのプラグインタイプ: this、loading 。version は以前から読み取り専用でした。

SimpleMod: extent、min、max、center

SimpleManipulator: target、node

「::」を使用してグローバルとしてグローバル変数を指定

名前の前に「::」を付けることで、グローバル変数名を指定できるようになりました。このような名前はグローバル変数プールのみで検索され、現存しない場合に作成されます。

マージにおける新しい永続グローバル変数の動作

永続グローバル変数

ファイル内でマージか外部参照を行い (シーンやオブジェクトの外部参照は、マージの特別なケース)、永続グローバル変数を読み込むとき、シーンファイルから読み込んだ変数が永続グローバル変数としてすでに存在する場合、永続グローバル変数の値は上書きされません。

指定された I/O クラスを使用した読み込み/書き出し

ImportFile() および ExportFile()

新しく[ using:<maxclass> ]オプションキーワード引数が ImportFile() 関数と ExportFile() 関数に追加されました。

この引数は、呼び出される正確なインポータ/エクスポータの max クラスを渡すために使用できます。したがって、同一の拡張子が複数のファイルにサポートされていても競合が防止されます。

ファイルの保存 - 抑制モードと戻り値

3ds Max ファイルのロードと保存

新しく[ quiet:<bool> ]オプションキーワード引数が SaveMaxFile() 関数と SaveNodes() 関数に追加されました。このメソッドは、OK を返す代わりに、正常に終了した場合に true、エラーが発生した場合 (ターゲットファイルが存在して書き込み保護されている場合など) に false を返します。

ビットマップ値

新しく[ quiet:<bool> ]オプションキーワード引数がビットマップ値の Save()メソッドに追加されました。このメソッドは、OK を返す代わりに、正常に終了した場合に true、エラーが発生した場合 (ターゲットファイルが存在して書き込み保護されている場合など) に false を返します。

マテリアルエディタ

新しく[ quiet:<bool> ]オプションキーワード引数が fileSaveMatLib() メソッドに追加されました。対応する SDK メソッドが正常終了かエラーの有効な結果を返さないので、OK が返されます。

新しい initialDir: getSavePath() へのキーワード引数

ファイルを開くおよび保存する標準のダイアログボックス

新しく[ initialDir:<pathname> ]オプションキーワード引数が getSavePath() メソッドに追加されました。これを指定すると、指定したパスでダイアログボックスが開きます。

gw.SnapPoint() 用のカスタム SnapPlane

Viewport gw.snapPoint メソッド

新しいオプションキーワード引数が既存の gw.snapPoint メソッドに追加されました。ユーザがこの引数を使用することにより、XY 平面をマップする snapPlane matrix3 値をカスタムスナッピング平面に与えることができます。

スクリプト化されたレンダリング効果の 32 ビット浮動小数点のサポート

matrix3 値をカスタムスナッピング平面に与えることができます。Effect8::SupportsBitmap() が実装され、すべてのケースで true を返します。

スクリプト化されたレンダリング効果は、適切な GetPixel() メソッドのみでビットマップにアクセスし、スクリプトでカラーを意図的にクリッピングするかカラーを整数に変換しない限り、クリッピングなしで高度なダイナミック範囲イメージが自動的にサポートされるので、すべてのタイプのビットマップと互換性があるとみなされます。

スクリプトマテリアルの mental ray のサポート

デレゲートマテリアルがサポートされている限り、スクリプトマテリアルは mental ray によってサポートされるようになりました。デレゲートマテリアルは、レンダリングに使用される実際のマテリアルとして mental ray によって正しく解釈されます。スクリプトマテリアルの[mental ray コネクション](mental ray Connection)ロールアウトの使用と初期化も正しく行われます。

Undo/Redo コールバックの NotificationParams

コールバック: システムを元に戻す場合の通知

#sceneUndo および #sceneRedo コールバックは、 callbacks.notificationparams() の元に戻す/やり直し名前エントリを返すようになりました。

スクFリプト例:

callbacks.removeScripts id:#test
callbacks.addScript #sceneRedo "format \"Redo: %\\n\" (callbacks.notificationParam())" id:#test
callbacks.addScript #sceneUndo "format \"Undo: %\\n\" (callbacks.notificationParam())" id:#test

調査インタフェースプロパティ

showProperties、getPropNames、および hasProperty メソッドに、FPS インタフェースプロパティが含まれるようになりました。

例:

CameraMap はパラメータブロックでプロパティを公開しませんが、次の 2 つのプロパティを FPS インタフェースで公開します。

c=CameraMap()
--> CameraMap:Camera Map Modifier
showinterfaces c
--> Interface: interface
--> Properties:
--> .cameraNode : node : Read|Write
--> .channel : integer : Read|Write
--> Methods:
--> Actions:
--> OK
getpropnames c -- on instance
--> #(#cameraNode, #channel) -- previously returned #()
showproperties c -- on instance
--> .cameraNode : node -- previously not shown
--> .channel : integer -- previously not shown
--> FALSE
hasproperty c #channel -- on instance
--> true-- previously returned false
getpropnames CameraMap -- on class
--> #()
showclass "cameraMap.*"
--> CameraMap : modifier {21ce6ea4,7ed434db}
--> OK

MAXScript エディタの改善点

[エディタ](Editor)メニューに新しく[編集](Edit) > [すべてクリア](Clear All)コマンドが追加されました。このオプションは、これまでリスナーのみで使用可能でした。実行すると、エディタの内容がクリアされます。

大きいスクリプトのカラーコーディングが 30% 以上速くなりました。カラーコーディング中は待機カーソルが表示されます。

抑制モード、DefaultAction、抑制コンテキスト

defaultAction コンテキスト

既定アクションを指定する新しいコンテキストが追加されました。

quiet コンテキスト

現在の抑制モードを指定する新しいコンテキストが追加されました。

抑制モード

render、loadMaxFile、fetchMaxFile、mergeMaxFile 、および getMAXFileObjectNames の既定値のアクション引数として、オプション #default が追加されました。 #default を指定すると、現在の defaultAction コンテキストの状態が使用されます。

render、loadMaxFile、fetchMaxFile、mergeMaxFile 、および getMAXFileObjectNames に既定値のアクション引数を指定しない場合、現在の defaultAction コンテキストの状態が既定値になります。

MAXScript render、loadMaxFile、fetchMaxFile、mergeMaxFile、getMAXFileObjectNames メソッドの「quiet」キーワード引数で既定値が修正されました。これまでの既定値は FALSE でした。現在の既定値は、現在の抑制モードです。

MXS mergeMAXFile メソッドに、missingExtFilesAction:、missingExtFilesList:、missingXRefsAction:、missingXRefsList: というキーワード引数が追加されました。

レンダラーのコントロール

新しいキーワード引数 unsupportedRenderEffectAction : および unsupportedRenderEffectList : が MAXScript render メソッドに追加されました。

ファイルリンクと抑制モード

ファイルリンクのダイアログボックスでは、抑制モードを尊重するようになりました。ファイルリンクのすべてのダイアログボックス(アタッチ、再ロード、デタッチ、またはバインドの間に現れるダイアログボックス)では、この設定を尊重するようになりました。

readValue メソッドの強化機能

StringStream に関連するメソッド

新しいキーワードパラメータ ignoreStringEscapes: が readValue メソッドに追加されました。

filterString splitEmptyTokens パラメータ

FilterString

新しいキーワードパラメータ splitEmptyTokens: が filterString メソッドに追加されました。 splitEmptyTokens が false の場合、または指定されない場合は、連続トークンが 1 つのトークンとして処理され、文字列の先頭か末尾のトークンが無視されます。 splitEmptyTokens を true にすると、見つかったそれぞれのトークンが出力の文字列要素となり、上で無視された場合の文字列要素は空の文字列になります。

OLE の改善点

SafeArrayWrapper クラス

新しい SafeArrayWrapper クラスのインスタンスがユーザによって作成可能になり、SAFEARRAY 値を返す OLE メソッドによって返されます。

これまでのリリースでは、MAXScript 文字列と OLE 文字列の変換ルーチンでスタックメモリが使用されていました。特定のメソッドでは、文字列サイズの 2 倍の割り当てがスタックで試されていました。非常に長い文字列の場合は、スタックオーバーフローが発生していました。3ds Max 8 では、MAXScript でより適切な変換ルーチンが使用され、実際に必要なときに限りスタックメモリが使用されるためスタックメモリ要件が小さくなりました。

ガベージコレクションのステータス表示

options.showGCStatus

新しいグローバル変数 options.showGCStatus が追加されました。 true に設定すると、MAXScript のガベージコレクション中にステータスバーにメッセージ「MXS GC」が表示されます。 false に設定すると、メッセージは表示されません。設定は、3dsmax.ini ファイルの[MAXScript]セクションに保存されます。

UI の高速化

以前のリリースでは、MAXScript を使用して N 個のオブジェクトを削除すると MacroScript isEnabled ハンドラが N 回呼び出される問題がありました。この問題は解決されました。これは修正されました。オブジェクトの削除中はシーンの再描画が無効になり、シーンの再描画が再び有効になってから MacroScript ハンドラが 1 回だけ呼び出されます。

SelectByName showHidden: オプションの動作

名前によるシーンノードの選択

これまでのリリースでは、記述されていた showHidden オプションキーワードが破壊されていました。現在は予想どおりに動作するようになりました。

スライダの controller: 作成パラメータ

Slider

これまでのリリースでは、スピナーコントロールのみを controller: 作成パラメータによってコントローラにリンクできました。現在ではスライダでも同じことを実行できます。

新しいスピナー変更ハンドラ引数

編集ボックス

新しいオプション引数が、 changed、entered および buttonUp 変更ハンドラに追加され、手動で元に戻す処理が改善されました。

ボタンコントロールイメージの削除

Button または Checkbutton のいずれかで .images プロパティの値を undefined に設定すると、コントロールがイメージではなくキャプションで表示されるように設定されます。

ボタンと ImgTag における新しいマウスボタンイベントハンドラ

新しい rightclick イベントが、button、checkButton、mapButton、materialButton、pickButton、および imgTag に追加されました。

ダイアログボックスで検出されるイベントと同様の複数の新しいイベント( lbuttondown、lbuttonup、lbuttondblclk、mbuttondown、mbuttonup、mbuttondblclk、rbuttondown、rbuttonup、rbuttondblclk など)が、imgTag に追加されました。

スクリプトカメラ、ライト、ダミー、ライトのカスタム表示メッシュの新しい useWireColor ハンドラ

スクリプト Camera

スクリプト Light プラグイン

スクリプトヘルパープラグイン

スクリプトカメラ、スクリプトライト、スクリプトヘルパーでこのイベントハンドラを使用することができ、開発者は、ビューポートでオブジェクトを描画するときにノードのワイヤカラーを使用するか、オブジェクトタイプ (ヘルパーにはダミーオブジェクト、ライトにはライトオブジェクト、カメラにはカメラオブジェクト) の UI カラーを使用するかを指定できます。このハンドラが true を返す場合は、ノードのワイヤカラーが使用されます。 false を返す場合は、オブジェクトタイプの UI カラーが使用されます。イベントハンドラを指定しない場合は、ワイヤカラーが使用されます。 getDisplayMesh ハンドラを指定した場合に限って、このハンドラを使用できます。

このハンドラはオプションです。