Edit

Share via

XMDECN4::XMDECN4(constfloat*) function (directxpackedvector.h)

  • Article

Initializes a new instance of XMDECN4 from a four element float array argument.

This constructor initializes a new instance of XMDECN4 from a four element float array argument.

Note  This constructor is only available under C++.

Syntax

void XMDECN4(
  const float *pArray
) noexcept;

Parameters

pArray

Four element floating point array containing the values used to initialize the four components of a new instance of XMDECN4.

Return value

None

Remarks

Array elements are mapped to the vector components of a new instance of XMDECN4 as follows:

Vector Component Array Element Range Description
x pArray[0] -1.0, 1.0 During instantiation, pArray[0] is clamped between -1 and 1, multiplied by 511.0f and assigned to x.
y pArray[1] -1.0, 1.0 During instantiation, pArray[1] is clamped between -1 and 1, multiplied by 511.0f, and then assigned to y.
z pArray[2] -1.0, 1.0 During instantiation, pArray[2] is clamped between -1 and 1, multiplied by 511.0f, and then assigned to z.
w pArray[3] -1.0, 1.0 During instantiation, pArray[3] is clamped between -1 and 1, and then assigned to w. 
XMDECN4 instance;
_x1=min( max( pArray[0], -1.0 ), 1.0 );
_y1=min( max( pArray[1], -1.0 ), 1.0 );
_z1=min( max( pArray[2], -1.0 ), 1.0 );
_w1=min( max( pArray[3], -1.0 ), 1.0 );
_x1 = round( _x1 *  511.0f);
_y1 = round( _y1 *  511.0f);
_z1 = round( _z1 *  511.0f);

instance.v =  ( (int32_t)_w1 << 30) |
              (((int32_t)_z1 & 0x3FF) << 20) |
              (((int32_t)_y1 & 0x3FF) << 10) |
              (((int32_t)_x1 & 0x3FF));

Requirements

Requirement Value
Target Platform Windows
Header directxpackedvector.h

See also

XMDECN4

XMDECN4 Constructors