ビジュアル MAX スクリプト

ビジュアル MAX スクリプトは、[MAXScript]ロールアウトのレイアウトや編集に使用する、直接操作、マルチスレッド、フォームベースのエディタです。フォームエディタを使用してロールアウトのスクリプトを最初から作成することも、スクリプトエディタウィンドウで既存のロールアウト定義の編集や追加を、フォームエディタを使用してインタラクティブに行うこともできます。

レイアウトエディタへのアクセス方法は 2 つあります。

「ビジュアル MAX スクリプト」というスタンドアロンのユーティリティプラグインとしてアクセスする

ユーティリティコマンドパネルからユーティリティとしてアクセスすると、レイアウトエディタは「スタンドアロン」モードで動作します。作成されたフォームは、ロールアウト定義のスクリプトの入ったスクリプトファイルとして個別にエクスポートすることも、特殊な .vms バイナリレイアウトファイルに保存してビジュアル MAX スクリプトユーティリティで再び開けるようにすることもできます。このモードの場合、エクスポートされたスクリプトファイルはスクリプトエディタウィンドウで開くことができ、MAXScript でさらに編集したり、他のスクリプトファイルとマージしたりできます。

スクリプトエディタウィンドウの[編集]メニューの 2 つの新メニュー項目を通してアクセスする

スクリプトエディタの[編集]メニューの新項目からアクセスすると、レイアウトエディタがアクティブスクリプトエディタのロールアウト定義セクションに適用されるように、レイアウトエディタは設計されています。[新規ロールアウト] は、ロールアウト定義を最初から作成するときに使用します。編集ウィンドウで新しく生成するロールアウトのコードを挿入する位置にカーソルを置き、[編集]/[新規ロールアウト] を選択します。エディタが空のフォームで開き、そこでロールアウト項目の追加、配置および編集を行うことができます。レイアウトエディタウィンドウで [ファイル]/[保存] を選択するか [保存]アイコンを押すと、その時点でロールアウトのスクリプトがエディタウィンドウに挿入されます。以後、レイアウトエディタを開いたまま編集や保存を行うと、挿入されたコードも更新されます。

[ロールアウトを編集]**(ホットキー[F2])** は、アクティブスクリプトエディタで既存のロールアウト定義を編集するときに使用します。ロールアウト定義またはユーティリティ定義内にカーソルを置いて [編集]/[ロールアウトの編集] ([F2]) を選択すると、そのロールアウトを表示した状態でレイアウトエディタが開きます。レイアウトエディタのロールアウトは編集したり、追加したりできます。レイアウトエディタの [ファイル]/[保存]を選択するか[保存]アイコンクリックすると、編集されたロールアウトに対応する新しいコードで元の定義が置き換えられます。以後、レイアウトエディタを開いたまま変更や保存を行うと、コードも更新されます。

機能

一度に複数のレイアウトエディタを開けます。この機能により、カットアンドペーストができます。ただし、VMS ではイベントコードのカットアンドペーストも行われます。
スクリプトエディタウィンドウからレイアウトエディタを開くと、レイアウトエディタが開いている間はスクリプトエディタウィンドウのテキストは「フリーズ」されます。エディタウィンドウを前面に置いてスクロールしたり保存したりすることはできますが、その他の操作は無視され、警告音が鳴ります。スクリプトエディタは、レイアウトエディタを閉じるとすぐに「フリーズ解除」されます。
[編集]/[ロールアウトの編集]の機能は、既存のどのロールアウト定義にも適用できます。この機能では、定義を解析してこれと同等の編集可能なバージョンをレイアウトエディタに開こうとします。これはいくぶん試行錯誤的な面があり、バグを取り除くまでは特定のロールアウトに関して失敗する可能性があります。MAXScript では、ロールアウトのすべてのコードを保存し、レイアウトエディタで編集できる設定(UI 項目とそのハンドラ)に対応する部分のみを更新します。
レイアウトエディタが生成するコードでは、UI 項目の pos: width: および height: パラメータを明示的に指定する一方、align: や offset: などの自動レイアウトパラメータは使用しません。つまり、自動レイアウトを使用するロールアウトを編集するとき、最初の[ファイル]/[保存]の実行で、明示的に位置を指定されたレイアウトへの変換が行われます。エディタで任意に編集をしながら自動レイアウトパラメータを保存することは非常に困難です。そのため、レイアウトエディタを使用して編集したロールアウトは、今後もレイアウトエディタを使用して編集されると想定されます。
注:

極端な例としては、グループボックス内に一連の項目をネストするために使用される group ( ) 構文があります。ネストされた group ( ) 構文は、レイアウトエディタによって完全に削除され、元の項目に基づいた明示的なサイズ指定のボックスを定義する groupBox UI 項目で置き換えられます。ネストされた groupBox は、必要に応じてエディタで編集および追加できます。
- [編集]/[ロールアウトの編集]で開いたロールアウト定義にシンタックスエラーがある場合、そのシンタックスエラーは通知され、エラー部分がハイライトされます。レイアウトエディタは開きません。
- レイアウトエディタはエラーのないソースに関してのみ開くことができます。レイアウトエディタでロールアウトを初めて編集または作成するとき、コマンドパネルロールアウトの標準の幅がレイアウトエディタの既定の幅として使用されます。この幅は、エディタ内で外側の灰色の長方形と、生成されたロールアウトヘッダ上のエディタ放出幅:および高さ: のパラメータサイズを変更して調整できます。スクリプトエディタでこれらの数値を編集すると、次に該当するロールアウトをレイアウトエディタで編集するときに、編集後の数値が採用されます。

コマンドパネルロールアウトやその他のスクリプトプラグインに関しては、自動的に正しい幅を得るためのシンボリック定数が新しく用意されました。これら 2 つのオペレータは次のとおりです。

       #cmdPanel #effectsDlg #mtlEditor

したがって、スクリプト Material のロールアウトを作成するときには、次に示すように、ロールアウトヘッダーに width: パラメータを追加します。

例

    rollout foo "Frabulation" width:#mtlEditor
    (
    ...

新しい UI 項目を追加するには、最下部にある項目ツールバーのボタンをクリックし、メインフォームでマウスをドラッグすることにより、項目の矩形を表示します。既存の項目を選択すると、右側のプロパティリストで項目のパラメータを編集できます。複数の項目を選択するには、マウスをドラッグしてそれらの項目を囲むか、[Cｔｒｌ] キーを押しながらクリックします。選択したら、いろいろな位置合わせ操作が行えます。詳細は [レイアウト] メニューを参照してください。選択したアイテムを削除するには、ツールバーの赤の X ボタンをクリックします。エディタのレイアウトをカスタマイズする場合には、それぞれのペインをサイズ変更したり、切り離したりすることもできます。
軸を制限するには、[Shift]キーを押しながらオブジェクトを移動します。こうすると、最初の位置に対するマウスの角度に基づいて、動きは X 軸または Y 軸だけに制限されます。
MAXScript の複数行の editText に関連して、エディタの editText ボックスに複数の行を入れることができるようになりました。
[配列エディタ](Array editor) ダイアログボックスでの編集が合理化され改善されました。リストボックスの項目をクリックすると、その選択の状態が切り替わります。項目がリストボックスで選択されている場合、編集フィールドでテキストを変更して [enter] キーを押すと、選択された項目が編集ボックスの内容に変更されます。こうして、リストの途中にあるエントリの編集ができます。
[VisualMS] ダイアログボックスの最下部の項目タイプツールバーに新しいカスタムの項目タイプが追加され、カスタム項目を最初からエディタで作成できるようになりました。このアイコンは、ツールバーの横顔のアイコンです。最初に作成するとき、パラメータリストの項目クラスパラメータには「???」と表示されるので、これを編集して必要なカスタム項目タイプにする必要があります。
MAXScript には、ActiveX コントロールのロールアウト項目タイプが用意されています。アイコンは、[VisualMS]ダイアログボックスの最下部にある UI 項目ツールバーにあります。ドットの配列の上に OLE という文字が重ねられたアイコンです。MAXScript ロールアウト内の ActiveX コントロール
サードパーティから追加されたものなど、認識できない UI 項目タイプを含むロールアウトのソースの編集をします。[VisualMS]ロールアウトウィンドウでは、MAXScript の拡張子 .dlx は新しい「カスタム」項目を示し、新しい「カスタム」タイプアイコンが入った矩形として表示されます。オンになっている定義パラメータはパラメータリストに表示され、編集ができます。カスタムタイプを示す矩形の全体的な位置と大きさは、ロールアウトペインで編集できます。
メインフォームのまわりの白い空間をクリックすると、すべての選択を解除できます。
メインフォームは、選択されていないときでも黒い矩形で囲まれて示されます。こうして、アプリケーションのバックグラウンド色とフォームの色が同じであっても、フォームを見ることができます。
メインフォームのサイズ変更は、グリッド単位がオンになっていると、グリッド単位に行われます。
貼り付けコマンドが使いやすくなりました。貼り付けられたオブジェクトは[10,10]ピクセルでオフセットされ、一意の名前を取得します。次に、貼り付けるものがすべて選択解除され、貼り付けられたオブジェクトが選択されます。
VMS で自動レイアウトを利用する既存のロールアウト定義を初めて編集する場合、エディタが項目を正しく配置できるように、まず「'width:n'」パラメータをロールアウトヘッダーに追加することを強くお勧めします。width: パラメータを指定しないと、コマンドパネルの幅が既定値として使用されます。これは、固定されないウィンドウのロールアウト、スクリプトマテリアル、効果などには小さすぎる場合があります。

rolloutFloater に表示されるロールアウトの場合は、ロールアウト幅をフロータウィンドウマイナス 30 になるように設定する必要があります。

例

    rollout foo "Frabulation" width:#270
    (
    ...
    )
    ...
    rf = newRolloutFloater "Frabo" 300 220
    addRollout foo rf