XMVectorSetByIndexPtr function (directxmath.h)

Article
02/22/2024

Use a pointer to a floating-point instance to set the value of one of the four components of an XMVECTOR Data Type containing floating-point data referenced by an index.

Syntax

XMVECTOR XM_CALLCONV XMVectorSetByIndexPtr(
       FXMVECTOR   V,
  [in] const float *f,
       size_t      i
) noexcept;

Parameters

V

A XMVECTOR Data Type containing floating-point data.

[in] f

A pointer to a floating-point instance used to set the i component of the returned XMVECTOR Data Type.

i

The index of the component to be set.

Return value

An instance of XMVECTOR Data Type whose i component has been set to the floating-point value provided by the argument f. All other components of the returned XMVECTOR Data Type instance have the same value as those of the input vector V.

Remarks

The value of i must be positive and less than or equal to three ( 0 <= i <= 3 ).

The indexes have the following correspondence with XMVECTOR Data Type vector components:

Index	Component
`0`	`x`
`1`	`y`
`2`	`z`
`3`	`w`

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 (include DirectXMath.h)

Share via