MAXScriptリスナーとMAXScriptエディタ

標準でインストールされる MAXScript のリファレンスは英語版しか用意されていません。「英語なんかヘッチャラ！」という方なら英語環境で頑張って頂ければと思いますが、そうでない方はオートデスクの「Autodesk 3ds Max サービス＆サポート」から日本語版のリファレンスを入手しましょう。
上記サイトの「3ds Max 2010、3ds Max Design 2010 MAXScript 日本語リファレンス」からダウンロードします。

3ds Max には、ユーザーが Max を操作した履歴を見ることができる「MAXScriptリスナー」とMax 上でスクリプトを書くための「MAXScriptエディタ」があります。
本格的なスクリプトを書く場合は MAXScriptエディタでは機能が十分ではなく不便な所もありますが、書いたスクリプトをその場ですぐ試すことができるのでとても重宝します。

まずは試しに、MAXScriptリスナーで履歴を見てみましょう。メニューの［ MAXScript(M)/MAXScriptリスナー(L)... ］からMAXScriptリスナーを開き、マクロレコーダを使用可能にします。

使用可能にしたら、GUIからボックスをいくつか作ってみます。すると、MAXScriptリスナーの上段に何やら文字列が出てきます。これが、今あなたが Max を操作した履歴です。

では、この内容をMAXScriptエディタにコピー＆ペーストして実行してみます。
まずは新しいシーンを作成して、MAXScriptエディタの［ツール(T)/全てを評価(A)］を実行します。
どうでしょう？　先ほど手で作成したものと同じオブジェクトが作成されましたね？　ようこそ、MAXScript の世界へ！

と思いきや、表示されている色が違いますね。この色は、オブジェクトを作る時に Max が自動的にしていしているためです。もちろん、色を統一する必要があるときはスクリプトで指定することもできます。MAXScriptリスナーについての詳しい情報は、先ほどダウンロードしたマニュアルの［ [MAXScript リスナー]ウィンドウ］の項目を参照してみてください。

この MAXScript リスナーを上手に使うと、プログラマーとのコミュニケーションがスムーズに行えるようになります。データの変換など、単純だけれども大量に処理をしなければいけない仕事が来た時にひと通り作業を見てもらいながら、同時にリスナーーでログを取ってプログラマーに渡します。そうすれば CG ソフトのオペレーションに詳しくないプログラマーでも、何をしなければいけないのか簡単に理解することができます。

この方法の一番の利点は、MAXScriptリスナーが翻訳者となって、プログラミングが不得意なデザイナーとCGソフトの扱いが不得意なプログラマーの会話をすることができることです。実際に、筆者も仕事で同じような方法で作ったスクリプトをデザイナーに使ってもらったことが多々あります。
そのようなやりとりをしていると、作った私自身そのプログラムをどうやって使うのか知らないということもありました（笑）。同様に、デザイナーもプログラムが中で何をやっているのか理解していません。それなのにきちんと成果が上がっていたというのがとても面白い現象です。

前回の内容を詳しく読み解いてみる

環境が整ったところで、まずは肩慣らしに前回ご紹介したコードを解説していきますね。
こちらがそのコードです；

for s in selection do (
		print s.Name
)

......このコードは以下のような構造になっています。

print s.Name

後述しますが、「s 」にはオブジェクトが入っています。オブジェクトにはいくつか決まった変数(プロパティ)があって、「Name 」というプロパティはそのものズバリ、オブジェクトの名前を指します。

selection

MAXScriptで予め用意されている変数です。今選択しているオブジェクトの配列が格納されています。配列とは、変数が順番に並んだひとまとめのことと言えますが、正確には「selection 」は、MAXScriptにおいて「コレクション」と呼んでいます。詳しくは MAXScript リファレンスの［コレクション→コレクションのタイプ→ObjectSet値］を参照してください。ここを見ると、selection 以外にも様々な変数があることが分かりますよ。

ただ、今はあまり難しいことは考えないで、「selection っていうのを使うと選択しているオブジェクトの一覧が取れるんだな」ぐらいに思って頂ければ十分です。

for 文

「for」は、指定した条件が整うまで "()" で囲まれた処理を繰り返すための命令です。

MAXScript の for 文には、2種類の使い方があります。ひとつは今回の例で、配列の中身をひとつひとつ変数に代入しながら繰り返し処理を行うものです。
今回の例の場合、s という変数に selection から一つづつオブジェクトを取り出して代入して、その度にブロックの中の処理をしています。

もうひとつは、数値を変化させながら(大抵は1づつ加算しながら)繰り返し処理を行うものです。
では、同じ処理を加算しながら行うバージョンに書き変えてみます；

for i=1 to selection.count do (
		print selection[i].Name
)

......最初の例に比べて、ちょっとゴチャゴチャしてますね。最初に i に 1 が代入されて、1,2,3,...と selection.count（選択されているオブジェクトの数）まで加算しながら繰り返し処理を行います。

具体的な例を見てみましょう。今、Box001, Box002, Box003 が選択されているとします。そこで、サンプルコードを走らせるとどうなるでしょう；

/* 1度目のループ*/
s = selection[1] --s に $Box001 が入る
print s.Name     --"Box001"

/* 2度目のループ */
s = selection[2] --s に $Box002 が入る
print s.Name     --"Box002"

/* 3度目のループ */
s = selection[3] --s に $Box003 が入る
print s.Name     --"Box003"


/* おわり */

......for の部分を全て展開するとこのようになります。もちろん、このように書いても選択されているものの数が3つと決まっていれば同じことができますが、数が増えたり、名前以外のものを表示したいとなると途端に破綻してしまいます。せっかく苦労してスクリプトを書くのだから、どうせなら何度でも使い回せるようにした方が良いですよね。

for をさらに使いこなしてみる

名前を表示するだけなのも飽きてきました。もうちょっと別の使い方も考えてみます。
せっかくCGソフトなので、オブジェクトを操作してみましょう。
100 個のオブジェクトを配置してみます。

for i=0 to 9 do (
		for j=0 to 9 do (
				x = i * 10
				y = j * 10
				box = Box pos:[x, y, 0] length:1 width:1 height:1
				box.Name = "Box_" + (i as String) + "_" + (j as String)
		)
)

......何だかいきなり複雑になってしまいました。ですが、ひとつひとつの構成要素をじっくり見ていけば理解できますよ。
一番大きな違いは、for 文の中に for 文が入っていることです。さらに、内側の for 文の中身もよく分からない記号が沢山入っています。
こういう時には、MAXScript エディタの機能を使います。

内側の for の左にある四角の部分をクリックしてみてください。すると!! for が折り畳まれて、 シンプルな見た目になりました。

さらに外側の for の中身も折り畳んでみてください。シンプルな for だけのブロックになりました。

こうして見ると、外側の for によって i が 0 から 9 まで変化しながら毎回内側の for が 呼ばれていることが判ります。
これを理解できてしまえば、後は一番内側のブロックを解析するだけです。

x = i * 10
y = j * 10

「x」と「y」という名前の変数にループで加算される値を 10 倍して代入しています。

box = Box pos:[x, y, 0] length:1 width:1 height:1

......Box ジオメトリを生成しています。 pos や length, width, height は Box を作る際のオプションです。先ほどシーンを再構築するために MAXScript リスナーの値をコピー＆ペーストした時にもありましたね。
GUI から作るとこれ以外にも様々なオプションがつきますが、必須ではないので省略しています。

box.Name = "Box_" + (i as String) + "_" + (j as String)

作成した「Box」の名前を付けています。 文字列は '+' を使って繋げることができます。
「 (i as String) 」という部分は、i という数値を文字列に変換しています。
数値と文字列は、画面で見たときにはほとんど違いがありませんが、コンピュータからみたら大きな違いがあります。

a = 1 -- a には数値の 1 が入る
b = a + a -- 数値を足しているので b は 2
a = "1" -- a には文字列の 1 が入る
b = a + a -- 文字列を足しているので b は "11"

人間が計算をする時はその場に応じてその値が数字なのか文字列なのか、それらをどのように扱ったらいいのか判断をしながら処理ができますが、コンピュータに処理をさせる時には厳密に指示をしなければいけません。そのため、わざわざ明示的に文字列に変換しているのです。
これは数値や文字列に限らず、プログラミングを行う上でとても大事なことになってきます。プログラムがなぜかエラーになるのかとか、マニュアルで調べた機能をどのように使うのか分からない時は、プログラム上で今どのような形式のデータを扱っているのか注意すると問題が解決することが多々あります。

因みに、ループで selection から 取り出した s の中には、数値でも文字列でもない、ジオメトリという形式のデータが入っていました。そして、今解説中の Box にも同じ形式のデータが入っています。
マニュアルで「Box」を調べてみてください。検索すると、"Box: GeometryClass" という項目が見つかります。このページを見ると、Box に指定できるプロパティの一覧を知ることができます。そこを見てみると、Box ジオメトリを生成するときに使用した「length」、「width」、「height」などのオプションもあります。

それ以外の、「pos」や「Name」などはどこにあるのでしょうか？　これは［ノードの共通プロパティ、演算子、メソッド］にあります。
pos や Name は Box に特有のものではなく、Sphere や Plane にもあります。Max ではこれらを総称して「ノード」と呼び、ノードは共通のプロパティを持っています。ノードの一覧は［GeometryClass: Node］の項目で見ることができます。

今、自分がどのような種類のデータを扱っているか知りたいときに便利なのが classOf メソッドです。
classOf <変数、オブジェクトなど> と実行すると、データの種類を表示してくれます。

データの種類が判れば、それを元にマニュアルを参照して何ができるのかを調べたり、スクリプト内でどのような処理がされているのかを理解することができます。
そのジオメトリにどのようなプロパティがあるかなど、より詳細な内容を知りたければ「showProperties」のようなメソッドを使います。これらの使い方は次回以降、必要に応じて解説します。興味のある方はリファレンスの［クラスとオブジェクトの調査関数］を参照してみてください。

さて、解説が長くなってしまいましたが、これで全ての内容が理解できるはずです。いかがでしょうか？
今回解説したループと、MAXScript リスナーを上手に使えば今まで手で何百回と繰り返してきた単純作業をスクリプトに任せることができるようになります。ぜひ、活用してみてください。次回以降は、より具体的な応用例をご紹介していきます。