<?xml version="1.0" encoding="utf-8" standalone="yes"?>

<?xml-stylesheet href="./_c74_ref.xsl" type="text/xsl"?>

<!--This is an automatically generated file. DO NOT EDIT THIS FILE DIRECTLY. Rather, use the _ref.xml files found in the 'edits' folder.-->
<c74object name="jit.quat" module="jit" category="Jitter OpenGL">
	<digest>
		Quaternion multiplication
	</digest>
	<description>
		<o>jit.quat</o> will perform quaternion multiplication, with optional normalization of the input quaternions. In relation to 3D transforms, quaternion multiplication is the concatenation of two orientations.
	</description>
	<!--METADATA-->
	<metadatalist>
		<metadata name="author">
			Cycling '74
		</metadata>
		<metadata name="tag">
			Jitter
		</metadata>
	</metadatalist>
	<!--INLETS-->
	<inletlist>
		<inlet id="0" type="INLET_TYPE">
			<digest>
				quat 1
			</digest>
			<description>
				TEXT_HERE
			</description>
		</inlet>
		<inlet id="1" type="INLET_TYPE">
			<digest>
				quat 2
			</digest>
			<description>
				TEXT_HERE
			</description>
		</inlet>
	</inletlist>
	<!--OUTLETS-->
	<outletlist>
		<outlet id="0" type="OUTLET_TYPE">
			<digest>
				quat out
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
		<outlet id="1" type="OUTLET_TYPE">
			<digest>
				dumpout
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
	</outletlist>
	<!--MESSAGES-->
	<methodlist>
		<method name="bang">
			<arglist />
			<digest>
				Perform multiplication and output result
			</digest>
			<description>
				Perform the multiplication and output the resulting quaternion.
			</description>
		</method>
		<method name="list">
			<arglist>
				<arg name="x" type="float" />
				<arg name="y" type="float" />
				<arg name="z" type="float" />
				<arg name="w" type="float" />
			</arglist>
			<digest>
				Function depends on inlet
			</digest>
			<description>
				In left inlet: A four element list of floating point numbers sets the first operand and triggers the multiplication and output.
				<br />
				<br />
				In right inlet: A four element list of floating point numbers sets the second operand.
			</description>
		</method>
	</methodlist>
	<jittermethodlist>
		<jittermethod name="exportattrs" />
		<jittermethod name="exportsummary" />
		<jittermethod name="getattributes" />
		<jittermethod name="getstate" />
		<jittermethod name="importattrs" />
		<jittermethod name="summary" />
	</jittermethodlist>
	<!--ATTRIBUTES-->
	<attributelist>
		<attribute name="inverse" get="1" set="0" type="float" size="4">
			<digest>
				Opposite rotation for the output quaternion
			</digest>
			<description>
				The output quaternion's opposite rotation.
			</description>
			<attributelist>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Inverse" />
			</attributelist>
		</attribute>
		<attribute name="normalize" get="1" set="1" type="int" size="1">
			<digest>
				Normalization flag
			</digest>
			<description>
				Determines whether or not the input quaternions are normalized before the multiplication. (default = 0)
			</description>
			<attributelist>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Normalize" />
				<attribute name="style" get="1" set="1" type="symbol" size="1" value="onoff" />
			</attributelist>
		</attribute>
		<attribute name="quat1" get="1" set="1" type="float" size="4">
			<digest>
				First operand
			</digest>
			<description>
				Sets the first operand (default = 0 0 0 1)
			</description>
			<attributelist>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Quat 1" />
			</attributelist>
		</attribute>
		<attribute name="quat2" get="1" set="1" type="float" size="4">
			<digest>
				Second operand
			</digest>
			<description>
				Sets the second operand (default = 0 0 0 1)
			</description>
			<attributelist>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Quat 2" />
			</attributelist>
		</attribute>
		<attribute name="quatout" get="1" set="0" type="float" size="4">
			<digest>
				Product of the multiplication
			</digest>
			<description>
				The resulting quaternion after the multiplication
			</description>
			<attributelist>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Quat Out" />
			</attributelist>
		</attribute>
		<attribute name="xaxis" get="1" set="1" type="float" size="3">
			<digest>
				The output quaternion's X axis
			</digest>
			<description>
				the output quaternion's rotation matrix X axis.
			</description>
			<attributelist>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="X Axis" />
			</attributelist>
		</attribute>
		<attribute name="yaxis" get="1" set="1" type="float" size="3">
			<digest>
				The output quaternion's Y axis
			</digest>
			<description>
				the output quaternion's rotation matrix Y axis.
			</description>
			<attributelist>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Y Axis" />
			</attributelist>
		</attribute>
		<attribute name="zaxis" get="1" set="1" type="float" size="3">
			<digest>
				The output quaternion's Z axis
			</digest>
			<description>
				the output quaternion's rotation matrix Z axis.
			</description>
			<attributelist>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Z Axis" />
			</attributelist>
		</attribute>
	</attributelist>
	<jitterattributelist />
	<!--EXAMPLE-->
	<examplelist>
		<example img="jit.quat.png" />
	</examplelist>
	<!--SEEALSO-->
	<seealsolist>
		<seealso name="jit.quat2axis" />
		<seealso name="jit.axis2quat" />
		<seealso name="jit.quat2euler" />
		<seealso name="jit.euler2quat" />
		<seealso name="jit.anim.node" />
	</seealsolist>
	<discussion>
		A quaternion is a mathematical construct that is a four dimensional vector, and can be visualized as a rotation around an arbitrary axis. Quaternions are a useful representation of an orientation in 3D space.
	</discussion>
</c74object>
