SWTOR: .gr2 3D model file - Revision history

imported>SWTOR fan at 23:57, 14 September 2014

2014-09-14T23:57:56Z

← Older revision	Revision as of 23:57, 14 September 2014
(No difference)

imported>SWTOR fan at 23:57, 14 September 2014

2014-09-14T23:57:56Z

← Older revision		Revision as of 23:57, 14 September 2014
Line 26:		Line 26:

	''position:'' 0x10		''position:'' 0x10
	*<tt>uint32 '''~~num50Offsets~~'''</tt>: The number of offsets in the <u>~~50 offset~~ section</u>		*<tt>uint32 '''numCachedOffsets'''</tt>: The number of offsets in the <u>Cached offsets section</u>
	*<tt>uint32</tt>: type of .gr2 file:		*<tt>uint32</tt>: type of .gr2 file:
	**<tt>00</tt> = default .gr2 file		**<tt>00</tt> = default .gr2 file
Line 41:		Line 41:

	''position:'' 0x50		''position:'' 0x50
	*<tt>uint32 '''~~offset50offset~~'''</tt>: Offset of the <u>~~50 offset~~ section</u>		*<tt>uint32 '''offsetCachedOffsets'''</tt>: Offset of the <u>Cached offsets section</u>
	*<tt>uint32 '''offsetMeshHeader'''</tt>: Offset of the <u>Mesh information</u> section, usually 0x70, or zero, if there are no meshes.		*<tt>uint32 '''offsetMeshHeader'''</tt>: Offset of the <u>Mesh information</u> section, usually 0x70, or zero, if there are no meshes.
	*<tt>uint32 '''offsetMaterialNameOffsets'''</tt>: Offset of the <u>Material offsets</u> section where the offsets of the material names are given, or zero if there are no materials.		*<tt>uint32 '''offsetMaterialNameOffsets'''</tt>: Offset of the <u>Material offsets</u> section where the offsets of the material names are given, or zero if there are no materials.
Line 193:		Line 193:
	*''(zero padding bytes to next 16-byte block)''		*''(zero padding bytes to next 16-byte block)''

	===~~50 offset~~ section===		===Cached offsets section===
	This section contains a list of offset addresses along with the value that is found at that address. Each of these values is in turn an offset again. The first offset is always <tt>50 00 00 00</tt>, which is the offset of this section.		This section contains a list of offset addresses along with the value that is found at that address. Each of these values is in turn an offset again. The first offset is always <tt>50 00 00 00</tt>, which is the offset of this section.

	This section may be important for reading the bones, but right now it appears to be redundant to me.		This section may be important for reading the bones, but right now it appears to be redundant to me.

	*''position:'' ~~offset50offset~~		*''position:'' offsetCachedOffsets
	*LOOP (for each tmpOffset in ~~num50Offsets~~) {		*LOOP (for each tmpOffset in numCachedOffsets) {
	**uint32 offsetAddress: An offset in the value		**uint32 offsetAddress: An offset in the value
	**uint32 offsetValue: The value that is stored at that offset, always another offset		**uint32 offsetValue: The value that is stored at that offset, always another offset

imported>SWTOR fan at 23:56, 14 September 2014

2014-09-14T23:56:22Z

← Older revision	Revision as of 23:56, 14 September 2014
(No difference)

imported>SWTOR fan at 23:56, 14 September 2014

2014-09-14T23:56:22Z

imported>SWTOR fan: /* BNRY / LTLE section */ acronym updated

2013-01-12T12:34:20Z

BNRY / LTLE section: acronym updated

← Older revision	Revision as of 12:34, 12 January 2013
(No difference)

imported>SWTOR fan: /* BNRY / LTLE section */ acronym updated

2013-01-12T12:34:20Z

BNRY / LTLE section: acronym updated

← Older revision		Revision as of 12:34, 12 January 2013
Line 210:		Line 210:
	This section is completely unknown to me. The specification will allow you to parse the BNRY section without errors, but there is not much to do with the data yet, so you can just as well skip this section.		This section is completely unknown to me. The specification will allow you to parse the BNRY section without errors, but there is not much to do with the data yet, so you can just as well skip this section.

	Regarding the BNRY / LTLE acronym, the only meaningful words I could come up with were ''~~bone array~~ / little'' but ~~this does~~ not ~~make much sense considering this section is connected to the collision mesh~~.		Regarding the BNRY / LTLE acronym, the only meaningful words I could come up with were ''binary / little'' but I am not sure about that.

	====BNRY header====		====BNRY header====

imported>SWTOR fan: faces information clarified

2012-12-21T17:58:17Z

faces information clarified

← Older revision	Revision as of 17:58, 21 December 2012
(No difference)

imported>SWTOR fan: faces information clarified

2012-12-21T17:58:17Z

faces information clarified

imported>SWTOR fan: /* Header */ error corrected

2012-12-21T16:33:17Z

Header: error corrected

← Older revision	Revision as of 16:33, 21 December 2012
(No difference)

imported>SWTOR fan: /* Header */ error corrected

2012-12-21T16:33:17Z

Header: error corrected

← Older revision		Revision as of 16:33, 21 December 2012
Line 45:		Line 45:
	*<tt>uint32 '''offsetMaterialNameOffsets'''</tt>: Offset of the <u>Material offsets</u> section where the offsets of the material names are given, or zero if there are no materials.		*<tt>uint32 '''offsetMaterialNameOffsets'''</tt>: Offset of the <u>Material offsets</u> section where the offsets of the material names are given, or zero if there are no materials.
	*<tt>uint32 '''offsetBoneStructure'''</tt>: Offset of the <u>Skeleton structure</u> section (usually 0x70), only when this file is a skeleton file, otherwise zero		*<tt>uint32 '''offsetBoneStructure'''</tt>: Offset of the <u>Skeleton structure</u> section (usually 0x70), only when this file is a skeleton file, otherwise zero
	*<tt>uint32 '''offsetAttachments''': Offset of the <u>Attached objects</u> section, or zero, if there are not attached objects.		*<tt>uint32 '''offsetAttachments'''</tt>: Offset of the <u>Attached objects</u> section, or zero, if there are not attached objects.
	*~~<tt>byte[]</tt>:~~ ''(zero padding bytes to next 16-byte block)''		*''(zero padding bytes to next 16-byte block)''

	===Skeleton structure===		===Skeleton structure===

← Older revision		Revision as of 23:56, 14 September 2014
Line 76:		Line 76:
	***32 = X/Y/Z coordinates, texture positions and bone connections of this vertex (e.g. for dynamic, animated models)		***32 = X/Y/Z coordinates, texture positions and bone connections of this vertex (e.g. for dynamic, animated models)
	**<tt>uint32 '''numVertices'''</tt>: The total number of vertices used by this mesh <small>(not required for reading model since this information is also given in <u>mesh piece information</u>)</small>		**<tt>uint32 '''numVertices'''</tt>: The total number of vertices used by this mesh <small>(not required for reading model since this information is also given in <u>mesh piece information</u>)</small>
	**<tt>uint32 '''~~numFaces~~'''</tt>: The total number of vertex indices used by this mesh. Divide this number by 3 to get number of faces <small>(not required for reading model since this information is also given in <u>mesh piece information</u>)</small>		**<tt>uint32 '''numIndices'''</tt>: The total number of vertex indices used by this mesh. Divide this number by 3 to get number of faces <small>(not required for reading model since this information is also given in <u>mesh piece information</u>)</small>
	**<tt>uint32 '''offsetMeshVertices'''</tt>: The start address (offset) of the <u>vertices</u> of this mesh <small>(required for reading vertices)</small>		**<tt>uint32 '''offsetMeshVertices'''</tt>: The start address (offset) of the <u>vertices</u> of this mesh <small>(required for reading vertices)</small>
	**<tt>uint32 '''offsetMeshPieces'''</tt>: The start address (offset) of the <u>Mesh piece information</u> of this mesh <small>(required for reading models with textures)</small>		**<tt>uint32 '''offsetMeshPieces'''</tt>: The start address (offset) of the <u>Mesh piece information</u> of this mesh <small>(required for reading models with textures)</small>
	**<tt>uint32 '''~~offsetFaces~~'''</tt>: The start address (offset) of the <u>~~faces~~</u> of this mesh <small>(required for reading face indices)</small>		**<tt>uint32 '''offsetIndices'''</tt>: The start address (offset) of the <u>indices</u> of this mesh <small>(required for reading face indices)</small>
	**<tt>uint32 '''offsetBones'''</tt>: The start address (offset) of the <u>bone list</u> of this mesh		**<tt>uint32 '''offsetBones'''</tt>: The start address (offset) of the <u>bone list</u> of this mesh
	*} END LOOP		*} END LOOP
Line 178:		Line 178:
	*''position:'' <tt>'''offsetBones'''</tt>		*''position:'' <tt>'''offsetBones'''</tt>
	*LOOP (FOR EACH <tt>'''bone'''</tt> IN <tt>'''numBones'''</tt>) {		*LOOP (FOR EACH <tt>'''bone'''</tt> IN <tt>'''numBones'''</tt>) {
	**<tt>uint32: offset of bone name as string, terminated by <tt>00</tt>		**<tt>uint32</tt>: offset of bone name as string, terminated by <tt>00</tt>
	**<tt>float32[6]</tt>: six unknown floats, maybe related to position/rotation of bone		**<tt>float32[6]</tt>: six unknown floats, maybe related to position/rotation of bone
	*} END LOOP		*} END LOOP

← Older revision		Revision as of 17:58, 21 December 2012
Line 75:		Line 75:
	***24 = X/Y/Z coordinates and texture positions of this vertex (e.g. for static models)		***24 = X/Y/Z coordinates and texture positions of this vertex (e.g. for static models)
	***32 = X/Y/Z coordinates, texture positions and bone connections of this vertex (e.g. for dynamic, animated models)		***32 = X/Y/Z coordinates, texture positions and bone connections of this vertex (e.g. for dynamic, animated models)
	**<tt>uint32 '''numVertices'''</tt>: The total number of vertices used by this mesh <small>(not required for reading model since this information is also given in <u>~~material usage~~ information</u>)</small>		**<tt>uint32 '''numVertices'''</tt>: The total number of vertices used by this mesh <small>(not required for reading model since this information is also given in <u>mesh piece information</u>)</small>
	**<tt>uint32 '''numFaces'''</tt>: The total number of ~~faces (= face~~ indices) used by this mesh <small>(not required for reading model since this information is also given in <u>~~material usage~~ information</u>)</small>		**<tt>uint32 '''numFaces'''</tt>: The total number of vertex indices used by this mesh. Divide this number by 3 to get number of faces <small>(not required for reading model since this information is also given in <u>mesh piece information</u>)</small>
	**<tt>uint32 '''offsetMeshVertices'''</tt>: The start address (offset) of the <u>vertices</u> of this mesh <small>(required for reading vertices)</small>		**<tt>uint32 '''offsetMeshVertices'''</tt>: The start address (offset) of the <u>vertices</u> of this mesh <small>(required for reading vertices)</small>
	**<tt>uint32 '''offsetMeshPieces'''</tt>: The start address (offset) of the <u>Mesh piece information</u> of this mesh <small>(required for reading models with textures)</small>		**<tt>uint32 '''offsetMeshPieces'''</tt>: The start address (offset) of the <u>Mesh piece information</u> of this mesh <small>(required for reading models with textures)</small>
	**<tt>uint32 '''offsetFaces'''</tt>: The start address (offset) of the <u>faces ~~(vertex indices)~~</u> of this mesh <small>(required for reading face indices)</small>		**<tt>uint32 '''offsetFaces'''</tt>: The start address (offset) of the <u>faces</u> of this mesh <small>(required for reading face indices)</small>
	**<tt>uint32 '''offsetBones'''</tt>: The start address (offset) of the <u>bone list</u> of this mesh		**<tt>uint32 '''offsetBones'''</tt>: The start address (offset) of the <u>bone list</u> of this mesh
	*} END LOOP		*} END LOOP
Line 91:		Line 91:
	*''position:'' <tt>'''mesh.offsetMeshPieces'''</tt>		*''position:'' <tt>'''mesh.offsetMeshPieces'''</tt>
	**LOOP (FOR EACH <tt>'''piece'''</tt> IN <tt>'''mesh.numPieces'''</tt>) {		**LOOP (FOR EACH <tt>'''piece'''</tt> IN <tt>'''mesh.numPieces'''</tt>) {
	***<tt>uint32</tt>: The starting index where the faces for this piece start, values range from 0 to <tt>'''mesh.numFaces''' - 1</tt>		***<tt>uint32</tt>: The starting index where the faces for this piece start, values range from 0 to <tt>'''mesh.numFaces'''/3 - 1</tt>
	***<tt>uint32</tt>: The number of faces that this piece is made up of		***<tt>uint32</tt>: The number of faces that this piece is made up of
	***<tt>int32</tt>: If this piece is textured, this field specifies the id <small>(related to the <u>Material offsets</u> section)</small> for this material, otherwise -1		***<tt>int32</tt>: If this piece is textured, this field specifies the id <small>(related to the <u>Material offsets</u> section)</small> for this material, otherwise -1
Line 158:		Line 158:
	===Faces===		===Faces===
	This section contains the faces, that is the number of surfaces of the model. Three vertices (= three point) generate one face, so for each face you will have to read three integers to get the index for each point.		This section contains the faces, that is the number of surfaces of the model. Three vertices (= three point) generate one face, so for each face you will have to read three integers to get the index for each point.

			Note that <tt>'''mesh.numFaces'''</tt> given under <u>Mesh information</u> stands for the number of indices, so you'll have to divide it by 3 if you want to get the number of faces. In the <u>Mesh piece information</u> section howver, <tt>'''mesh.piece.numFaces'''</tt> stands for the number of the faces. To get the number of indices, multiply it by three.

	Please note that the vertex indices are zero-based (that is, the first vertex is numbered 0 and not 1). Some programs (for example Wavefront .obj files) start counting the index at 1, so you'll have to increase the indices by one if you are using such a program.		Please note that the vertex indices are zero-based (that is, the first vertex is numbered 0 and not 1). Some programs (for example Wavefront .obj files) start counting the index at 1, so you'll have to increase the indices by one if you are using such a program.
Line 163:		Line 165:
	*LOOP (FOR EACH <tt>'''mesh'''</tt> IN <tt>'''numMeshes'''</tt>) {		*LOOP (FOR EACH <tt>'''mesh'''</tt> IN <tt>'''numMeshes'''</tt>) {
	*''position:'' <tt>'''mesh.offsetFaces'''</tt>		*''position:'' <tt>'''mesh.offsetFaces'''</tt>
	**LOOP (FOR EACH <tt>'''face'''</tt> in <tt>'''mesh.numFaces'''</tt>) {		**LOOP (FOR EACH <tt>'''face'''</tt> in <tt>'''mesh.numFaces'''/3</tt>) {
	***<tt>uint16</tt>: index of first vertex		***<tt>uint16</tt>: index of first vertex
	***<tt>uint16</tt>: index of second vertex		***<tt>uint16</tt>: index of second vertex