Info about 3d mesh script

[Richter Belmont]

This game only support tri...
HELL NO!

First of all let understand the different parameter of a SPolygonGeometry.

.VertexArray
It contain all the vertices coordinate of your mesh.

.NormalArray
It contain the normal value of each normal.
Thing like the TK17 plugin tend to create one normal per face... BUT THIS IS A TOTALLY WRONG THING, since it will prevent use of light, bump and other kind of special texture map.
To get thing right, your mesh should contain as much normal as vertices. (normal per vertex)

.VertexData
It can contain all the Uvmap of your mesh (VertexDataVector2f) which will contain the coordinate of all your vertices on the Uvmap.
It can also contain all the vertex group of your mesh (VertexDataF32) which will contain the weight value of all your vertices on the vertex group.
In vertex group, vertices from the mesh not being connected to the group must still be include in it using a value of 0

.PrimCount
The number of *face of your mesh
You will under why the * later.

.IndexArray
The connection order of each *face.
for exemple [0, 1, 2] mean that the vertice 0, 1 and two are connected together to form a tri.

.PrimLengthArray
The number of vertices for each *face
Yep, I said EACH.
For exemple, if you have a .PrimCount I32(9), your .PrimLengthArray should contain 9 int.
"All the file I seen only use one int, and its work" will you say?
The answer to this is simple: the game ignore this parameter because of the next parameter I will show you.

.PrimType Primitive.TypeEnum
This parameter tell the game what kind of *face your mesh is using.
Maybe you're not aware, but when you don't use a parameter, the game will use the default value for the given parameter.
Guest what is the default value of .PrimType Primitive.TypeEnum?
Triangle...this is why the game seem to only support tri!

So here we go with all the different value .PrimType Primitive.TypeEnum can take.
Note that you can only use one value.

.Point
The mesh is only made of vertices (no face and edge)
The .PrimLengthArray is ignored, because the game know that each *face(by face I mean vertice...) only use one vertice.

.Line , .LineStrip and .LineLoop
The mesh is only made of edge
The .PrimLengthArray is ignored, because the game know that each *face(by face I mean edge...) only use two vertices.

.Triangle , .TriangleStrip , .TriangleFan and .TriangleStripAndTriangles
The mesh is only made of tri
The .PrimLengthArray is ignored, because the game know that each tri use 3 vertices.

.Quad and .QuadStrip
The mesh is only made of quad
The .PrimLengthArray is ignored, because the game know that each quad use 4 vertices.

Polygon
The mesh is made of mixed kind of *face and/or from Ngon (face using more than 4 vertices)
The .PrimLengthArray...CANNOT BE IGNORED!
This is logic!
How the game is supposed to know how many vertices each *face use?
For exemple, let say my frist face was a 5 vertices face, the second a tri, the fourth a tri, then a edge somewhere.
How the game will know how many vertices each *face use if you don't tell him?

So here the code of a cube(quads) with a pyramid on it(tris).

Code:

SPolygonGeometry :local_11 . {[/color]
[color=#000000]SPolygonGeometry.PrimCount I32(9);[/color]
[color=#000000]SPolygonGeometry.PrimType Primitive.TypeEnum.Polygon;[/color]
[color=#000000]SPolygonGeometry.PrimLengthArray Array_I32 [ 4, 4, 4, 4, 4, 3, 3, 3, 3];[/color]
[color=#000000]SPolygonGeometry.IndexArray Array_I32 [ 1, 3, 2, 0, 3, 7, 6, 2, 7, 5, 4, 6, 5, 1, 0, 4, 5, 7, 3, 1, 4, 0, 8, 6, 4, 8, 2, 6, 8, 0, 2, 8];[/color]
[color=#000000]SPolygonGeometry.VertexArray Array_Vector3f [(-1.000000, -1.000000, -1.000000), (-1.000000, -1.000000, 1.000000), (-1.000000, 1.000000, -1.000000), (-1.000000, 1.000000, 1.000000), ( 1.000000, -1.000000, -1.000000), ( 1.000000, -1.000000, 1.000000), ( 1.000000, 1.000000, -1.000000), ( 1.000000, 1.000000, 1.000000), ( 0.000000, 0.000000, -2.108580)];[/color]
[color=#000000]SPolygonGeometry.NormalArray Array_Vector3f [(-1.000000, 0.000000, 0.000000), ( 0.000000, 1.000000, -0.000000), ( 1.000000, 0.000000, -0.000000), ( 0.000000, -1.000000, 0.000000), (-0.000000, 0.000000, 1.000000), ( 0.000000, -0.742535, -0.669807), ( 0.742535, 0.000000, -0.669807), ( 0.000000, 0.742535, -0.669807), (-0.742535, -0.000000, -0.669807)];[/color]
[color=#000000]Object.Name "Stool_R9Toy135_Object01_meshShape";[/color]
[color=#000000]};

The mesh is made of 9 faces, so there is 9 int in .PrimLengthArray
The .PrimLengthArray and .IndexArray are linked together.
The .IndexArray should contain a number of int equal to the adding of all the number in .PrimLengthArray
SPolygonGeometry.PrimLengthArray Array_I32 [ 4, 4, 4, 4, 4, 3, 3, 3, 3];
SPolygonGeometry.IndexArray Array_I32 [ [ 1, 3, 2, 0, 3, 7, 6, 2, 7, 5, 4, 6, 5, 1, 0, 4, 5, 7, 3, 1, 4, 0, 8, 6, 4, 8, 2, 6, 8, 0, 2, 8];
 
Bonus mesh: Ngon using 6 vertices (only one face)

Code:

SPolygonGeometry :local_11 . {[/color]
[color=#000000]SPolygonGeometry.PrimCount I32(1);[/color]
[color=#000000]SPolygonGeometry.PrimType Primitive.TypeEnum.Polygon;[/color]
[color=#000000]SPolygonGeometry.PrimLengthArray Array_I32 [ 6];[/color]
[color=#000000]SPolygonGeometry.IndexArray Array_I32 [4, 3, 2, 5, 0, 1];[/color]
[color=#000000]SPolygonGeometry.VertexArray Array_Vector3f [ (-1.891032, -0.451672, 0.000000), (0.906535, -1.286626, -0.000000), (-2.127810, 1.155775, 0.000000), (1.654255, 1.778874, 0.000000), (0.605942, -0.303632, -0.000000), (-1.000000, 0.069107, 0.000000)];[/color]
[color=#000000]SPolygonGeometry.NormalArray Array_Vector3f [(0, 0, 1)];[/color]
[color=#000000]Object.Name "Stool_R9Toy135_Object01_meshShape";[/color]
[color=#000000]};

While testing, I took my value from a .x (directX) file exported using the blender directX plugin.
Look like the plugin create a SPolygonGeometry.IndexArray that only work for mesh made at 100% tri.
However, the plugin do not create a working .PrimLengthArray required by complex mesh (multiple *face type mesh).
As for the TK17 plugin Import, it will only correctly import mesh made of tri. (eg if trying to import 100% quad mesh, the half of all your quad will be missing)