D3DXVec4BaryCentric-Funktion (D3DX10Math.h)

Gibt unter Verwendung der angegebenen 4D-Vektoren einen Punkt in Barycentric-Koordinaten zurück.

Syntax

D3DXVECTOR4* D3DXVec4BaryCentric(
  _In_       D3DXVECTOR4 *pOut,
  _In_ const D3DXVECTOR4 *pV1,
  _In_ const D3DXVECTOR4 *pV2,
  _In_ const D3DXVECTOR4 *pV3,
  _In_       FLOAT       f,
  _In_       FLOAT       g
);

Parameter

pOut [ In]

Typ: D3DXVECTOR4*

Zeiger auf D3DXVECTOR4, das das Ergebnis des Vorgangs ist.

pV1 [ In]

Typ: const D3DXVECTOR4 *

Zeiger auf eine D3DXVECTOR4-Quellstruktur.

pV2 [ In]

Typ: const D3DXVECTOR4 *

Zeiger auf eine D3DXVECTOR4-Quellstruktur.

pV3 [ In]

Typ: const D3DXVECTOR4 *

Zeiger auf eine D3DXVECTOR4-Quellstruktur.

f [ in]

Typ: FLOAT

Gewichtungsfaktor. Siehe Hinweise.

g [ in]

Typ: FLOAT

Gewichtungsfaktor. Siehe Hinweise.

Rückgabewert

Typ: D3DXVECTOR4*

Zeiger auf eine D3DXVECTOR4-Struktur in baryzentrischen Koordinaten.

Hinweise

Die D3DXVec4BaryCentric-Funktion bietet eine Möglichkeit, Punkte in und um ein Dreieck zu verstehen, unabhängig davon, wo sich das Dreieck tatsächlich befindet. Diese Funktion gibt den resultierenden Punkt mithilfe der folgenden Gleichung zurück: V1 + f(V2-V1) + g(V3-V1).

Jeder Punkt in der Ebene V1V2V3 kann durch die Barycentric-Koordinate (f,g) dargestellt werden. Der Parameter f steuert, wie viel V2 in das Ergebnis gewichtet wird, und der Parameter g steuert, wie viel V3 in das Ergebnis gewichtet wird. Schließlich steuert 1-f-g, wie viel V1 in das Ergebnis gewichtet wird.

Beachten Sie die folgenden Beziehungen.

  • Wenn (f>=0 &, & g>=0 &, & 1-f-g>=0), befindet sich der Punkt innerhalb des Dreiecks V1V2V3.
  • Wenn (f==0 &, & g>=0 &, & 1-f-g>=0), befindet sich der Punkt in der Zeile V1V3.
  • Wenn (f>=0 &, & g==0 &, & 1-f-g>=0), befindet sich der Punkt in der Zeile V1V2.
  • Wenn (f>=0 &, & g>=0 &, & 1-f-g==0), befindet sich der Punkt in der Zeile V2V3.

Barycentric-Koordinaten sind eine Form allgemeiner Koordinaten. In diesem Kontext stellt die Verwendung von Barycentric-Koordinaten eine Änderung der Koordinatensysteme dar. Was für kartesische Koordinaten gilt, gilt für baryzentrische Koordinaten.

Der Rückgabewert für diese Funktion ist der gleiche Wert, der im pOut-Parameter zurückgegeben wird. Auf diese Weise kann die D3DXVec4BaryCentric-Funktion als Parameter für eine andere Funktion verwendet werden.

Barycentric-Koordinaten definieren einen Punkt innerhalb eines Dreiecks in Bezug auf die Scheitelpunkte des Dreiecks. Eine ausführlichere Beschreibung der baryzentrischen Koordinaten finden Sie unter Mathworld es Barycentric Coordinates Description.

Anforderungen

Anforderung Wert
Header
D3DX10Math.h

Weitere Informationen

Mathematische Funktionen