Editable_Mesh : GeometryClass および TriMesh : 値
 
 
 
 

   

編集可能メッシュ - クイック ナビゲーション

Editable_Mesh は、モディファイヤ スタックを編集可能メッシュ オブジェクトに集約してできるノード オブジェクトのクラスです。MAXScript でメッシュを修正するメッシュ操作の多くは、Editable_Mesh シーン ノードにのみ作用します。

TriMesh クラスは、下位レベル 3ds Max SDK Mesh クラスの MAXScript 値のラップの 1 つです。このメッシュ クラスは、3ds Max 内のメッシュ ベースのオブジェクトおよびモディファイヤで広範囲に使われます。メッシュは、三角形メッシュに実際の頂点や面配列などを保持します。たとえば、Editable_Mesh オブジェクトはメッシュのインスタンスを含みます。TriMesh クラスの主な用途は、スクリプトで書かれたプリミティブ オブジェクトのプラグインにアクセスできるようにし、ジオメトリ オブジェクトの内部に Mesh オブジェクトを構築することです。このクラスには、広範囲なメッシュ操作の関数および作図関数が含まれ、Editable Mesh シーン ノードの下位レベル メッシュ操作に相当します。

このトピックで説明されるプロパティとメソッドは、< mesh > の値タイプで表される Editable_Mesh オブジェクトおよび TriMesh 値の両方に適用できます。TriMesh 値だけに適用できるプロパティとメソッドは < trimesh > の値タイプで表されます。

警告

MAXScript で作成されるメッシュは triMesh 値です。

注:

update() 関数だけがメッシュの内部キャッシュおよび 3ds Max ビューポートのイメージを更新します。これは、更新操作は計算面で負担が大きく、関数呼び出しのたびに更新を実行するのは好ましくないからです。ただし、一連の変更を行った後で、3ds Max でメッシュを操作する前や MAXScript で他の関数を使ってメッシュを操作する前に、必ず update() 関数を呼び出す必要があります

座標は、MAXScript の作業座標系で与えられます。

[修正]パネルで選択され、現在開かれているオブジェクトに対して update() 関数を呼び出すと、3ds Max のクラッシュを回避するため現在の選択が解除されます。現時点では、[修正]パネルで開いているオブジェクトに対するスクリプトの変更はサポートされていません。

メッシュを作成または修正するとき、メッシュでまだ update() を実行していない場合、3ds Max ウィンドウを最小化してから最大化すると 3ds Max がクラッシュすることがあります。これは、不完全なメッシュが作成され、内部 3ds Max のメッシュ構造が不安定な状態に置かれるためです。

コンストラクタ (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)
注:オプションの tverts 配列機能は現在機能していません。テクスチャ頂点は正しく設定されますが、テクスチャ面は内部では構築されません。これが修正されるまでは、次のようにユーザ自身でテクスチャ面を構築してこの問題を回避してください。

対応例:

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.numfacesdo(setTVFace mmesh i (getFace mmesh i))
collapseStack <node> -- mapped 

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

b = box() --ボックスを作成
$Box:Box01 @ [0.000000,0.000000,0.000000]
addModifier b (MeshSmooth()) --meshSmooth モディファイヤを追加
OK
classof b --クラスをチェック - ポリゴンに変わりました
PolyMeshObject
collapseStack b --ボックスのスタックを集約
OK
classof b --結果は Editable_Poly
Editable_Poly
addModifier b (Turn_To_Mesh()) --Turn To Mesh モディファイヤを追加
OK
classof b --クラスは Editable_Poly ではなく Editable_Mesh
Editable_mesh
collapseStack b --スタックを集約
OK
classof b --予想どおり、結果は Editable_Mesh です
Editable_mesh

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

b = box() --ボックスを作成
$Box:Box03 @ [0.000000,0.000000,0.000000]
collapseStack b --スタックを集約しようとします
OK
classof b --まだボックスです - 集約するものがありません
Box
addModifier b (meshSelect()) --MeshSelect モディファイヤを追加
OK
collapseStack b --スタックを再度集約しようとします
OK
classof b --今回は集約されました
Editable_mesh

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

   

snapshot <node> -- mapped

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

   

convertToMesh <node> -- mapped

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

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

   

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

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

   

コンストラクタ(TriMesh)

TriMesh() 

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

   

<node>.mesh 

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

   

<editable_mesh_baseobject>.mesh 

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

   

<trimesh>.mesh 

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

注: GeometryClass のブール値操作も編集可能メッシュ オブジェクトを作成します。

   

演算子

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

<mesh> + <mesh> -- 
<mesh> - <mesh> -- 
<mesh> * <mesh> --  交差

プロパティ

<mesh>.numverts Integer 

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

   

<mesh>.numfaces Integer 

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

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

注:
$.numfaces=300
--これは、次と同じです。
setNumFaces $ 300 false
--引数が false の場合、既存のトポロジはそのままの状態で維持されません。

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

   

<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 を構築できます。

   

注:以下のプロパティは、TriMeshes には適用されません
<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 

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

   

<mesh>.splitMesh Boolean 

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

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

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

$Sphere01.vertex_209 Point3 value:[7.9,-40.0,0.0] -- アニメート可能
$Sphere01.vertex_210 Point3 value:[-7.8,-39.3,-7.9] -- アニメート可能
$Sphere01.vertex_211 Point3 value:[0.0,-40.0,-7.9] -- アニメート可能

メソッド

次のメソッドは、オブジェクト スペース モディファイヤが存在しない場合に、ノードの基本オブジェクトに作用します。オブジェクト スペース モディファイヤが存在する場合は、オブジェクト スペース モディファイヤが適用された後に、取得操作 get がワールド状態のメッシュにアクセスします。メッシュの設定操作 set は、編集可能メッシュの基本オブジェクトにだけ作用し、オブジェクト スペース モディファイヤが存在する場合には、モディファイヤが存在するとメッシュを変更できないことをエラー メッセージで知らせます。オブジェクトは、 collapseStack() snapshot() 、および convertToMesh() メソッドを使用して、編集可能メッシュに変換できます。オブジェクト スペース モディファイヤが存在しない場合、取得操作 get および設定操作 set は、いずれも編集可能メッシュ基本オブジェクトに作用します。

メッシュの取得操作 get にはメッシュが必要であるため、基本オブジェクトとモディファイヤの組み合わせでモディファイヤ スタックの最上位にメッシュを生成する必要があります。たとえば、パッチ基本オブジェクトとベンドやツイストのようなデフォーマ モディファイヤとの組み合わせは、メッシュではなくパッチ オブジェクトをスタックの上に送るので、これらの組み合わせはここには含まれません。メッシュ編集モディファイヤを適用すると、常にワールド状態のオブジェクトが強制的にメッシュに変換されます。

ワールド スペース モディファイヤが存在する場合は、オブジェクト スペース モディファイヤが適用済みでワールド スペース モディファイヤが適用される前に、メッシュの取得操作 get がワールド状態のメッシュにアクセスします。ワールド スペース モディファイヤに影響される頂点の位置にはアクセスできません。メッシュの設定操作 set は、ワールド スペース モディファイヤがオブジェクトに適用される場合にだけ作用します。このような場合、頂点の位置を設定すると、その値はワールド スペース モディファイヤが適用される前の位置に設定されます。ワールド スペース モディファイヤの効果を反映させる snapshot() メソッドを使って、新しいメッシュ オブジェクトを作成できます。

update() メソッドは、メッシュ基本オブジェクトに対する記述上の変更を 3ds Max に認識させます。メッシュを修正した後には、3ds Max が有効なメッシュを認識できるようにするため、この関数を呼び出す必要があります。このメソッドは計算集中型操作であるため、これを個別の関数として使用して 1 つのメッシュに多数の変更を行い、その後で update を 1 回だけ呼び出してすべての変更を 3ds Max に送ることができます。

頂点と面のインデックスは、いずれも 1 から始まり 、MAXScript におけるインデックスに関するその他の規則に準拠します。使われる座標は、いずれも現在の作業座標系に対応しています。

   

一般的なメソッド

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

この 3 つのオプションのキーワード引数が、メッシュに対して行われる更新の種類をコントロールします。 geometry: 引数が true の場合は、ジオメトリ キャッシュ(法線およびエッジのリスト)が再構築され、メッシュのバウンディング ボックスが無効になります。 topology: 引数が true の場合は、エッジとストリップのデータベースが再構築されます。 normals: true の場合は、面の法線が計算されます。すべてのフラグの既定値は true なので、 update() を呼び出すだけで、すべてのキャッシュが完全に再構成されます。

   

attach <mesh> <node> 

これは、完全なオブジェクトをメッシュに追加してメッシュを構築する[編集可能メッシュ][修正]パネルのメッシュのアタッチ関数に相当します。この関数は <node> からメッシュを(必要に応じてメッシュに変換してから)抽出し、それを編集可能メッシュ オブジェクト <mesh> に追加してから <node> を削除します。 <node> のマテリアルとマテリアル ID は、編集可能メッシュの[修正]パネルでアタッチ操作の既定の設定を使って <node> に合成されます。このメソッドは TriMesh には適用されません。

   

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> 

ソース メッシュをターゲット メッシュにアタッチします。ターゲットまたはソースが、ノードではなくメッシュとして指定される場合、メッシュのローカル座標系を使用してメッシュがアタッチされ、マテリアル補正は実行されません。これを回避するため、ターゲットまたはソースがメッシュの場合は、対応する targetNode または sourceNode という名前が付いたパラメータを確認して、ノードが指定されているかどうかを確認します。ノードが指定されている場合は、そのノードの変換およびマテリアルを使用します。ソースまたはターゲットがノードとして指定されている場合、対応する targetNode または sourceNode という名前が付いたパラメータは確認されません。 attachMat および condenseMat オプションは、編集可能メッシュのアタッチ オプションに対応します。

condenseMat は、 attachMat:#IDToMat が指定されている場合にのみ適用できます。ソースがノードまたはメッシュとして指定されており、 sourceNode が指定されているときに、 deleteSourceNode:false を指定しない場合は、アタッチ後にソース ノードが削除されます。

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> } 

ユーザ インタフェース値を取得/設定します。オプションの <modifier_or_index> は、指定されたシーン オブジェクト上のメッシュを編集モディファイヤを識別して、パラメータ値を設定します。これらのメソッドは UI 依存型です。使用する場合は、指定された編集可能メッシュまたは Edit Mesh モディファイヤが[修正]パネルに現在表示されている必要があります。有効な param_name 値、それらの意味、およびパラメータ値タイプは、次のとおりです。

#SelByVert 選択 - 頂点別(ブール値)

#IgBack 選択 - 背面を無視(ブール値)

#IgnoreVis 選択 - 可視エッジを無視(ブール値)

#PolyThresh 選択 - 平面スレッショルド(数値)

#SoftSel ソフト選択 - ソフト選択を使用(ブール値)

#SSUseEDist ソフト選択 - エッジの距離(ブール値)

#SSEDist ソフト選択 - エッジの距離(数値) [注: 値が変更されていない場合は、0 の値が返されます]

#SSBack ソフト選択 - 背面を無視(ブール値) [注: これは UI 要素の逆です]

#Falloff ソフト選択 - フォールオフ(数値)

#Pinch ソフト選択 - ピンチ(数値)

#Bubble ソフト選択 - バブル(数値)

#WeldDist 連結 - 距離(数値)

#WeldBoxSize 連結 - ピクセル単位のボックス サイズ(数値)

#ExtrudeType 押し出し/面取り(ブール値) [注: true の場合グループ、false の場合ローカル]

#ShowVNormals 頂点法線を表示(ブール値)

#ShowFNormals 面法線を表示(ブール値)

#NormalSize 法線スケール(数値)

   

その他のメッシュ関連トピック:

頂点メソッド

頂点メソッド (meshop struct)

頂点データ メソッド (meshop struct)

エッジ メソッド:

エッジ メソッド (meshop struct)

面メソッド

面メソッド (meshop struct)

メッシュ メソッド (meshop struct)

マッピング メソッド - 一般 (meshop struct)

テクスチャ頂点メソッド

頂点ごとのカラー メソッド

サブディビジョン ディスプレイスメント サーフェス プロパティのメソッド

編集可能メッシュ UI プロパティ メソッド (meshop struct)

[編集可能メッシュ修正]パネル コマンド モードおよび操作 (meshOps struct)

関連事項