XMLoadInt3A function (directxmath.h)

Article
02/22/2024

Loads 16-byte aligned data into the x, y, and z components of an XMVECTOR, without type checking.

Note This function is provided for backward compatibility with the Xbox Math library. You should use XMLoadInt3A when you load integer data, and XMLoadFloat3A when you load floating point data.

Syntax

XMVECTOR XM_CALLCONV XMLoadInt3A(
  [in] const uint32_t *pSource
) noexcept;

Parameters

[in] pSource

Address of the 16-byte aligned data to load.

Return value

Returns an XMVECTOR loaded with the data from the pSource parameter.

Remarks

The w component of the returned XMVECTOR is initialized to 0.

To convert the loaded XMVECTOR into float values, use XMConvertVectorUIntToFloat or XMConvertVectorIntToFloat.

The following pseudocode shows you the operation of the function.

XMVECTOR vectorOut;

uint32_t* pElement = (uint32_t*)pSource;

assert(((uint32_t_PTR)pSource & 0xF) == 0);

V.u[0] = pElement[0];
V.u[1] = pElement[1];
V.u[2] = pElement[2];
V.u[3] = 0;
	
return vectorOut;

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	directxmath.h

Share via