[作成](Create)パネル

startObjectCreation() メソッドは、ユーザがオブジェクトクラスの[作成パネル](Create Panel)ボタンを押す動作をシミュレートするのに使われます。これを使用すると、そのオブジェクトクラスに対する 3ds Max が作成モードになります。

形式は次のとおりです。

startObjectCreation <maxobjclass> [		returnNewNodes:<flag>] [		newNodeCallback:<fn>]

このメソッドは、右タブとカテゴリを持つ[作成](Create)パネルを開き、適切なオブジェクトボタンを押します。

例:

startObjectCreation box
startObjectCreation targetSpot

このメソッドは、主にマクロスクリプトで使用しますが、一般化されたスクリプト内でも使用できます。スクリプトの実行は、作成モードになった直後に継続されるので、オブジェクトの作成に影響を及ぼさないよう注意する必要があります。

オプションの returnNewNodes: キーワード引数には、 true 、 false (既定値)、または #first を指定できます。 true を指定すると、現在の作成モードを終了するまで、作成したすべてのノードは配列で返されます。#first を指定すると、最初に作成されたノードだけが、作成直後に返されます。この関数は、ユーザが作成モードを終了するまで待機しません。

オプションの newNodeCallback: キーワード引数は、1 つの引数のスクリプト関数を、開始される作成モードに指定できます。この関数は、引数に新しいノードを指定してノードが作成されるたびに呼び出されます。これは、 pickObject() フィルタ関数を指定する場合に似ています。ただし、 newNodeCallback: 関数の戻り値は無視されます。

注:コールバック関数は、基本オブジェクトがインストールされる*前*の、新規ノード作成時にすぐに呼び出されます。このため、このコールバック中にアクセスおよび変更が可能なのは、ノード関連のプロパティだけです。

例:

fn setColor n = n.wireColor= red
startObjectCreation box newNodeCallback:setColor

これにより、開始した作成モードで作成された新規ボックスすべてのワイヤカラーが赤になります。

returnNewNodes: と newNodeCallback: は、両方とも同じ呼び出しに指定できます。コールバックは各ノードで呼び出され、それらは、 startObjectCreation() 関数の結果として配列に返されます。

okToCreate <maxclass>

指定した maxclass をユーザインタフェースで作成できる場合は true を、作成できない場合は false を返します。引数が undefined の場合にも、 false を返します。

例:

okToCreate terrain

少なくとも 1 つのシェイプも選択されていない場合、または非シェイプが選択されている場合は、 false を返します。これは、オブジェクトのボタンが使用可能かどうかに対応します。

isCreatingObject [ <maxclass> ]

指定した maxclass がユーザインタフェース上で現在作成されている場合は true を、作成されていない場合は false を返します。

引数なしで呼び出された場合、ユーザインタフェース上で何らかのオブジェクトが作成されている場合には true を、作成されていない場合には false を返します。

3ds Max 2010 以降では、 okToCreate() との整合性のため、引数が undefined の場合にも false を返します。

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

例:

--go to Create panel, click the Box button and evaluate:
isCreatingObject Box
true
--in the Create panel, click on the Cone button and evaluate:
isCreatingObject Box
false
isCreatingObject Cone
true
isCreatingObject()
true

[作成](Create)パネル

関連事項