XML:OBAN - Revision history

ValBot: replaced Oni Central Forum link with archive.org snapshot URL

2025-12-26T05:11:01Z

replaced Oni Central Forum link with archive.org snapshot URL

← Older revision		Revision as of 05:11, 26 December 2025
Line 153:		Line 153:

	==Calculating a quaternion==		==Calculating a quaternion==
	An early attempt to harvest quaternions and positions from TRAM files with OniSplit [http://mods.oni2.net/node/38 v0.9.54.0] can be found [http://oni.bungie.org/forum/viewtopic.php?id=2276 over here]. But that script runs inside an Excel file, and Excel isn't a free program, nor is the code compatible with OpenOffice.		An early attempt to harvest quaternions and positions from TRAM files with OniSplit [http://mods.oni2.net/node/38 v0.9.54.0] can be found [http://web.archive.org/web/20160225013043/http://oni.bungie.org/forum/viewtopic.php?id=2276 over here]. But that script runs inside an Excel file, and Excel isn't a free program, nor is the code compatible with OpenOffice.

	VBS code snippets for use with Mod Tool can be found here:		VBS code snippets for use with Mod Tool can be found here:

Iritscen: replaced matrix GIF with Math markup; had to change guide colors to suit what's available with Math's Tex implementation

2024-01-06T15:47:07Z

replaced matrix GIF with Math markup; had to change guide colors to suit what's available with Math's Tex implementation

← Older revision		Revision as of 15:47, 6 January 2024
Line 162:		Line 162:
	In some scenarios we need to build a new transform matrix, e.g. when making a new weapon particle emitter. The first 9 values belong to a 3x3 rotation matrix. The last 3 values are the start positions.		In some scenarios we need to build a new transform matrix, e.g. when making a new weapon particle emitter. The first 9 values belong to a 3x3 rotation matrix. The last 3 values are the start positions.

	~~[[Image~~:~~rotation_of_transform_matrix.png~~\|~~right~~\|~~thumb~~\|~~single rotation matrices]]~~		{\| style="float:right;"
			!Single rotation matrices
			\|-
			\|<math>R_x(\theta)=\begin{bmatrix}
			\color{Salmon}1 & \color{YellowGreen}0 & \color{CornflowerBlue}0 \\
			\color{Salmon}0 & \color{YellowGreen}\cos\theta & \color{CornflowerBlue}-\sin\theta \\
			\color{Salmon}0 & \color{YellowGreen}\sin\theta & \color{CornflowerBlue}\cos\theta\end{bmatrix}
			</math>
			\|}

	x = 60		x = 60
	<InitialTransform><span style="background-color:#~~F77~~">1 0 0</span> <span style="background-color:#~~7F7~~">0 0.5 0.8660254</span> <span style="background-color:#~~77F~~">0 -0.8660254 0.5</span> <font style="color:#AAAAAA">0 0 0</font></InitialTransform>		<InitialTransform><span style="background-color:#F69289">1 0 0</span> <span style="background-color:#98CC70">0 0.5 0.8660254</span> <span style="background-color:#41B0E4">0 -0.8660254 0.5</span> <font style="color:#AAAAAA">0 0 0</font></InitialTransform>
	<span style="background-color:#~~F77~~">1 0 0</span> <span style="background-color:#~~7F7~~">0 cos(x) sin(x)</span> <span style="background-color:#~~77F~~">0 -sin(x) cos(x)<span>		<span style="background-color:#F69289">1 0 0</span> <span style="background-color:#98CC70">0 cos(x) sin(x)</span> <span style="background-color:#41B0E4">0 -sin(x) cos(x)<span>

	y = 60		y = 60
	<InitialTransform><span style="background-color:#~~FF7~~">0.5 0 -0.8660254</span> <span style="background-color:#~~F7F~~">0 1 0</span> <span style="background-color:#~~7FF~~">0.8660254 0 0.5</span> <font style="color:#AAAAAA">0 0 0</font></InitialTransform>		{\| style="float:right;"
	<span style="background-color:#~~FF7~~">cos(y) 0 -sin(y)</span> <span style="background-color:#~~F7F~~">0 1 0</span> <span style="background-color:#~~7FF~~">sin(y) 0 cos(y)</span>		\|-
			\|<math>R_x(\theta)=\begin{bmatrix}
			\color{YellowOrange}\cos\theta & \color{SpringGreen}0 & \color{ProcessBlue}\sin\theta \\
			\color{YellowOrange}0 & \color{SpringGreen}1 & \color{ProcessBlue}0 \\
			\color{YellowOrange}-\sin\theta & \color{SpringGreen}0 & \color{ProcessBlue}\cos\theta\end{bmatrix}
			</math>
			\|}
			<InitialTransform><span style="background-color:#FAA21A">0.5 0 -0.8660254</span> <span style="background-color:#C6DC67">0 1 0</span> <span style="background-color:#00B0F0">0.8660254 0 0.5</span> <font style="color:#AAAAAA">0 0 0</font></InitialTransform>
			<span style="background-color:#FAA21A">cos(y) 0 -sin(y)</span> <span style="background-color:#C6DC67">0 1 0</span> <span style="background-color:#00B0F0">sin(y) 0 cos(y)</span>

	z = 60		z = 60
	<InitialTransform><span style="background-color:#~~777~~">0.5 0.8660254 0</span> <span style="background-color:#~~AAA~~">-0.8660254 0.5 0</span> <span style="background-color:#~~DDD~~">0 0 1</span> <font style="color:#AAAAAA">0 0 0</font></InitialTransform>		{\| style="float:right;"
	<span style="background-color:#~~777~~">cos(z) sin(z) 0</span> <span style="background-color:#~~AAA~~">-sin(z) cos(z) 0</span> <span style="background-color:#~~DDD~~">0 0 1</span>		\|-
			\|<math>R_x(\theta)=\begin{bmatrix}
			\color{OrangeRed}1 & \color{SeaGreen}0 & \color{RoyalBlue}0 \\
			\color{OrangeRed}0 & \color{SeaGreen}\cos\theta & \color{RoyalBlue}-\sin\theta \\
			\color{OrangeRed}0 & \color{SeaGreen}\sin\theta & \color{RoyalBlue}\cos\theta\end{bmatrix}
			</math>
			\|}
			<InitialTransform><span style="background-color:#ED135A">0.5 0.8660254 0</span> <span style="background-color:#3FBC9D">-0.8660254 0.5 0</span> <span style="background-color:#0071BC">0 0 1</span> <font style="color:#AAAAAA">0 0 0</font></InitialTransform>
			<span style="background-color:#ED135A">cos(z) sin(z) 0</span> <span style="background-color:#3FBC9D">-sin(z) cos(z) 0</span> <span style="background-color:#0071BC">0 0 1</span>

	{\| class="wikitable" style="float:right;"		{\| class="wikitable" style="float:right;"

Iritscen: link fix

2021-09-21T20:17:57Z

link fix

← Older revision		Revision as of 20:17, 21 September 2021
Line 103:		Line 103:
	;Transform matrices		;Transform matrices
	:Like all matrices in Oni, they are composed of 3 vectors defining rotation/scaling/shearing and a 4th vector defining a translation.		:Like all matrices in Oni, they are composed of 3 vectors defining rotation/scaling/shearing and a 4th vector defining a translation.
	:In the above table, the 4 vectors are presented as rows per [[~~wikipedia~~:~~row~~-major_order\|Direct3D convention]], although OpenGL and Oni use them as columns.		:In the above table, the 4 vectors are presented as rows per [[wp:Row-_and_column-major_order\|Direct3D convention]], although OpenGL and Oni use them as columns.
	:[[~~wikipedia~~:Transformation_matrix#Affine_transformations\|Affine transformations]] use a 4x4 matrix with 4 extra coefficients (in the presentation above, one would add one column on the right):		:[[wp:Transformation_matrix#Affine_transformations\|Affine transformations]] use a 4x4 matrix with 4 extra coefficients (in the presentation above, one would add one column on the right):
	::Three [[~~wikipedia~~:3D_projection\|projection transform]] coefficients (all of them are zero here); one final coefficient (always 1.0 for an affine transform matrix).		::Three [[wp:3D_projection\|projection transform]] coefficients (all of them are zero here); one final coefficient (always 1.0 for an affine transform matrix).
	:Alternately, one can think of the 3x4 matrix as a 3x3 rotation/scaling matrix and a position vector:		:Alternately, one can think of the 3x4 matrix as a 3x3 rotation/scaling matrix and a position vector:
	::*Let X=(x, y, z) be the position of a vertex in the M3GM		::*Let X=(x, y, z) be the position of a vertex in the M3GM

Iritscen: link fixes

2021-04-05T13:14:19Z

link fixes

← Older revision		Revision as of 13:14, 5 April 2021
Line 157:		Line 157:
	VBS code snippets for use with Mod Tool can be found here:		VBS code snippets for use with Mod Tool can be found here:
	* [[Mod_Tool/Scripting#Euler_rotation_-.3E_quaternion\|Euler rotation to quaternion]]		* [[Mod_Tool/Scripting#Euler_rotation_-.3E_quaternion\|Euler rotation to quaternion]]
	* [[Mod_Tool/Scripting#~~quaternion_~~-.3E_Euler_rotation\|quaternion to Euler rotation]]		* [[Mod_Tool/Scripting#Quaternion_-.3E_Euler_rotation\|quaternion to Euler rotation]]

	==Calculating a transform matrix==		==Calculating a transform matrix==
Line 191:		Line 191:
	Mod Tool VBS code (rotations only):		Mod Tool VBS code (rotations only):
	* [[Mod_Tool/Scripting#Euler_rotation_-.3E_matrix\|Euler rotation to matrix]]		* [[Mod_Tool/Scripting#Euler_rotation_-.3E_matrix\|Euler rotation to matrix]]
	* [[Mod_Tool/Scripting#~~matrix_~~-.3E_Euler_rotation\|matrix to Euler rotation]]		* [[Mod_Tool/Scripting#Matrix_-.3E_Euler_rotation\|matrix to Euler rotation]]

	==Wish list==		==Wish list==

Iritscen: link fixes

2021-04-05T12:54:07Z

link fixes

← Older revision		Revision as of 12:54, 5 April 2021
Line 156:		Line 156:

	VBS code snippets for use with Mod Tool can be found here:		VBS code snippets for use with Mod Tool can be found here:
	* [[Mod_Tool/Scripting#~~euler_rotation_~~-.3E_quaternion\|Euler rotation to quaternion]]		* [[Mod_Tool/Scripting#Euler_rotation_-.3E_quaternion\|Euler rotation to quaternion]]
	* [[Mod_Tool/Scripting#quaternion_-.~~3E_euler_rotation~~\|quaternion to Euler rotation]]		* [[Mod_Tool/Scripting#quaternion_-.3E_Euler_rotation\|quaternion to Euler rotation]]

	==Calculating a transform matrix==		==Calculating a transform matrix==
Line 190:		Line 190:

	Mod Tool VBS code (rotations only):		Mod Tool VBS code (rotations only):
	* [[Mod_Tool/Scripting#~~euler_rotation_~~-.3E_matrix\|Euler rotation to matrix]]		* [[Mod_Tool/Scripting#Euler_rotation_-.3E_matrix\|Euler rotation to matrix]]
	* [[Mod_Tool/Scripting#matrix_-.~~3E_euler_rotation~~\|matrix to Euler rotation]]		* [[Mod_Tool/Scripting#matrix_-.3E_Euler_rotation\|matrix to Euler rotation]]

	==Wish list==		==Wish list==

Iritscen: link fixes

2021-04-05T12:47:53Z

link fixes

← Older revision		Revision as of 12:47, 5 April 2021
Line 103:		Line 103:
	;Transform matrices		;Transform matrices
	:Like all matrices in Oni, they are composed of 3 vectors defining rotation/scaling/shearing and a 4th vector defining a translation.		:Like all matrices in Oni, they are composed of 3 vectors defining rotation/scaling/shearing and a 4th vector defining a translation.
	:In the above table, the 4 vectors are presented as rows per [[~~Wikipedia~~:row-major_order\|Direct3D convention]], although OpenGL and Oni use them as columns.		:In the above table, the 4 vectors are presented as rows per [[wikipedia:row-major_order\|Direct3D convention]], although OpenGL and Oni use them as columns.
	:[[~~Wikipedia~~:Transformation_matrix#Affine_transformations\|Affine transformations]] use a 4x4 matrix with 4 extra coefficients (in the presentation above, one would add one column on the right):		:[[wikipedia:Transformation_matrix#Affine_transformations\|Affine transformations]] use a 4x4 matrix with 4 extra coefficients (in the presentation above, one would add one column on the right):
	::Three [[~~Wikipedia~~:3D_projection\|projection transform]] coefficients (all of them are zero here); one final coefficient (always 1.0 for an affine transform matrix).		::Three [[wikipedia:3D_projection\|projection transform]] coefficients (all of them are zero here); one final coefficient (always 1.0 for an affine transform matrix).
	:Alternately, one can think of the 3x4 matrix as a 3x3 rotation/scaling matrix and a position vector:		:Alternately, one can think of the 3x4 matrix as a 3x3 rotation/scaling matrix and a position vector:
	::*Let X=(x, y, z) be the position of a vertex in the M3GM		::*Let X=(x, y, z) be the position of a vertex in the M3GM

Iritscen: correcting prev/next types in nav header

2021-03-27T19:11:16Z

correcting prev/next types in nav header

← Older revision		Revision as of 19:11, 27 March 2021
Line 1:		Line 1:
	{{XML_File_Header \| type=OBAN ~~\| prev=Mtrl~~ \| next=~~OBOA~~ \| name=Object Animation }}		{{XML_File_Header \| prev=Mtrl \| type=OBAN \| next=OFGA \| name=Object Animation}}

	==General information==		==General information==

Iritscen: removing macro per Paradox's request, as we now create OBANs directly with OniSplit

2021-03-21T17:46:15Z

removing macro per Paradox's request, as we now create OBANs directly with OniSplit

← Older revision		Revision as of 17:46, 21 March 2021
Line 156:		Line 156:

	VBS code snippets for use with Mod Tool can be found here:		VBS code snippets for use with Mod Tool can be found here:
	* [[Mod_Tool/Scripting#euler_rotation_-.3E_quaternion\|~~euler~~ rotation to quaternion]]		* [[Mod_Tool/Scripting#euler_rotation_-.3E_quaternion\|Euler rotation to quaternion]]
	* [[Mod_Tool/Scripting#quaternion_-.3E_euler_rotation\|quaternion to ~~euler~~ rotation]]		* [[Mod_Tool/Scripting#quaternion_-.3E_euler_rotation\|quaternion to Euler rotation]]

	==Calculating a transform matrix==		==Calculating a transform matrix==
Line 194:		Line 194:

	==Wish list==		==Wish list==
	* TRAM import: DAE + XML		* TRAM import: DAE + XML. The DAE section in the XML file should have an option to create a pelvis OBAN along with the TRAM (see [[XML:TRAM]]'s RealWorld flag for details).
	** The DAE section in the XML file should have an option to create a pelvis OBAN along with the TRAM (see [[XML:TRAM]]'s RealWorld flag for details)		* DAE to .oni creation should also allow for OBANs (currently OBANs can only be imported via the level's master XML file). This would be very useful for editing/creating single OBAN files if the rest of the level doesn't need changes.
	* DAE to .oni creation should also allow for OBANs (currently OBANs can only be imported via the level's master XML file)
	** This would be very useful for editing/creating single OBAN files if the rest of the level doesn't need changes

	~~==Camera OBAN creation with XSI==~~
	~~Watch out for the drag-and-drop workflow~~. ~~You'd better work with a free object.~~
	~~[[Image:XML_OBAN_camera_with_XSI.jpg\|thumb\|300px]]~~
	* [http://mods.oni2.net/node/383 Old Excel macro]

	{{XML}}		{{XML}}

Paradox-01: another harvest huh ... obsolete

2021-03-21T16:13:00Z

another harvest huh ... obsolete

← Older revision		Revision as of 16:13, 21 March 2021
Line 88:		Line 88:
	\| Holds <OBANKeyFrame> tags.		\| Holds <OBANKeyFrame> tags.
	\|-		\|-
	\| <Rotation>		\|valign=top\| <Rotation>
	\| quaternion		\|valign=top\| quaternion
	\| Object rotation~~; can be~~ harvested from TRAM files.		\| Object rotation. (In the old days we harvested quaternions from TRAM files whereby a special version (0.9.54.0) of OniSplit was needed. Nowadays OBAN creation is fully supported by OniSplit. No more headaches.)
	\|-		\|-
	\| <Translation>		\| <Translation>

Iritscen: copy-edit

2021-03-21T14:19:50Z

copy-edit

Show changes