Функция 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.

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

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

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

Требования

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

См. также раздел

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