Função XMVector3Normalize (directxmath.h)

Retorna a versão normalizada de um vetor 3D.

Sintaxe

XMVECTOR XM_CALLCONV XMVector3Normalize(
  [in] FXMVECTOR V
) noexcept;

Parâmetros

[in] V

Vetor 3D.

Valor retornado

Retorna a versão normalizada do V.

Comentários

Para um vetor de comprimento 0, essa função retorna um vetor zero. Para um vetor com comprimento infinito, ele retorna um vetor de QNaN.

Observe que, para a maioria dos aplicativos gráficos, garantir que os vetores tenham comprimentos bem definidos que não causem problemas de normalização é uma prática comum. No entanto, se você precisar de uma normalização robusta que funcione para todas as entradas de ponto flutuante, poderá usar o seguinte código em vez disso:

inline XMVECTOR XMVector3NormalizeRobust( FXMVECTOR V )
{
    // Compute the maximum absolute value component.
    XMVECTOR vAbs = XMVectorAbs(V);
    XMVECTOR max0 = XMVectorSplatX(vAbs);
    XMVECTOR max1 = XMVectorSplatY(vAbs);
    XMVECTOR max2 = XMVectorSplatZ(vAbs);
    max0 = XMVectorMax(max0, max1);
    max0 = XMVectorMax(max0, max2);

    // Divide by the maximum absolute component.
    XMVECTOR normalized = XMVectorDivide(V, max0);

    // Set to zero when the original length is zero.
    XMVECTOR mask = XMVectorNotEqual(g_XMZero, max0);
    normalized = XMVectorAndInt(normalized, mask);

    XMVECTOR t0 = XMVector3LengthSq(normalized);
    XMVECTOR length = XMVectorSqrt(t0);

    // Divide by the length to normalize.
    normalized = XMVectorDivide(normalized, length);

    // Set to zero when the original length is zero or infinity.  In the
    // latter case, this is considered to be an unexpected condition.
    normalized = XMVectorAndInt(normalized, mask);
    return normalized;
}
    

Requisitos da plataforma

Microsoft Visual Studio 2010 ou Microsoft Visual Studio 2012 com o SDK do Windows para Windows 8. Com suporte para aplicativos da área de trabalho Win32, aplicativos da Windows Store e aplicativos Windows Phone 8.

Requisitos

Plataforma de Destino	Windows
Cabeçalho	directxmath.h (inclua DirectXMath.h)

Confira também

Funções geométricas de vetor 3D da Biblioteca DirectXMath

XMVector3NormalizeEst