パッチオブジェクト

パッチは、すべてのパッチオブジェクトの一般的な編集可能バージョンで、編集可能メッシュのジオメトリオブジェクトに対する関係と似ています。パッチは、編集モディファイヤを適用するとパッチオブジェクトに変換され、またパッチ基本オブジェクトのモディファイヤスタックを集約すると、結果はパッチオブジェクトになります。MAXScript ではパッチを構築することはできますが、パッチオブジェクト内のサブオブジェクト(頂点、エッジ、およびパッチ)にアクセスしたり、これらのサブオブジェクトを修正するプロパティやメソッドはありません。

コンストラクタ

Quadpatch...
Tripatch...

パッチシーンオブジェクトをゼロから作成するために、パッチコンストラクタ関数を呼び出すことができます。

例
    Quadpatch pos:[10,10,10] name:"foo"
これにより、空のパッチが作成されます。

convertTo <node> Editable_Patch -- mapped

これは与えられたシーンノードをパッチオブジェクトに変換します。オブジェクトを変換できない(通常はジオメトリオブジェクトでない)場合、この関数は undefined を返します。存在するモディファイヤはすべて集約されます。collapseStack() 関数も、3ds Max の[モディファイヤスタック](modifier stack)ダイアログボックスにおける[集約] (collapse)ボタンと同じ用途で使用できます。いずれもパッチを生成しますが、これは少なくとも 1 つのモディファイヤが存在するときに限られます。

プロパティ

コントロール頂点とその接線は、コントローラがコントロール頂点に割り当てられた後で、プロパティとして使用できます。コントロール頂点の接線の数は、コントロール頂点に関連するエッジの数になります。コントローラは MAXScript を使用するコントロール頂点には割り当てることができません。TriPatch オブジェクトが Editable_Patch に集約され、コントロール頂点のいくつかがアニメートされている場合、コントロール頂点と接線のプロパティは次のようになります。

$TriPatch01.Vertex_1 Point3value:[-21.5,-6.4,0] -- animatable
$TriPatch01.Vertex_1_Vector_1 Point3value:[-21.5,-2.1,0] -- animatable
$TriPatch01.Vertex_1_Vector_2 Point3value:[-7.1,-6.4,0 ]-- animatable
$TriPatch01.Vertex_2 Point3value:[21.5,-6.4,0] -- animatable
$TriPatch01.Vertex_2_Vector_1 Point3value:[7.1,-6.4,0] -- animatable
$TriPatch01.Vertex_2_Vector_2 Point3value:[7.1,-2.1,0] -- animatable

パッチ頂点と接線へのアクセスについては「クラスとオブジェクトの調査関数」を参照してください。頂点および接線ハンドラに割り当てられたコントローラ値はオブジェクト空間内にあります。ワールド空間からオブジェクト空間への変換については、「ノード変換プロパティの使い方」を参照してください。

メソッド

getPatchSteps <editable_patch_node>

パッチが使用するビューポートのステップ数を返し、[ステップを表示](View Steps)スピナーを[修正] (Modify)パネルに反映します。

setPatchSteps <editable_patch_node> <integer>

編集可能なパッチオブジェクトによって使用される[ステップを表示](View Steps)の数を指定された値に設定します。

[編集可能パッチの修正](Editable Patch Modify)パネルコマンドモードと操作

スクリプトで[編集可能パッチ](Editable Patch)、[編集メッシュの修正](Edit Mesh Modify)パネルモードと操作を呼び出すために、一連のメソッドが用意されています。これらはさまざまなサブオブジェクトレベルで使用できるボタンに対応しています。これらのメソッドは、patchOps グローバル構造体内にあります。[修正] (Modify)パネルにあるボタンを押して操作することができます。これらのメソッドを使用するには、ノードを選択して[修正] (Modify)パネルを開かなければなりません。最初の引数 <editable_patch_node_or_modifier> は、モディファイヤスタックレベルが基本オブジェクトに位置するパッチを編集可能パッチノード、またはモディファイヤスタックレベルが編集パッチに位置する編集パッチモディファイヤとして解釈されます。以下のメソッドは、現在のサブオブジェクトレベルがメソッドの呼び出しに適切なレベルである場合に有効です。

次のメソッドは、現在選択されているサブオブジェクトに対して、[編集可能パッチの修正](Editable Patch Modify)パネル内にある「ユーザ相互作用」ボタンの操作を呼び出します。これらのメソッドは、[ジオメトリ] (Geometry)ロールアウト内の対応するボタンをハイライトして操作を開始します。ここで、ユーザはインタラクティブに操作を実行します。メソッドは、操作の開始からユーザの操作完了までの間に返されるため、使用するスクリプトが操作の妨げにならないようにする必要があります。これらのメソッドを呼び出すことは、[修正] (Modify)パネルの関連するボタンをクリックすることと同じです。ユーザのアクションまたは MAXScript コマンドにより操作がすでに実行されている場合にメソッドを呼び出すと、操作が中止され、ボタンのハイライトが消えます。

patchOps.startAttach <editable_patch_node_or_modifier>

[アタッチ] (Attach)コマンドモードに入ります。これは、すべてのサブオブジェクトレベルで、サブオブジェクトモード以外のときに有効です。

patchOps.startBevel <editable_patch_node_or_modifier>

[ベベル] (Bevel)コマンドモードに入ります。パッチサブオブジェクトレベルで有効です。

patchOps.startBind <editable_patch_node_or_modifier>

[バインド] (Bind)コマンドモードに入ります。これは、頂点サブオブジェクトレベルで有効です。

patchOps.startCreate <editable_patch_node_or_modifier>

[作成] (Create)コマンドモードになります。頂点、パッチ、要素のサブオブジェクトレベルで有効です。

patchOps.startExtrude <editable_patch_node_or_modifier>

[押し出し] (Extrude)コマンドモードに入ります。パッチサブオブジェクトレベルで有効です。

patchOps.startFlipNormalMode <editable_patch_node_or_modifier>

[法線を反転](Flip Normal)コマンドモードになります。パッチと要素のサブオブジェクトレベルで有効です。

patchOps.startWeldTarget <editable_patch_node_or_modifier>

[ターゲットの連結](Weld Target)コマンドモードになります。頂点サブオブジェクトレベルで有効です。

次のメソッドは、現在選択されているサブオブジェクトに対して、[編集可能パッチの修正](Editable Patch Modify)パネルにある[即時] (instantaneous)ボタン操作を呼び出します。

patchOps.addTri <editable_patch_node_or_modifier>

TriPatch を選択したエッジに追加します。エッジサブオブジェクトレベルで有効です。

patchOps.addQuad <editable_patch_node_or_modifier>

QuadPatch を選択したエッジに追加します。エッジサブオブジェクトレベルで有効です。

patchOps.break <editable_patch_node_or_modifier>

選択されているサブオブジェクトにアタッチするパッチに対して、それぞれ 1 つの新しい頂点を作成します。頂点およびエッジサブオブジェクトレベルで有効です。

patchOps.clearAllSG <editable_patch_node_or_modifier>

現在選択されているパッチのスムーズグループをクリアします。面、ポリゴン、要素のサブオブジェクトレベルで有効です。

patchOps.createShapeFromEdges <editable_patch_node_or_modifier>

[シェイプを作成](Create Shape)ダイアログボックスを表示し、選択されたエッジから作成するシェイプにオブジェクト名を指定できます。これは、エッジサブオブジェクトレベルで有効です。

patchOps.delete <editable_patch_node_or_modifier>

選択したサブオブジェクトを削除します。これは、すべてのサブオブジェクトレベルで有効です。

patchOps.detach <editable_patch_node_or_modifier>

ユーザがオブジェクト名を指定できる[デタッチ] (Detach)ダイアログボックスを表示します。これは、パッチサブオブジェクトレベルで有効です。

patchOps.flipNormal <editable_patch_node_or_modifier>

選択されているパッチの法線を反転します。パッチと要素のサブオブジェクトレベルで有効です。

patchOps.hide <editable_patch_node_or_modifier>

選択したサブオブジェクトを非表示にします。これは、すべてのサブオブジェクトレベルで有効です。

patchOps.selectByID <editable_patch_node_or_modifier>

[マテリアル ID による選択](Select By Material ID)ダイアログボックスを表示して、指定したマテリアル ID を持つパッチを選択します。- パッチと要素のサブオブジェクトレベルで有効です。

patchOps.selectBySG <editable_patch_node_or_modifier>

[スムーズグループによる選択](Select By Smooth Groups)を表示して、指定したスムーズグループ ID を持つパッチを選択します。パッチと要素のサブオブジェクトレベルで有効です。

patchOps.selectOpenEdges <editable_patch_node_or_modifier>

1 つのパッチしかないエッジをすべて選択します。これは、エッジサブオブジェクトレベルで有効です。

patchOps.subdivide <editable_patch_node_or_modifier>

選択したサブオブジェクトを分割します。これは、エッジとパッチのサブオブジェクトレベルで有効です。

patchOps.unbind <editable_patch_node_or_modifier>

選択した頂点のバインドを解除します。これは、頂点サブオブジェクトレベルで有効です。

patchOps.unifyNormal <editable_patch_node_or_modifier>

選択したパッチの法線を統一します。これは、パッチと要素のサブオブジェクトレベルで有効です。

patchOps.unhideAll <editable_patch_node_or_modifier>

非表示のサブオブジェクトをすべて再表示します。これは、すべてのサブオブジェクトレベルで、サブオブジェクトモード以外のときに有効です。

patchOps.weld <editable_patch_node_or_modifier>

選択した頂点を結合します。これは、頂点サブオブジェクトレベルで有効です。

3ds Max 6 以降では、次のメソッドが使用できます。

patchOps.growSelection <editable_patch_node_or_modifier>

選択を広げます。ハンドル以外のすべてのサブオブジェクトレベルで有効です。

patchOps.shrinkSelection <editable_patch_node_or_modifier>

選択を縮小します。ハンドル以外のすべてのサブオブジェクトレベルで有効です。

patchOps.selectEdgeRing <editable_patch_node_or_modifier>

エッジのリングを選択します。エッジサブオブジェクトレベルで有効です。

patchOps.selectEdgeLoop <editable_patch_node_or_modifier>

エッジのループを選択します。エッジサブオブジェクトレベルで有効です。

patchOps.patchSmooth <editable_patch_node_or_modifier>

ハンドルを平均化することでパッチをスムージングします。

patchOps.toggleShadedFaces <editable_patch_node_or_modifier>

シェーディング面を切り替えます。

パッチオブジェクトを作成、変更、およびアクセスするための多くの関数を含む patch 構造体もあります。

以下の関数は、パッチのタイプを取得するときに使います。

patch.getPatchType < patch_object >

#triPatch、#quadPatch、#undefPatch、または 'undefined' を返します。#undefPatch の値は、サードパーティが定義したパッチオブジェクトによって返されることもあります。「undefined」の値は、内部パッチタイプが定義済みの値リストにない場合に返されます。

パッチのジオメトリ全体を取得および設定する

keep:true を setNumXXX 関数に設定し、関数が既存の vertex/vector/patch/edge データを保持するようにします。この値の既定値は false で、ジオメトリを空にします。

patch.getNumVerts <obj>

頂点の数を整数値で返します。

patch.setNumVerts <obj> <num> [keep:<boolean>]

頂点の数を整数値に設定します。

patch.getNumVecs <obj>

ベクトルの数を整数値で返します。

patch.setNumVecs <obj> <num> [keep:<boolean>]

ベクトルの数を整数値に設定します。

patch.getNumPatches <obj>

パッチの数を整数値で返します。

patch.setNumPatches <obj> <num> [keep:<boolean>]

パッチの数を整数値に設定します。

patch.getNumEdges <obj>

エッジの数を整数値で返します。

patch.setNumEdges <obj> <num> [keep:<boolean>]

エッジの数を整数値に設定します。

頂点とベクトルハンドルの位置を個別に取得および設定する

頂点とベクトル座標は、MAXScript の現在の作業座標コンテキスト内で解釈されます。他の MAXScript と同様に、頂点、パッチ、ベクトル、エッジのインデックスは、すべて 1 から始まります。

patch.getVert <obj> <index>

インデックスで指定された頂点を Point3 値として返します。

patch.setVert <obj> <index> <point3>

インデックスで指定された頂点を Point3 値に設定します。

patch.getVec <obj> <index>

インデックスで指定されたベクトルを Point3 値として返します。

patch.setVec <obj> <index> <point3>

インデックスで指定されたベクトルを Point3 型の値に設定します。

パッチメッシュ内にパッチを個別に作成する

patch.makeQuadPatch <obj> <index> <va> <vab> <vba> <vb> <vbc> <vcb> <vc> <vcd> <vdc> <vd> <vda> <vad> <i1> <i2> <i3> <i4> <sm>

ここで、

index = 作成するパッチのインデックス(0> = インデックス < numPatches)。
va = 最初の頂点。
vab はベクトル ab です。
vba = ベクトル ba。
vb = 2 番目の頂点。
vbc はベクトル bc です。
vcb = ベクトル cb。
vc = 3 番目の頂点。
vcd はベクトル cd です。
vdc = ベクトル dc。
vd = 4 番目の頂点。
vda はベクトル da です。
vad はベクトル ad です。
i1 = 内部 1。
i2 = 内部 2。
i3 = 内部 3。
*i4 *= 内部 4。
*sm *= スムージンググループマスク

patch.makeTriPatch <obj> <index> <va> <vab> <vba> <vb> <vbc> <vcb> <vc> <vca> <vac> <i1> <i2> <i3> <sm>

ここで、

index = 作成するパッチのインデックス(0> = インデックス < numPatches)。
va = 最初の頂点。
vab はベクトル ab です。
vba = ベクトル ba。
vb = 2 番目の頂点。
vbc はベクトル bc です。
vcb = ベクトル cb。
vc = 3 番目の頂点。
vca はベクトル ca です。
vac = ベクトル ac。
i1 = 内部 1。
i2 = 内部 2。
i3 = 内部 3。
*sm *= スムージンググループマスク