MFnMeshクラスのsplit関数

誰にも頼まれてないけど仕様を日本語に訳しておくよ。

MFnMeshクラスのsplit関数

MStatus MFnMesh::split( MIntArray & placements,
MIntArray & edgeList,
MFloatArray & edgeFactors,
MFloatPointArray & internalPoints
)


スポンサーリンク

この関数は、エッジとフェースを連続的に分割します。placements配列の要素は、列挙型SplitPlacementでなければなりません。placements配列中でSplitPlacement::kOnEdgeと設定された要素は、対応するエッジIDとファクターがedgeList配列とedgeFactors配列にもそれぞれ含まれている必要があります。SplitPlacement::kInternalPointと設定された要素についても同様に、internalPoints配列にも含まれている必要があります。それぞれの要素は、3つの配列全て同じ順序で指定する必要がありますから、placements配列の最初にあるSplitPlacement::kOnEdgeと設定されている要素は、edgeList配列とedgeFactors配列の最初の要素と対応させます。

もしも頂点の内1つでも作成出来ない場合、アルゴリズム全体が失敗します。同じエッジを2回以上分割することはできません。分割の開始・終了もエッジ上である必要があります。これはつまり、placements配列の最初と最後の要素は必ずSplitPlacement::kOnEdgeに設定されていなければならないということです。placements配列がエッジ上で開始・終了しない場合、コードは「成功」ステータスを返しますがメッシュは分割されません。。

NOTE:このメソッドで使用されるアルゴリズムはpolySplitコマンドと同じで、同様の制限があります。

引数:

  • [in] placements

列挙型SplitPlacementが設定された要素を格納する配列。これは、分割で新しい頂点を配置する場所(エッジ上かフェース上か)を表しています。

  • [in] edgeList

分割するエッジのIDを分割順に格納する配列。この配列には、placements配列のSplitPlacement::kOnEdgeに設定されている要素と同じ数だけの要素が必要です。

  • [in] edgeFactors

エッジ上の分割位置を表す内分比ファクター(範囲0~1)、を格納する配列。この配列の持つ要素の数は、edgeList配列が持つ要素の数と同じである必要があります。


スポンサーリンク
  • [in] internalPoints

既存のフェース上に新しく追加する頂点の位置座標を格納する配列。この配列には、placements配列のSplitPlacement::kInternalPointに設定されている要素と同じ数だけの要素が必要です。この配列は空でもかまいません。追加する頂点は、前のエッジIDと次のエッジIDの間にあるフェース上で指定する必要があります。

返り値:

Status Code

Status Codes:

  • MS::kSuccess

The method was successful.

  • MS::kInvalidParameter

One of the following parameter errors

  • MS::kIndexOutOfRange

One or more of the edge IDs are not on the mesh.

  • MS::kValueOutOfRange

One or more of the edge factors are not within the [0,1] range

  • MS::kInvalidParameter

The split algorithm could not be completed successfully or the array sizes are not appropriate.

  • MS::kNotFound

The given placements list is empty.

  • MS::kFailure

An object error has occurred.

  • MS::kObjectDoesNotExist

The base stucture was not initialized properly

  • MS::kShapeHasNoGeometry

The mesh shape has no geometry to work on

Examples:

meshOpFtyAction.cpp.

そんで分割方法のフラグとなる列挙型。(intにキャストしてMIntArrayに入れる)

SplitPlacement

<span class="synType">enum</span> MFnMesh::SplitPlacement

分割点の決定方法を指定するフラグ。

Enumerator:

  • kOnEdge

エッジに沿って新しい頂点を配置し、エッジを 2 つの新しいエッジに分割する。

  • kInternalPoint

フェース内の特定座標に新しい頂点を挿入する。

  • kInvalid

無効

今まで知らなかったんだけど、C++の列挙型ってintと相互にキャストできるのね。(内部では整数が回るらしい)

コーディングミスを防ぐ目的でenumを使うって感じみたい。


スポンサーリンク

関連記事

物理ベースレンダリングのためのマテリアル設定チートシート
OpenCVで動画の手振れ補正
Unity ARKitプラグインサンプルのドキュメントを読む
OpenCVでiPhone6sのカメラをキャリブレーションする
Texturing & Modeling A Procedural ApproachをGoo...
Mayaでリアルな布の質感を作るチュートリアル
Windows Server 2008にAutodesk Maya 2009をインストール
『スター・ウォーズ フォースの覚醒』のVFXブレイクダウン まとめ
オープンソースのネットワーク可視化ソフトウェアプラットフォーム『Cytoscape』
OpenCV 3.1から追加されたSfMモジュール
R-CNN (Regions with CNN features):ディープラーニングによる一般物体...
OpenCVの三角測量関数『cv::triangulatepoints』
3DCG Meetup #4に行ってきた
ラクガキの立体化 背中の作り込み・手首の移植
OpenCVのバージョン3が正式リリースされたぞ
OpenMayaRender
サンプルコードにも間違いはある?
日本でMakersは普及するだろうか?
Open Shading Language (OSL)
機械学習手法『Random Forest』
OpenCV 3.1のsfmモジュールのビルド再び
3Dボリュームデータ処理ライブラリ『OpenVDB』
OpenCV バージョン4がリリースされた!
人体モデリングできるBlenderアドオン『ManuelBastioniLAB』
Boost オープンソースライブラリ
ジュラシック・パークの続編『ジュラシック・ワールド』
世界一下品なクマと世界一紳士なクマ
ZBrush4新機能ハイライト 3DCG CAMP 2010
オープンソースの汎用レンダラ『Mitsuba 2』
スクラッチで既存のキャラクターを立体化したい
ZBrush 2018へのアップグレード
ゴジラ三昧
注文してた本が届いた
2012のメイキングまとめ(途中)
服飾デザインツール『CLO』
『ピクサー展』へ行ってきた
CGレンダラ研究開発のためのフレームワーク『Lightmetrica (ライトメトリカ)』
UnityのGameObjectの向きをScriptで制御する
機械学習手法『SVM(Support Vector Machine)』
openMVGをWindows10 Visual Studio 2015環境でビルドする
Transformers ”Reference & Bulid” Siggraph 2007
書籍『OpenCV 3 プログラミングブック』を購入

コメント