XMStoreShort4

Stores an XMVECTOR in an XMSHORT4.

Syntax

void XMStoreShort4(
         XMSHORT4 *pDestination,
         XMVECTOR V
)  

Parameters

pDestination
Type: XMSHORT4 *

[out]

Address at which to store the data.

V
Type: XMVECTOR 

[in]

Vector containing the data to store.

Return value

None.

Remarks

This function takes a vector, clamps it to the range -32767.0f to 32767.0f, converts the components into a signed, normalized integer format, and writes the results out to four short integer values at the given address. The most significant component is written to the first two bytes of the address, the next most significant component is written to the next two bytes of the address, and so on.

The following pseudocode demonstrates the operation of the function.

static const XMVECTOR  Min = {-32767.0f, -32767.0f, -32767.0f, -32767.0f};
static const XMVECTOR  Max = {32767.0f, 32767.0f, 32767.0f, 32767.0f};
XMVECTOR               N;
N = XMVectorClamp(V, Min, Max);
N = XMVectorRound(N);

pDestination->x = (int16_t)N.x; // 2 bytes to address pDestination
pDestination->y = (int16_t)N.y; // 2 bytes to address (uint8_t*)pDestination + 2
pDestination->z = (int16_t)N.z; // 2 bytes to address (uint8_t*)pDestination + 4
pDestination->w = (int16_t)N.w; // 2 bytes to address (uint8_t*)pDestination + 6  

Requirements

Header: Declared in directxpackedvector.h.