Binary File Formats - Revision history

Merlyn: /* PHXBN header */ fix count of bytes in a matrix

2022-04-23T22:28:38Z

PHXBN header: fix count of bytes in a matrix

← Older revision		Revision as of 15:28, 23 April 2022
Line 478:		Line 478:
	\|-		\|-
	! bones_matrices		! bones_matrices
	\| ~~144~~ bytes * bones_count \|\| float32[bones_count][16] \|\| only present if version is 9 or higher \|\| this value is ignored and recalculated internally in engine regardless of version<br>the engine uses '''bones_ends''' to calculate it		\| 64 bytes * bones_count \|\| float32[bones_count][16] \|\| only present if version is 9 or higher \|\| this value is ignored and recalculated internally in engine regardless of version<br>the engine uses '''bones_ends''' to calculate it
	\|}		\|}

Merlyn: /* PHXBN header */ change "int" to "int32"

2022-04-23T22:19:51Z

PHXBN header: change "int" to "int32"

← Older revision		Revision as of 15:19, 23 April 2022
Line 466:		Line 466:
	\|-		\|-
	! bones_ends		! bones_ends
	\| 8 bytes * bones_count \|\| ~~int~~[bones_ends][2] \|\| \|\|		\| 8 bytes * bones_count \|\| int32[bones_ends][2] \|\| \|\|
	\|-		\|-
	! bones_parent_indices		! bones_parent_indices

Merlyn: /* PHXBN header */ Mention expected PHXBN version for new files

2021-09-02T21:33:30Z

PHXBN header: Mention expected PHXBN version for new files

← Older revision		Revision as of 14:33, 2 September 2021
Line 436:		Line 436:
	\|-		\|-
	! version		! version
	\| 4 bytes \|\| int32 \|\| only present if version is 6 or higher \|\| if version is less than 6 then assume version is 5 and assign this value to rigging_stage instead		\| 4 bytes \|\| int32 \|\| only present if version is 6 or higher \|\| version for new files should be set to 11.<br/>when loading files, if version is less than 6 then assume version is 5 and assign this value to rigging_stage instead
	\|-		\|-
	! rigging_stage		! rigging_stage

Merlyn: Add more info on PHXBN "bone center of mass" values

2021-03-15T08:18:03Z

Add more info on PHXBN "bone center of mass" values

← Older revision		Revision as of 01:18, 15 March 2021
Line 475:		Line 475:
	\|-		\|-
	! bones_center_of_mass		! bones_center_of_mass
	\| 12 bytes * bones_count \|\| float32[bones_count][3] \|\| only present if version is 7 or higher \|\| if version is less than 7 then calculate from '''bones_ends''' midpoints instead		\| 12 bytes * bones_count \|\| float32[bones_count][3] \|\| only present if version is 7 or higher \|\| if version is less than 7 then calculate from '''bones_ends''' midpoints instead<br>the value is not currently used by the engine, and the turner player model has them all zeroed out
	\|-		\|-
	! bones_matrices		! bones_matrices

Merlyn: /* PHXBN related error messages */

2021-03-08T00:48:06Z

PHXBN related error messages

← Older revision		Revision as of 17:48, 7 March 2021
Line 211:		Line 211:
	\|-		\|-
	! Skeleton file and model file have different vertex counts.		! Skeleton file and model file have different vertex counts.
	\| The PHXBN file you are using was probably exported off a different OBJ model file.<br>These are the files specified in the character file (the .xml file with a '''<character>''' element in it)<br>You probably just can't use this skeleton with this model.<br>Either change the '''skeleton''' value (under '''<appearance''') or the '''obj_path''' value (also under '''<appearance''').<br>'''TODO: I think this is the right model? Could also be the ~~model~~ defined in the ''<rig'' XML file? -merlyn'''		\| The PHXBN file you are using was probably exported off a different OBJ model file.<br>These are the files specified in the character file (the .xml file with a '''<character>''' element in it)<br>You probably just can't use this skeleton with this model.<br>Either change the '''skeleton''' value (under '''<appearance''') or the '''obj_path''' value (also under '''<appearance''').<br>'''TODO: I think this is the right model? Could also be the ''model_path'' defined in the ''<rig'' XML file? -merlyn'''
	\|}		\|}

Merlyn: /* PHXBN related error messages */

2021-03-08T00:46:46Z

PHXBN related error messages

← Older revision		Revision as of 17:46, 7 March 2021
Line 211:		Line 211:
	\|-		\|-
	! Skeleton file and model file have different vertex counts.		! Skeleton file and model file have different vertex counts.
	\| The PHXBN file you are using was probably exported off a different OBJ model file.<br>These are the files specified in the character file (the .xml file with a '''<character>''' element in it)<br>You probably just can't use this skeleton with this model.<br>Either change the '''skeleton''' value (under '''<appearance''') or the '''obj_path''' value (also under '''<appearance''').		\| The PHXBN file you are using was probably exported off a different OBJ model file.<br>These are the files specified in the character file (the .xml file with a '''<character>''' element in it)<br>You probably just can't use this skeleton with this model.<br>Either change the '''skeleton''' value (under '''<appearance''') or the '''obj_path''' value (also under '''<appearance''').<br>'''TODO: I think this is the right model? Could also be the model defined in the ''<rig'' XML file? -merlyn'''
	\|}		\|}


	===PHXBN 010 template===		===PHXBN 010 template===

Merlyn: Add information on error messages encountered when loading a PHXBN file

2021-03-08T00:43:48Z

Add information on error messages encountered when loading a PHXBN file

@@ Line 191: / Line 191: @@
 ==PHXBN==
 This is the skeleton file format for rigged objects in the Phoenix engine.
 ===PHXBN 010 template===

Merlyn: Add more info about how bones_matrices gets calculated

2021-03-08T00:18:04Z

Add more info about how bones_matrices gets calculated

← Older revision		Revision as of 17:18, 7 March 2021
Line 453:		Line 453:
	\|-		\|-
	! bones_center_of_mass		! bones_center_of_mass
	\| 12 bytes * bones_count \|\| float32[bones_count][3] \|\| only present if version is 7 or higher \|\| if version is less than 7 then calculate from bones_ends midpoints instead		\| 12 bytes * bones_count \|\| float32[bones_count][3] \|\| only present if version is 7 or higher \|\| if version is less than 7 then calculate from '''bones_ends''' midpoints instead
	\|-		\|-
	! bones_matrices		! bones_matrices
	\| 144 bytes * bones_count \|\| float32[bones_count][16] \|\| only present if version is 9 or higher \|\| this value is ignored and recalculated internally in engine regardless of version		\| 144 bytes * bones_count \|\| float32[bones_count][16] \|\| only present if version is 9 or higher \|\| this value is ignored and recalculated internally in engine regardless of version<br>the engine uses '''bones_ends''' to calculate it
	\|}		\|}

	-----		-----

	====PHXBN control joints====		====PHXBN control joints====

Merlyn: Add section header information to PHXBN file layout tables

2021-03-08T00:13:19Z

Add section header information to PHXBN file layout tables

← Older revision		Revision as of 17:13, 7 March 2021
Line 363:		Line 363:

	-----		-----
			====PHXBN enumerated types====

	Some enumerated type definitions. These are not part of the file data itself, and are just assumed information:		Some enumerated type definitions. These are not part of the file data itself, and are just assumed information:
Line 403:		Line 404:

	-----		-----
			====PHXBN header====

	The file data itself begins here:		The file data itself begins here:
Line 458:		Line 460:

	-----		-----
			====PHXBN control joints====

	The '''skeleton control joints''' sections are only present if rigging_stage equals 1 (control_joints) or 2 (animate):		The '''skeleton control joints''' sections are only present if rigging_stage equals 1 (control_joints) or 2 (animate):
Line 530:		Line 533:

	-----		-----
			====PHXBN simple IK bones====

	The '''skeleton simple ik bones''' sections are only present if version is 10 or higher:		The '''skeleton simple ik bones''' sections are only present if version is 10 or higher:

Merlyn: /* PHXBN file layout */

2021-03-08T00:10:39Z

PHXBN file layout

← Older revision		Revision as of 17:10, 7 March 2021
Line 483:		Line 483:
	The next section is a list of variable size. count of list is '''control_joints_count'''.<br>		The next section is a list of variable size. count of list is '''control_joints_count'''.<br>
	The section is only present if rigging_stage equals 1 (control_joints) or 2 (animate).<br>		The section is only present if rigging_stage equals 1 (control_joints) or 2 (animate).<br>
	~~each~~ list item will be from one of the following tables, and since the list isn't ordered by type, the amount of memory used for this table can't really be determined until the whole list is checked one item at a time:		Each list item will be from one of the following tables, and since the list isn't ordered by type, the amount of memory used for this table can't really be determined until the whole list is checked one item at a time:
	{\| class="wikitable"		{\| class="wikitable"
	\|+ skeleton hinge control joint		\|+ skeleton hinge control joint