Функция XMVector3Unproject (directxmath.h)

Статья
08/23/2023

Проецируют трехмерный вектор из экранного пространства в пространство объектов.

Синтаксис

XMVECTOR XM_CALLCONV XMVector3Unproject(
  [in] FXMVECTOR V,
  [in] float     ViewportX,
  [in] float     ViewportY,
  [in] float     ViewportWidth,
  [in] float     ViewportHeight,
  [in] float     ViewportMinZ,
  [in] float     ViewportMaxZ,
  [in] FXMMATRIX Projection,
  [in] CXMMATRIX View,
  [in] CXMMATRIX World
) noexcept;

Параметры

[in] V

Трехмерный вектор в пространстве экрана, который будет проецироваться в пространство объектов. X и Y находятся в пикселях, а Z — от 0,0 (в ViewportMinZ) до 1,0 (в ViewportMaxZ).

[in] ViewportX

Пиксельная координата левого верхнего угла окна просмотра. Если вы не хотите выполнять отрисовку в подмножестве поверхности, для этого параметра можно задать значение 0.

[in] ViewportY

Пиксельная координата верхнего левого угла окна просмотра на поверхности целевой отрисовки. Если вы не хотите выполнять отрисовку в подмножестве поверхности, для этого параметра можно задать значение 0.

[in] ViewportWidth

Ширина тома клипа в пикселях. Если вы не выполняете отрисовку только в подмножестве поверхности, для этого параметра следует задать измерение ширины целевой поверхности отрисовки.

[in] ViewportHeight

Размер высоты тома клипа в пикселях. Если отрисовка выполняется только в подмножестве поверхности, для этого параметра следует задать измерение высоты целевой поверхности отрисовки.

[in] ViewportMinZ

Вместе с ViewportMaxZ, значение, описывающее диапазон значений глубины, в котором должна быть отрисовка сцены, минимальное и максимальное значения тома клипа. В большинстве приложений это значение равно 0,0f. Обрезка выполняется после применения матрицы проекции.

[in] ViewportMaxZ

Вместе с MinZ значение, описывающее диапазон значений глубины, в котором должна быть отрисовка сцены, минимальное и максимальное значения тома клипа. Большинство приложений устанавливают для этого значения значение 1.0f. Обрезка выполняется после применения матрицы проекции.

[in] Projection

Матрица проекции.

[in] View

Матрица просмотра.

[in] World

Мировая матрица.

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

Возвращает вектор в пространстве объектов.

Параметры ViewportX, ViewportY, ViewportWidth и ViewportHeight описывают положение и размеры окна просмотра на поверхности цели отрисовки. Как правило, приложения отрисовывается на всей целевой поверхности; при отрисовке на поверхности 640*480 эти параметры должны иметь значение 0, 0, 640 и 480 соответственно. Для ViewportMinZ и ViewportMaxZ обычно заданы значения 0,0f и 1,0f, но для достижения определенных результатов их можно задать и другие значения.

Требования к платформе

Microsoft Visual Studio 2010 или Microsoft Visual Studio 2012 с windows SDK для Windows 8. Поддерживается для классических приложений Win32, приложений Магазина Windows и Windows Phone 8 приложений.

Требования

Требование	Значение
Целевая платформа	Windows
Header	directxmath.h (включая DirectXMath.h)

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

Функции преобразования 3D-векторов библиотеки DirectXMath

XMVector3UnprojectStream

Поделиться через