XMStoreUByte4 function (directxpackedvector.h)

Stores an XMVECTOR in an XMUBYTE4.

Syntax

void XM_CALLCONV XMStoreUByte4(
  [out] XMUBYTE4  *pDestination,
  [in]  FXMVECTOR V
) noexcept;

Parameters

[out] pDestination

Address at which to store the data.

[in] V

Vector containing the data to store.

Return value

None.

Remarks

The following pseudocode demonstrates the operation of the function.

XMVECTOR N;	
static const XMVECTOR  Max = {255.0f, 255.0f, 255.0f, 255.0f};

assert(pDestination);

N = XMVectorClamp(V, XMVectorZero(), Max);
N = XMVectorRound(N);

pDestination->x = (uint8_t)N.v[0];
pDestination->y = (uint8_t)N.v[1];
pDestination->z = (uint8_t)N.v[2];
pDestination->w = (uint8_t)N.v[3];

Platform Requirements

Microsoft Visual Studio 2010 or Microsoft Visual Studio 2012 with the Windows SDK for Windows 8. Supported for Win32 desktop apps, Windows Store apps, and Windows Phone 8 apps.

Requirements

Requirement Value
Target Platform Windows
Header directxpackedvector.h (include DirectXPackedVector.h)

See also

DirectXMath Library Vector Store Functions