XMVectorSetByIndex
Use a floating-point object to set the value of one of the four components of an XMVECTOR Data Type containing integer data referenced by an index.
Syntax
XMVECTOR XMVectorSetByIndex(
XMVECTOR V,
FLOAT f,
UINT i
)
Parameters
- V
A XMVECTOR Data Type containing integer data. - f
The floating point value used to set the i component of the returned XMVECTOR Data Type. - i
The index of the component to be retrieved.
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 ). If not an XMASSERT will be triggered.
The indexes have the following correspondence with XMVECTOR Data Type vector components:
| Index | Component |
|---|---|
0 |
x |
1 |
y |
2 |
z |
3 |
w |
Note
XMVectorSetByIndexPtr is preferred when targeting the Xbox 360 for storing arbitrary vector elements to memory, since XMVectorSetByIndex may force a Load/Hit/Store event in this situation which degrades performance.
Requirements
Header: Declared in xnamath.h.