XMXDECN4::XMXDECN4(float,float,float,float) function (directxpackedvector.h)
Initializes a new instance of XMXDECN4
from four normalized float
arguments.
This constructor initializes a new instance of XMXDECN4 from four
normalized float
arguments.
Syntax
void XMXDECN4(
float _x,
float _y,
float _z,
float _w
) noexcept;
Parameters
_x
A normalized value for the x-coordinate of the vector.
This argument should be between -1.0 and 1.0; during the instantiation of an
instance of XMXDECN4
, it is multiplied by 511.0f
and then
stored as the x member of the structure.
_y
A normalized value for the y-coordinate of the vector, the y of the
new instance of XMXDECN4
.
This argument should be between -1.0 and 1.0; during the instantiation of an
instance of XMXDECN4
, it is multiplied by 511.0f
and then
stored as the y member of the structure.
_z
A normalized value for the z-coordinate of the vector, the z of the
new instance of XMXDECN4
.
This argument should be between -1.0 and 1.0; during the instantiation of an
instance of XMXDECN4
, it is multiplied by 511.0f
and then
stored as the z member of the structure.
_w
A normalized value for the w-coordinate of the vector, the w of the
new instance of XMXDECN4
.
This argument should be between -1.0 and 1.0; during the instantiation of
an instance of XMCOLOR, it is multiplied by 3.0f
and then
stored as the w member of the structure.
Return value
None
Remarks
All input values,_x,_y, _z, and _w are clamped to a range of -1.0 to 1.0.
The following pseudocode demonstrates the operation of this constructor, which takes
advantage of the union
of the four components of the XMDECN4
vector with an instance of uint32_t
in the definition of the structure:
XMDECN4 instance;
_x1=min( max( _x, -1.0 ), 1.0 );
_y1=min( max( _y, -1.0 ), 1.0 );
_z1=min( max( _z, -1.0 ), 1.0 );
_w1=min( max( _w, 0.0 ), 1.0 );
_x1 = round( _x1 * 511.0f);
_y1 = round( _y1 * 511.0f);
_z1 = round( _z1 * 511.0f);
_w1 = round( _w1 * 3.0f);
instance.v = ( (int32_t)_w1 << 30) |
(((int32_t)_z1 & 0x3FF) << 20) |
(((int32_t)_y1 & 0x3FF) << 10) |
(((uint32_t)_x1 & 0x3FF));
Requirements
Requirement | Value |
---|---|
Target Platform | Windows |
Header | directxpackedvector.h |
See also
Reference