Mesh/Mesh Asset Format - Revision history

Nalates Urriah: Fix image

2017-06-28T17:57:47Z

Fix image

← Older revision		Revision as of 10:57, 28 June 2017
Line 1:		Line 1:
	{{Navbox/Mesh\|tech}}		{{Navbox/Mesh\|tech}}
	[[File:Drongle-Mesh-Format.jpg~~\|thumb\|250px~~\|left\|Click to Enlarge]]		[[File:Drongle-Mesh-Format.jpg\|left\|Click to Enlarge]]
	== Overview ==		== Overview ==
	This document is a specification of the mesh asset format used by Second Life. At its highest level, a mesh asset is a collection of data blocks spread across a file. The sizes, locations, and types of the data elements are described in the header at the beginning of the file. This document will describe the format of the header and each of the data block types it may reference.		This document is a specification of the mesh asset format used by Second Life. At its highest level, a mesh asset is a collection of data blocks spread across a file. The sizes, locations, and types of the data elements are described in the header at the beginning of the file. This document will describe the format of the header and each of the data block types it may reference.

Alina Lyvette: Corrected key names in skin block description to match llmodel.cpp

2013-01-25T12:14:33Z

Corrected key names in skin block description to match llmodel.cpp

← Older revision		Revision as of 05:14, 25 January 2013
Line 66:		Line 66:
	''mHipLeft, mKneeLeft, mFootLeft'' where a full avatar replacement will contain and reference all of these joints.		''mHipLeft, mKneeLeft, mFootLeft'' where a full avatar replacement will contain and reference all of these joints.

	* "~~JointNames~~" -- joint name list for this skin. Will contain joint names from the above list.		The skin block is a gzip'd binary encoded LLSD map with the following entries:
	* "~~BindShapeMatrix~~" -- matrix that transforms from model space to world space. One per skin.
	* "~~InvBindMatrix~~" -- matrix that transforms from skin local space(world space) to joint local space. One per joint having influences.		* "joint_names" -- joint name list for this skin. Will contain joint names from the above list.
	* "~~AlternateBindMatrix~~" -- optional, if joint offsets are used then the alternate bind matrix will contain translational information that will override the default Second Life skeleton. Rotational and scaling components are at this moment, unused.		* "bind_shape_matrix" -- matrix that transforms from model space to world space. One per skin.
	* "~~PelvisOffset~~" -- optional, used to provide a pelvis fixup for avatar rigs that alter the default Second Life skeleton.		* "inverse_bind_matrix" -- matrix that transforms from skin local space(world space) to joint local space. One per joint having influences.
			* "alt_inverse_bind_matrix" -- optional, if joint offsets are used then the alternate bind matrix will contain translational information that will override the default Second Life skeleton. Rotational and scaling components are at this moment, unused.
			* "pelvis_offset" -- optional, used to provide a pelvis fixup for avatar rigs that alter the default Second Life skeleton.

	== Physics Mesh Block ==		== Physics Mesh Block ==

Alina Lyvette: corrected joint weight encoding to match what is actually in lvolume.cpp

2013-01-25T12:10:07Z

corrected joint weight encoding to match what is actually in lvolume.cpp

← Older revision		Revision as of 05:10, 25 January 2013
Line 45:		Line 45:

	=== Vertex Weight Encoding ===		=== Vertex Weight Encoding ===
	Each weight entry corresponds to a position in the Position array. Each entry may contain up to 4 influences. Each influence is defined as a 16-bit unsigned joint index followed by a 16-bit unsigned weight value. A joint index of “0xFF” indicates there are no more influences for this entry. Other than 0xFF, no joint index may have a value >31. If 4 influences have been read for the current entry, it is assumed there are no more influences for this entry.		Each weight entry corresponds to a position in the Position array. Each entry may contain up to 4 influences. Each influence is defined as a 8-bit unsigned joint index followed by a 16-bit unsigned weight value (least significant byte first). A joint index of “0xFF” indicates there are no more influences for this entry. Other than 0xFF, no joint index may have a value >31. If 4 influences have been read for the current entry, it is assumed there are no more influences for this entry.
	<br>		<br>
	<br>		<br>
Line 51:		Line 51:
	For example, an entry denoting weights to joints 2 and 3 would contain the values: <br><br>		For example, an entry denoting weights to joints 2 and 3 would contain the values: <br><br>
	<code>		<code>
	0x02 ~~0xWW~~ 0x03 ~~0xWW~~ 0xFF		0x02 0xWWWW 0x03 0xWWWW 0xFF
	</code>		</code>
	<br><br>		<br><br>
	Where ~~0xWW~~ represents some arbitrary weight value. An entry denoting weights to joints 1, 2, 3, and 5 would contain the values:		Where 0xWWWW represents some arbitrary weight value. An entry denoting weights to joints 1, 2, 3, and 5 would contain the values:
	<br><br>		<br><br>
	<code>		<code>
	0x01 ~~0xWW~~ 0x02 ~~0xWW~~ 0x03 ~~0xWW~~ 0x05 ~~0xWW~~		0x01 0xWWWW 0x02 0xWWWW 0x03 0xWWWW 0x05 0xWWWW
	</code>		</code>
	<br><br>		<br><br>

Nalates Urriah: /* Overview */ Add image of data format

2012-03-13T00:52:55Z

Overview: Add image of data format

← Older revision		Revision as of 17:52, 12 March 2012
Line 1:		Line 1:
	{{Navbox/Mesh\|tech}}		{{Navbox/Mesh\|tech}}
			[[File:Drongle-Mesh-Format.jpg\|thumb\|250px\|left\|Click to Enlarge]]
	== Overview ==		== Overview ==
	This document is a specification of the mesh asset format used by Second Life. At its highest level, a mesh asset is a collection of data blocks spread across a file. The sizes, locations, and types of the data elements are described in the header at the beginning of the file. This document will describe the format of the header and each of the data block types it may reference.		This document is a specification of the mesh asset format used by Second Life. At its highest level, a mesh asset is a collection of data blocks spread across a file. The sizes, locations, and types of the data elements are described in the header at the beginning of the file. This document will describe the format of the header and each of the data block types it may reference.

Runitai Linden: /* Versioning and Creator Information */

2011-06-27T15:23:32Z

Versioning and Creator Information

← Older revision		Revision as of 08:23, 27 June 2011
Line 7:		Line 7:

	=== Versioning and Creator Information ===		=== Versioning and Creator Information ===
	* "version" -- integer -- A version number for the entire asset, filled in by simulator post-import.		* "version" -- integer -- A version number for the entire asset, filled in by simulator post-import. Three least significant digits are reserved for the minor version, with major version changes indicating a format change that is not backwards compatible and should not be parsed by viewers that don't specifically support that version. For example, if the integer "1" is present, the version is 0.001. A viewer that can parse version 0.001 can also parse versions up to 0.999, but not 1.0 (integer 1000).
	* "creator" -- UUID -- agent id of the agent that uploaded the asset, filled in by simulator		* "creator" -- UUID -- agent id of the agent that uploaded the asset, filled in by simulator
	* "date" -- LLDate (as LLSD, seconds since epoch UTC) of upload, filled in by simulator		* "date" -- LLDate (as LLSD, seconds since epoch UTC) of upload, filled in by simulator

Rand Linden at 20:23, 21 June 2011

2011-06-21T20:23:08Z

← Older revision		Revision as of 13:23, 21 June 2011
Line 1:		Line 1:
			{{Navbox/Mesh\|tech}}
	== Overview ==		== Overview ==
	This document is a specification of the mesh asset format used by Second Life. At its highest level, a mesh asset is a collection of data blocks spread across a file. The sizes, locations, and types of the data elements are described in the header at the beginning of the file. This document will describe the format of the header and each of the data block types it may reference.		This document is a specification of the mesh asset format used by Second Life. At its highest level, a mesh asset is a collection of data blocks spread across a file. The sizes, locations, and types of the data elements are described in the header at the beginning of the file. This document will describe the format of the header and each of the data block types it may reference.

Prep Linden: /* Skin Block */

2011-06-09T15:16:14Z

Skin Block

← Older revision		Revision as of 08:16, 9 June 2011
Line 66:		Line 66:
	* "JointNames" -- joint name list for this skin. Will contain joint names from the above list.		* "JointNames" -- joint name list for this skin. Will contain joint names from the above list.
	* "BindShapeMatrix" -- matrix that transforms from model space to world space. One per skin.		* "BindShapeMatrix" -- matrix that transforms from model space to world space. One per skin.
	* "InvBindMatrix" -- matrix that transforms from skin local space to joint local space. One per joint having influences.		* "InvBindMatrix" -- matrix that transforms from skin local space(world space) to joint local space. One per joint having influences.
	* "AlternateBindMatrix" -- optional, if joint offsets are used then the alternate bind matrix will contain translational information that will override the default Second Life skeleton. Rotational and scaling components are at this moment, unused.		* "AlternateBindMatrix" -- optional, if joint offsets are used then the alternate bind matrix will contain translational information that will override the default Second Life skeleton. Rotational and scaling components are at this moment, unused.
	* "PelvisOffset" -- optional, used to provide a pelvis fixup for avatar rigs that alter the default Second Life skeleton.		* "PelvisOffset" -- optional, used to provide a pelvis fixup for avatar rigs that alter the default Second Life skeleton.

Prep Linden: /* Skin Block */

2011-06-08T21:34:22Z

Skin Block

← Older revision		Revision as of 14:34, 8 June 2011
Line 61:		Line 61:

	== Skin Block ==		== Skin Block ==
	The skin block may alter all or part of the default Second Life skeleton. A partial joint list will contain a subset of these joints: ''mPelvis, mTorso, mChest, mNeck, mHead, mCollarLeft, mShoulderLeft, mElbowLeft,'' ''mWristLeft, mCollarRight, mShoulderRight, mElbowRight, mWristRight, mHipRight, mKneeRight, mFootRight,''		The skin block may optionally alter all or part of the default Second Life skeleton. A partial joint list will contain a subset of these joints: ''mPelvis, mTorso, mChest, mNeck, mHead, mCollarLeft, mShoulderLeft, mElbowLeft,'' ''mWristLeft, mCollarRight, mShoulderRight, mElbowRight, mWristRight, mHipRight, mKneeRight, mFootRight,''
	''mHipLeft, mKneeLeft, mFootLeft'' where a full avatar replacement will contain and reference all of these joints.		''mHipLeft, mKneeLeft, mFootLeft'' where a full avatar replacement will contain and reference all of these joints.

Prep Linden: /* Skin Block */

2011-06-08T21:07:55Z

Skin Block

← Older revision		Revision as of 14:07, 8 June 2011
Line 65:		Line 65:

	* "JointNames" -- joint name list for this skin. Will contain joint names from the above list.		* "JointNames" -- joint name list for this skin. Will contain joint names from the above list.
	* "BindShapeMatrix" -- matrix that transforms from ~~joint local~~ space to ~~skin local~~ space. One per ~~joint~~.		* "BindShapeMatrix" -- matrix that transforms from model space to world space. One per skin.
	* "InvBindMatrix" -- matrix that transforms from skin local space to joint local space. One per joint.		* "InvBindMatrix" -- matrix that transforms from skin local space to joint local space. One per joint having influences.
	* "AlternateBindMatrix" -- optional, if joint offsets are used then the alternate bind matrix will contain translational information that will override the default Second Life skeleton. Rotational and scaling components are at this moment, unused.		* "AlternateBindMatrix" -- optional, if joint offsets are used then the alternate bind matrix will contain translational information that will override the default Second Life skeleton. Rotational and scaling components are at this moment, unused.
	* "PelvisOffset" -- optional, used to provide a pelvis fixup for avatar rigs that alter the default Second Life skeleton.		* "PelvisOffset" -- optional, used to provide a pelvis fixup for avatar rigs that alter the default Second Life skeleton.

Prep Linden: /* Skin Block */

2011-06-08T20:48:55Z

Skin Block

← Older revision		Revision as of 13:48, 8 June 2011
Line 65:		Line 65:

	* "JointNames" -- joint name list for this skin. Will contain joint names from the above list.		* "JointNames" -- joint name list for this skin. Will contain joint names from the above list.
	* "BindShapeMatrix" -- matrix that ~~defines how to bring the vertices~~ from ~~model~~ space ~~into world~~ space.		* "BindShapeMatrix" -- matrix that transforms from joint local space to skin local space. One per joint.
	* "InvBindMatrix" -- matrix that ~~defines how to bring a vertices~~ from ~~world~~ space ~~into~~ joint space ~~for skinning~~.		* "InvBindMatrix" -- matrix that transforms from skin local space to joint local space. One per joint.
	* "AlternateBindMatrix" -- optional, if joint offsets are used then the alternate bind matrix will contain translational information that will override the default Second Life skeleton. Rotational and scaling components are at this moment, unused.		* "AlternateBindMatrix" -- optional, if joint offsets are used then the alternate bind matrix will contain translational information that will override the default Second Life skeleton. Rotational and scaling components are at this moment, unused.
	* "PelvisOffset" -- optional, used to provide a pelvis fixup for avatar rigs that alter the default Second Life skeleton.		* "PelvisOffset" -- optional, used to provide a pelvis fixup for avatar rigs that alter the default Second Life skeleton.