XMVectorInBoundsR-Funktion (directxmath.h)

Testet, ob sich die Komponenten eines bestimmten Vektors innerhalb bestimmter Grenzen befinden, und legt einen Vergleichswert fest, der mit Funktionen wie XMComparisonAllTrue untersucht werden kann.

Syntax

XMVECTOR XM_CALLCONV XMVectorInBoundsR(
  [out] uint32_t  *pCR,
  [in]  FXMVECTOR V,
  [in]  FXMVECTOR Bounds
) noexcept;

Parameter

[out] pCR

Zeiger auf einen uint32_t Vergleichswert, der mithilfe von Funktionen wie XMComparisonAllInBounds untersucht werden kann. Die XMComparisonXXXX Funktionen können verwendet werden, um die Anzahl der Komponenten, die den Vergleich bestanden haben, weiter zu testen.

[in] V

Zu testende Vektor.

[in] Bounds

Vektor, der die Grenzen bestimmt.

Rückgabewert

Gibt einen Vektor zurück, der die Ergebnisse der einzelnen Komponententests enthält.

Hinweise

Der folgende Pseudocode veranschaulicht den Vergleichsvorgang der Funktion:

XMVECTOR Control;

Control.x = (V.x <= Bounds.x && V.x >= -Bounds.x) ? 0xFFFFFFFF : 0;
Control.y = (V.y <= Bounds.y && V.y >= -Bounds.y) ? 0xFFFFFFFF : 0;
Control.z = (V.z <= Bounds.z && V.z >= -Bounds.z) ? 0xFFFFFFFF : 0;
Control.w = (V.w <= Bounds.w && V.w >= -Bounds.w) ? 0xFFFFFFFF : 0;

return Control;

Plattformanforderungen

Microsoft Visual Studio 2010 oder Microsoft Visual Studio 2012 mit dem Windows SDK für Windows 8. Unterstützt für Win32-Desktop-Apps, Windows Store-Apps und Windows Phone 8-Apps.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	directxmath.h (einschließlich DirectXMath.h)

Weitere Informationen

Geometrische Vektorfunktionen

XMVectorInBounds