Editable_Mesh : GeometryClass および TriMesh : 値

コンストラクタ (Editable_Mesh)

editable_mesh... 

空のメッシュを作成します。

mesh [ length:<integer> ] [ width:<integer> ]  [ lengthsegs:<integer> ] [ widthsegs:<integer> ] 

所定のサイズとセグメント数を持つ、平らで矩形のメッシュを作成します。長さおよび幅の既定値は 50、セグメント数の既定値は 5 です。

mesh [ numverts:<number> ] [ numfaces:<number> ] 

所定のジオメトリのメッシュを作成しますが、このメッシュにはトポロジ(面や頂点)がありません。このメッシュにはトポロジ(面や頂点)がないため、頂点を個別に指定して、面を作成しなければなりません。頂点と面の既定値は、それぞれ 36 と 50 です。

mesh [ mesh:<TriMesh>] 

指定された TriMesh 値をメッシュ ソースとして使用して、メッシュを作成します。

mesh vertices:<array_of_point3s> faces:<array_of_point3s> [ materialIDs:<array_of_integers> ] [ tverts:<array_of_point3s> ] 

頂点と面の配列からメッシュを作成します。 vertices 配列の各 Point3 値は、現在の座標系における頂点の位置を指定します。 faces 配列の各 Point3 値は、面を形成する 3 つの頂点のインデックスを指定します。 materialIDs 配列は、各面に割り当てられるマテリアル ID を指定します。

tverts 配列の各 Point3 値は、テクスチャ頂点の UVW 座標を指定します。テクスチャ頂点の詳細については、メソッド セクションの「テクスチャ マップ」を参照してください。

この形式のコンストラクタを使ったメッシュ構築の例を次に示します。

mesh vertices:#([0,0,0],[10,0,0],[0,10,0],[10,10,0]) \
faces:#([1,2,3],[2,4,3]) materialIDS:#(1,2)

mnode = mesh vertices:#([0,0,0],[10,0,0],[0,10,0],[10,10,0]) tverts:#([0,0,0],[10,0,0],[0,10,0],[10,10,0]) faces:#([1,2,3],[2,4,3])
mmesh = mnode.mesh
buildTVFaces mmesh
for i = 1 to mmesh.numfaces do(setTVFace mmesh i (getFace mmesh i))

collapseStack <node> -- mapped 

ノードのスタックの最上位にある評価結果に対応した基本オブジェクトを残して、スタックからオブジェクト空間モディファイヤを集約します。つまり、スタック最上位の結果が Editable_Mesh である場合に限り、結果は Editable_Mesh になります。モディファイヤの中には、オブジェクト クラスを暗黙的に変換するものがあります。たとえば、MeshSmooth は入ってくるジオメトリをポリゴンに暗黙的に変換するので、最上位に MeshSmooth があるボックスは Editable_Poly に集約します。メッシュ スムーズ モディファイヤの上に MeshSelector とメッシュに変換モディファイヤを追加し、 collapseStack() を呼び出すと、Editable_Mesh ベース オブジェクトが得られます。

b = box() --create a box
--> $Box:Box01 @ [0.000000,0.000000,0.000000]
addModifier b (MeshSmooth()) --add meshSmooth modifier
--> OK
classof b --check the class - it was turned into Polygons!
--> PolyMeshObject
collapseStack b --collapse the stack of the box
--> OK
classof b --the result is Editable_Poly
--> Editable_Poly
addModifier b (Turn_To_Mesh()) --now add Turn To Mesh modifier
--> OK
classof b --the class is now Editable_Mesh and not Editable_Poly!
--> Editable_mesh
collapseStack b --collapse the stack
--> OK
classof b --as expected, the result is an Editable_Mesh!
--> Editable_mesh

これを呼び出すときにスタックの中にモディファイヤが存在しない場合は、何も行われません。このため、(たとえば、以下に示すメッシュ操作を行うために)オブジェクトを強制的に編集可能メッシュにする場合は、Null のモディファイヤを適用し、それからスタックを集約します。

b = box() --create a box
--> $Box:Box03 @ [0.000000,0.000000,0.000000]
collapseStack b --try to collapse the stack
--> OK
classof b --it is still a box - nothing to collapse!
--> Box
addModifier b (meshSelect()) --add a MeshSelect modifier
--> OK
collapseStack b --try to collapse the stack again
--> OK
classof b --this time it worked!
--> Editable_mesh

collapseStack() は、ワールド空間モディファイヤ(スペース ワープへのバインドを含む)の効果を集約しません。ワールド空間モディファイヤは、オブジェクトのスタック上に残ります。ワールド空間モディファイヤを含むオブジェクトをメッシュに集約するには、 snapshot() メソッドを使用します。

snapshot <node> -- mapped

この関数は、3ds Max のスナップショット ツールと同様の機能を持ちます。スナップショットが作成されるときに、ソース < node > のワールド状態メッシュのコピーを含む新しいノードを生成します。既存のモディファイヤはすべて新しいノードから集約され、メッシュ スナップショットには、現在適用されているすべてのスペース ワープが反映されます。

convertToMesh <node> -- mapped

該当するシーン オブジェクト タイプを編集可能メッシュに変換します。この関数は、存在するすべてのオブジェクト空間モディファイヤを削除する collapseStack() に似ていますが、 collapseStack() とは異なり、たとえモディファイヤが存在しない場合でも、常に基本オブジェクトを編集可能メッシュに置き換えます。

この関数は、メッシュ編集モディファイヤが作用するジオメトリやシェイプなどのすべてのオブジェクトに適用できますが、ヘルパーやスペース ワープ、ライト、その他には適用できません。

convertTo <node> [ TriMeshGeometry | Mesh ] -- mapped

該当するシーン オブジェクト タイプを編集可能メッシュに変換します。この関数の操作方法は、 convertToMesh() と同じです。

コンストラクタ(TriMesh)

TriMesh() 

空の TriMesh を作成します。以下に示すメソッドを使って、メッシュを作成します。

<node>.mesh 

メッシュに変換可能な場合はノードのワールド状態のコピーを抽出します。

<editable_mesh_baseobject>.mesh 

基本オブジェクトのメッシュのコピーを抽出します。

<trimesh>.mesh 

もう 1 つの TriMesh のメッシュのコピーを抽出します。

演算子

以下の操作は、メッシュ上でブール値操作を実行します。これらの操作では、同じブール値の < node > 操作のように、ブール値の結果を含むように最初のオペランド メッシュを完全に修正します。

<mesh> + <mesh> -- union
<mesh> - <mesh> -- difference
<mesh> * <mesh> -- intersection

プロパティ

<mesh>.numverts Integer 

頂点の数を取得/設定します。 numVerts プロパティまたは setNumVerts メソッドを使用して頂点の数を設定する場合は、新しい頂点が[0.,0.,0.]に設定されます。

<mesh>.numfaces Integer 

面の数を取得/設定します。

3ds Max 7 以前のバージョンでは、update を呼び出す前に、メッシュを再度初期化して有効にする必要がありました。3ds Max 7 以上では、 .numfaces の値を設定するか setNumFaces 関数を呼び出すと自動的に再度初期化が行われます。

$.numfaces=300
--is equivalent to
setNumFaces $ 300 false
--The false argument means to not keep the existing topology

新しい面の場合は、すべてについて次のように設定されます。

• スムージング グループが 1 に設定されます

• 頂点は、[1,1,1]に設定されます(基数が 1。更新時に頂点数が 0 の場合はクラッシュします。このクラッシュは、この時点で予想される状況です）

• マテリアル ID は 1 に設定されます(基数 1)

• 使用中のマップ チャネルは、それぞれ次のように設定されます

  • マップ面の頂点は、[1,1,1]に設定されます

  • 既存のトポロジを保持しない場合、マップの頂点数は 1 に設定され、頂点は[1,1,1]に設定されます(基数 1)

<mesh>.numtverts Integer 

テクスチャ頂点の数を取得/設定します。 numTVerts プロパティまたは setNumTVerts メソッドを使用してテクスチャ頂点の数を設定する場合は、新しい頂点が[0.,0.,0.]に設定されます。

<mesh>.numcpvverts Integer 

頂点ごとのカラーを持つ頂点の数を取得/設定します。 numCPTVerts プロパティまたは setNumCPVVerts メソッドを使用して CPV 頂点の数を設定する場合は、新しい頂点が[0.,0.,0.]に設定されます。

<mesh>.mesh TriMesh 

このプロパティを読み込むと、モディファイヤが適用済みでスペース ワープが適用される前のメッシュのコピーが生成されます。このプロパティを割り当てると、メッシュに所定の TriMesh 値が設定されます。このプロパティを copy() および <node_or_baseobject>.mesh プロパティとともに使用して、他のオブジェクトのメッシュから TriMesh を構築できます。

<mesh>.selectedVerts VertexArray 

編集可能メッシュオブジェクトの現在選択されている頂点を取得します。「VertexSelection 値」を参照してください。

<mesh>.verts VertexArray 

編集可能メッシュ オブジェクトのすべての頂点を取得します。「VertexSelection 値」を参照してください。

<mesh>.selectedFaces FaceArray 

編集可能メッシュ オブジェクトの現在選択されている面を取得します。「FaceSelection 値」を参照してください。

<mesh>.Faces FaceArray 

編集可能メッシュ オブジェクトのすべての面を取得します。「FaceSelection 値」を参照してください。

<mesh>.selectedEdges EdgeArray 

編集可能メッシュ オブジェクトの現在選択されているエッジを取得します。「EdgeSelection 値」を参照してください。

<mesh>.Edges EdgeArray 

編集可能メッシュ オブジェクトのすべてのエッジを取得します。「EdgeSelection 値」を参照してください。

<mesh>.displacementMapping Boolean 

編集可能メッシュ オブジェクトのディスプレイスメント マッピングを実行するかどうかを取得/設定します。このプロパティに対応するユーザ インタフェース要素はありません。

<mesh>.subdivisionDisplacement Boolean 

編集可能メッシュ オブジェクトのサブディビジョン ディスプレイスメントを実行するかどうかを取得/設定します。このプロパティは、[サーフェス プロパティ](Surface Properties)ロールアウトの[サブディビジョンでディスプレイスメント](Subdivision Displacement)チェックボックスに相当します。

<mesh>.splitMesh Boolean 

サブディビジョン ディスプレイスメント中にメッシュを分割するかどうかを取得/設定します。このプロパティは、[サーフェス プロパティ](Surface Properties)ロールアウトの[メッシュを分割](Split Mesh)チェックボックスに相当します。このプロパティを設定すると、 subdivisionDisplacement が有効になります( false に設定した場合)。

VertexSelection、FaceSelection、または EdgeSelection を返すプロパティ以外の上記のプロパティでは、読み込みと割り当ての両方を行えます。これらのプロパティに、頂点や面のの空間を追加するために数を割り当てると、メッシュを最初から作成するものとみなされ、メッシュは現在のトポロジ/ジオメトリ(頂点、面、エッジ)をすべて消失します。現在のトポロジ/ジオメトリを維持する場合は、以下に説明する setNumVerts() 、 setNumTVerts() および setNumFaces() メソッドを使用します。

N までの頂点座標は、N がメッシュ内の頂点数である編集可能オブジェクトのプロパティとして使用できます。コントローラが頂点に割り当てられると、頂点はプロパティとして使用できます。コントローラは、 animateVertex() メソッドを使用して頂点に割り当てることができます。詳細については、「頂点およびコントロール ポイントのアニメーションのスクリプト」を参照してください。たとえば、球オブジェクトが編集可能メッシュに集約し、頂点のいくつかがアニメートされている場合、頂点のプロパティは次のようになります。

$Sphere01.vertex_209 Point3 value:[7.9,-40.0,0.0] -- animatable
$Sphere01.vertex_210 Point3 value:[-7.8,-39.3,-7.9] -- animatable
$Sphere01.vertex_211 Point3 value:[0.0,-40.0,-7.9] -- animatable

update <mesh> [ geometry:<boolean> ] [ topology:<boolean> ] [ normals:<boolean> ] -- mapped

attach <mesh> <node> 

meshop.attach{<target_editable_mesh_node> | <target_mesh>} \ 
{<source_node> | <source_mesh>} \ 
targetNode:<node=unsupplied> \ 
sourceNode:<node=unsupplied> \ 
attachMat:<{#neither | #MatToID | #IDToMat}=#neither>\ 
condenseMat:<boolean=true> \ 
deleteSourceNode:<boolean=true> 

meshop.attach $.baseobject $sphere02 targetNode:$
meshop.attach $box01 $box02 attachMat:#IDToMat \
condenseMat:true deleteSourceNode:false

meshopgetUIParam. <mesh> <param_name> 
meshop.getUIParam <node> [ <modifier_or_index> ] <param_name> 
meshop.setUIParam <mesh> <param_name> { <float> | <boolean> } 
meshop.setUIParam <node> [ <modifier_or_index> ] <param_name> { <number> | <boolean> } 

<float>mesh_weld_overlapping_vertices <TriMesh>mesh

s = sphere segs:128 --create a sphere with 128 segments
--> $Sphere:Sphere001 @ [0.000000,0.000000,0.000000]

convertToMesh s --convert to Editable Mesh
--> $Editable_Mesh:Sphere001 @ [0.000000,0.000000,0.000000]

s.numverts --check the number of vertices
--> 8066

s1 = copy s --clone the sphere as a copy
--> $Editable_Mesh:Sphere002 @ [0.000000,0.000000,0.000000]

attach s s1 --attach the copy to the original
--> OK

s.numverts --check number of vertices again – it is doubled
--> 16132

mesh_weld_overlapping_vertices s.mesh --weld the overlapping vertices
--> 0.888889

s.numverts --check the number of vertices again...
--> 8066