Функция D3DXVec2BaryCentric (D3dx9math.h)

Примечание.

Библиотека служебной программы D3DX устарела. Вместо этого рекомендуется использовать DirectXMath .

Возвращает точку в координатах Barycentric, используя указанные 2D-векторы.

Синтаксис

D3DXVECTOR2* D3DXVec2BaryCentric(
  _Out_       D3DXVECTOR2 *pOut,
  _In_  const D3DXVECTOR2 *pV1,
  _In_  const D3DXVECTOR2 *pV2,
  _In_  const D3DXVECTOR2 *pV3,
  _In_        FLOAT       f,
  _In_        FLOAT       g
);

Параметры

pOut [out]

Тип: D3DXVECTOR2*

Указатель на структуру D3DXVECTOR2 , которая является результатом операции.

pV1 [in]

Тип: const D3DXVECTOR2*

Указатель на исходную D3DXVECTOR2 структуру.

pV2 [in]

Тип: const D3DXVECTOR2*

Указатель на исходную D3DXVECTOR2 структуру.

pV3 [in]

Тип: const D3DXVECTOR2*

Указатель на исходную D3DXVECTOR2 структуру.

f [in]

Тип: FLOAT

Коэффициент весового значения. См. заметки.

g [in]

Тип: FLOAT

Коэффициент весового значения. См. заметки.

Возвращаемое значение

Тип: D3DXVECTOR2*

Указатель на структуру D3DXVECTOR2 в координатах Barycentric.

Замечания

Функция D3DXVec2BaryCentric позволяет понять точки вокруг треугольника независимо от того, где находится треугольник. Эта функция возвращает результирующий момент с помощью следующего уравнения: V1 + f(V2-V1) + g(V3-V1).

Любая точка в плоскости V1V2V3 может быть представлена координатой Barycentric (f,g). Параметр f определяет, сколько V2 взвешивается в результат, и параметр g определяет, сколько V3 взвешивается в результат. Наконец, 1-f-g определяет, сколько V1 взвешивается в результат.

Обратите внимание на следующие отношения.

  • Если (f>=0 &, & g=0&, & 1-f-g>>=0), точка находится внутри треугольника V1V2V3.
  • Если (f==0 &, & g=0 &, & 1-f-g>>=0), точка находится в строке V1V3.
  • Если (f>=0 &, & g=0 &, & 1-f-g>=0), точка находится в строке V1V2.
  • Если (f>=0 &, & g=0&, & 1-f-g>==0), точка находится в строке V2V3.

Барицентрические координаты — это форма общих координат. В этом контексте использование координат Barycentric представляет собой изменение систем координат. То, что имеет значение true для координат Декартиана, имеет значение true для барицентрических координат.

Возвращаемое значение для этой функции совпадает со значением, возвращаемым в параметре pOut . Таким образом, функция D3DXVec2BaryCentric может использоваться в качестве параметра для другой функции.

Барицентрические координаты определяют точку внутри треугольника с точки зрения вершин треугольника. Более подробное описание барицентрических координат см. в описании барицентрических координат Mathworld в Barycentric. (Этот ресурс может быть недоступен на некоторых языках и странах.)

Requirements

Требование Значение
Верхний колонтитул
D3dx9math.h
Библиотека
D3dx9.lib

См. также

Математические функции