ポリゴン(多角形) データはメッシュタイプ(TA_OBJECT_MESH)か、ジョイントタイプ(TA_OBJECT_JOINT)のオブジェクトのみで利用できます。ジョイントタイプの場合、ポリゴンはスキニング時のボーンの影響範囲として機能します。オブジェクトは以下のように頂点のリスト、面のリストを持っています。面が頂点を参照することで、ポリゴンを構成します。

オブジェクト(CTaObject)
- 頂点
- 頂点
- 〜
- 面
- 面
- 〜

頂点

頂点は三次元空間上のポイントを定義します。頂点ごとに三次元座標値を持ち、スキニング用のボーンインデックスとウェイトを4個(TA_MAX_VERTEX_BONE_COUNT)ずつ持つことができます。

頂点
- 三次元座標値(x, y, z)
  ―スキニング用―
- ボーンインデックス1
- ボーンインデックス2
- ボーンインデックス3
- ボーンインデックス4
- ボーンウェイト1
- ボーンウェイト2
- ボーンウェイト3
- ボーンウェイト4

三次元座標値はベクトル値(TA_VECTOR)で扱い、 CTaObject::GetVertexPositions() で取得、 CTaObject::SetVertexPositions() でセットします。

ボーンインデックスはバイト値(0〜255)で扱い、ボーンウェイトはfloat値で扱います。 CTaObject::GetVertexBones() で取得、 CTaObject::GetVertexBones() でセットします。 4個のボーンウェイトの合計は1である必要があります。オブジェクトのスキニングが無効な場合でも、頂点のボーンデータは保持されます。

面

面は頂点を参照することでポリゴン(多角形)を定義します。面ごとにマテリアル(CTaMaterial)の参照を持ち、ポリゴンの頂点ごとに、頂点の参照、フラットシェーディングフラグ、法線ベクトル、頂点カラーを持ち、テクスチャ用のUV座標値を持つことができます。 TOYSTUDIOではポリゴンとして三角形か四角形を使用しますが、より頂点数の多いポリゴンについての制限はありません。

面
- マテリアル(CTaMaterial)の参照
- 頂点の参照
- フラットシェーディングフラグ
- 法線ベクトル
- 頂点カラー
  ―テクスチャ用―
- UV座標値
- 頂点の参照
- フラットシェーディングフラグ
- 法線ベクトル
- 頂点カラー
  ―テクスチャ用―
- UV座標値
- 頂点の参照
- 〜

マテリアルの参照は、 CTaMaterial のポインタで扱います。 CTaObject::GetFaceMaterials() で取得、 CTaObject::SetFaceMaterials() でセットします。ポインタがNULLの場合は表示にデフォルトマテリアルが利用されます。

頂点の参照は、 CTaObject::GetFaceVertexIndices() で頂点のインデックスを取得します。

フラットシェーディングフラグはBOOL値で扱い、 TRUEの場合フラットシェーディング、 FALSEの場合スムーズシェーディングとなります。 CTaObject::GetFaceVertexFlatShades() で取得、 CTaObject::SetFaceVertexFlatShades() でセットします。

法線ベクトルは、 CTaObject::GetFaceVertexNormals() でベクトル値(TA_VECTOR)を取得します。

頂点カラーは TA_COLOR 値で扱い、 CTaObject::GetFaceVertexColors() で取得、 CTaObject::SetFaceVertexColors() でセットします。

UV座標値は2Dベクトル値(TA_VECTOR_2D)で扱い、 CTaObject::GetFaceVertexUVs() で取得、 CTaObject::SetFaceVertexUVs() でセットします。

ポリゴンの追加

ポリゴンの追加は、以下の順番で行います。

頂点の追加
面の追加
ポリゴンの接続関係の更新
法線ベクトルの更新
後処理

1.では、 CTaObject::AddVertex() や CTaObject::AddVertices() で頂点を追加します。頂点の追加後には、 CTaObject::SetVertexBones() で頂点のボーンインデックス、ボーンウェイトをセットできます。

2.では、 CTaObject::AddFace()や CTaObject::AddFaces()で面を追加します。面の追加後には、 CTaObject::SetFaceMaterials() でマテリアルの参照をセット、 CTaObject::SetFaceVertexFlatShades() でフラットシェーディングフラグのセット、 CTaObject::SetFaceVertexColors() で頂点カラーのセット、 CTaObject::SetFaceVertexUVs() でUV座標値のセットを行えます。

3.では、 CTaObject::UpdateMeshTopology() でポリゴンの接続関係を更新します。ポリゴンの不正な面や頂点を取り除きたい場合、この処理の前に CTaObject::CleanUpMesh() を実行します。

4.では、 CTaObject::UpdateMeshNormals() でポリゴンの法線ベクトルを更新します。これにより、 CTaObject::GetFaceNormals() で取得されるポリゴンの面の法線ベクトルや、 CTaObject::GetFaceVertexNormals() で取得されるポリゴンの頂点の法線ベクトルが更新されます。

5.では、 CTaObject::UpdateBoundBox() でオブジェクトのバウンドボックスを更新します。バウンドボックスはオブジェクトの選択時などにオブジェクトの周り表示される枠です。最後に、 CTaObject::UpdateGraphics() でオブジェクトのグラフィックスを更新します。