Magic Number: PGEOMETRY
Point/Prim Counts: NPoints # NPrims #
Group Counts: NPointGroups # NPrimGroups #
Attribute Counts: NPointAttrib # NVertexAttrib # NPrimAttrib # NAttrib #     

これらのケースでは、#は記述するエレメントの番号を意味します。グループには名前を付けて、ポイントまたはプリミティブを含めて定義します。ポイントやプリミティブは、いくつものグループのメンバーになることができます。したがって、メンバーシップは1グループにのみ属するわけではありません。

GPDのアトリビュートは一般化されています。アトリビュートはポイント単位、頂点単位、プリミティブ単位、ディテール単位で割り当てることができます。そのため、アトリビュートの数はファイルの上部で宣言します。後で、それらのアトリビュートを完全に定義します。

内部的に各エレメントに関連したアトリビュートは“辞書”で定義しています。これらの辞書ではアトリビュートの名前、タイプ、サイズを定義します。またアトリビュートのデフォルト値も辞書に記録しています。

辞書を保存したとき、各アトリビュート(特定の順番で)が定義されます。定義は基本的には以下の通りです:

Name Size Type Default

例えば、法線のアトリビュート名は“N”です。つまりアトリビュート定義は次のようになります:

N 3 float 0 0 0

アトリビュート名に“N”を指定するとエレメントは3つ、タイプはFloatになります。デフォルト値は(0, 0, 0)です。

エレメント定義の後には、エレメントに関係するアトリビュートデータを定義します。アトリビュートデータを記述するには括弧を付けます。アトリビュートデータは定義したエレメントの辞書の順番で表示します。

例えば、辞書は次のようになります:

PointAttrib
Cd 3 float 0 0 0 # Color attrib., 3 floats, default 0 0 0
Alpha 1 float 1 # Alpha attribute, 1 float, default 1
N 3 float 0 0 0 # Normal attribute
uv 2 float 0 0 # Texture coordinate     

ポイントのデータは次のようになります:

0 0 0 1 (1 0 0 1 0 0 1 .5 .5)
^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^ Position Attributes 

ポイントは次の情報を持ちます:

Cd = (1, 0, 0)
Alpha = 1
N = (0 0 1)
uv = (.5, .5) 

アトリビュートデータのタイプは、integer、float、string、indexをサポートしています。“string”タイプは、32文字として記録されます。というのは、各アトリビュートは固定長でなければならないからです。integerとfloatタイプはそのままの意味です。indexアトリビュートタイプは、マテリアルのようなものを指定するのに使います。このタイプには文字列のリストが含まれていて、そのリストの項目を整数値でインデックス化しています。従って、indexアトリビュートはintegerとして記録されています。indexアトリビュートの定義では、アトリビュート値も定義します。

mat 1 index 3 marble gold crystal_glass3    

indexアトリビュートすべてのデフォルト値は、-1で、これはアトリビュートが割り当てられていないことを意味します。

Pointアトリビュートがあれば、アトリビュート辞書はポイント定義の前に保存します。

Dictionary Name: PointAttrib
Dictionary Data: -- Attribute Definition --     

アトリビュート辞書の後には、ポイントのポイントデータを定義します。各ポイントは4つのコンポーネント(x,y,z,w)で記録します。ポジションは実際の同次座標ではありません。同次座標を得るには、単純に各x,y,zにwを乗算するだけです。

アトリビュートデータはポイントポジションの後に定義します。アトリビュートデータは括弧“()”で閉じます。

Vertexアトリビュートがあれば、頂点の辞書がここで見つかります。

Vertexアトリビュートの辞書の後に、Primitiveアトリビュートの辞書(プリミティブのアトリビュートがあれば)を定義します。

すべてのプリミティブにはローカル情報があり、それを保存する必要があるため、すべてのプリミティブのフォーマットが異なります。一般的には書式は次の通り:

PrimKey <local_information> [attributes]    

ここではlocal_informationが特定のプリミティブです。

ローカル情報の一部として、頂点を複数指定します。各頂点は同じ書式で保存します。書式は次の通り:

point_number attribute_data    

ポイント番号は0から number of points - 1まであります。Vertexアトリビュートデータがあれば、データは括弧()で閉じます。Primitiveアトリビュートデータがあれば、大括弧[]で閉じます。

各プリミティブには固有のIDがあります。現在のプリミティブとIDは次の通り:

Polygon: "Poly"
NURBS Curve: "NURBCurve"
Rational Bezier Curve: "BezierCurve"
Linear Patch: "Mesh"
NURBS Surface: "NURBMesh"
Rational Bezier Patch: "BezierMesh"
Ellipse/Circle: "Circle"
Ellipsoid/Sphere: "Sphere"
Tube/Cone: "Tube" Metaball "MetaBall"
Meta Super-Quadric: "MetaSQuad"
Particle System:  "Part"
Paste Hierarchy: "PasteSurf"     

プリミティブキーは大文字小文字の区別があります。例:

VertexAttrib
uv 3 float 0 0 0
PrimitiveAttrib
Cd 3 float 0 0 0
Poly 3 < 0 (1 0.5 0) 1 (0 0 0) 2 (0 1 0) [1 1 0 .5]     

これは閉じたポリゴン(以下参照)を指定しています。これには3つの頂点参照ポイント0,1,2があります。各頂点には3Dテクスチャ座標があり、()で指定します。ポリゴンにはカラーとアルファを[]で指定します。ここではカラーは黄色でアルファを50%にしています。

同じタイプのプリミティブが2つ以上連続した時は、これはプリミティブのrunとして指定します。このケースでは、次のコードをファイルで定義します:

Run # PrimKey    

#はrunのプリミティブの番号です。このケースでは、次のプリミティブがPrimKeyのIDで保存されません。その理由は、runで暗黙になっているからです。

#Vtx OpenClose Vertex_List    

意味:

#Vtx OpenClose Basis Vertex_List    

NURBSとBezierプリミティブはどちらも基底定義から始めます:

Keyword Order    

意味:

Keyword Order EndCondition Knots        

#K = #Vtx + Order - 2        

Keyword Order Knots        

#Cols #Rows UWrap VWrap connectivity    

意味:

ほとんどのケースで接続性は無視されますが、スイープやポリゴンへの変換のようなオペレーションでは致命的です。

Tri(Triangulated)とAtri(Alternate)メッシュは以下の違いがあります:

#Cols #Rows UWrap VWrap connectivity UBasis VBasis    

#Cols, #Rows, UWrap, VWrap, connectivity, Vertex_Listはメッシュで同じです。

UBasis / VBasisはNURBS / Bezierカーブと同じです。

Profilesはプロファイルカーブ(サーフェス上のカーブ)のオプションのリストです。プロファイルセクションの構造は、メインジオメトリの構造と非常に似ていて、ヘッダセクション、ポイント、プリミティブ、ポイントとプリミティブのグループを含みます。違いは、このセクションがアトリビュートを持たないことと、4つのプリミティブタイプ(ポリゴン, NURBSカーブ, Bezierカーブ, Trimシーケンス)しかもたないということです。

プロファイルのヘッダは、“Profiles:”です。プロファイルがなければ、“none”の後に定義していきます。プロファイルがあれば、プロファイルセクションには次の構造があります:

ProfileKey <local_information>        

point_number        

Polygon: "Poly"
NURBS Curve: "NURBCurve"
Rational Bezier Curve: "BezierCurve"         

Poly 3 < 0 1 2        

Run # ProfileKey        

TrimRegion [natural] #Profiles <profile_number ustart uend>...        

TrimRegion 2 0 1 0 5 -3.5 8        

GroupName Type NElements BitMask ElementList        

Vertex_Info Matrix33    

常に円に対して頂点は1つのみです。3 x 3行列には、円の中心に関するスケール、回転、移動を含んでいます。傾斜した円も可能です。

Vertex_Info Matrix33    

常に球に対して頂点は1つのみです。3 x 3行列には、球の中心に関するスケール、回転、移動を含んでいます。傾斜した球も可能です。

Vertex_Info Taper Closure Matrix33    

常にチューブ/円錐に対して頂点は1つのみです。頂点はチューブの中心にあります。(上面と底面の円/楕円の中心をつなぐ軸に沿って)。テーパーの値は上面の円の半径に影響を与えます。標準のチューブはテーパーの値が1です。円錐のテーパーなら0です。Closureの“closed”または“open”はチューブの両端に蓋を閉めるか否かを意味します。3 x 3行列には、チューブの中心に関するスケール、回転、移動を含んでいます。傾斜したチューブも可能です。

Vertex_Info Kernel_Function Weight Matrix33    

常にメタボールに対して頂点は1つのみです。カーネルファンクションは次の1つです:wyvill, quartic, blinn, links。3 x 3行列には、メタボールの中心に関するスケール、回転、移動を含んでいます。傾斜したメタボールも可能です。

Vertex_Info XY_Exponent Z_Exponent Kernel_FunctionWeight Matrix33    

常にmeta super-quadricに対して頂点は1つのみです。カーネルファンクションは次の1つです:wyvill, quartic, blinn, links。3 x 3行列には、メタボールの中心に関するスケール、回転、移動を含んでいます。傾斜したメタボールも可能です。

Part_Count Vertex_List    

Part_Countはシステム内のパーティクルの数です。

Detail Attribute Dictionaryが、プリミティブの後とグループ情報の前に保存します。

最初にポイントグループを保存して、その後にプリミティブグループを保存します。グループを意味するIDはありません。グループの書式は、 “ordered”または“unordered”かで変わります:

GroupName Type NElements BitMask ElementList    

これはメタボールのエクスプレッションとサーフェス階層のような情報の保存向けです。現在では、このセクションは、区切りトークンのみ1行に1つだけ含みます:

beginExtra endExtra     

今のところ、Extraボディは空っぽです。なぜなら、すべてのメタボールは結合され(暗黙的に“add”-ed)、サーフェス階層をサポートしていないからです。