Function directx_math::XMVector3Project [−][src]
pub fn XMVector3Project(
V: FXMVECTOR,
ViewportX: f32,
ViewportY: f32,
ViewportWidth: f32,
ViewportHeight: f32,
ViewportMinZ: f32,
ViewportMaxZ: f32,
Projection: FXMMATRIX,
View: CXMMATRIX<'_>,
World: CXMMATRIX<'_>
) -> FXMVECTOR
Project a 3D vector from object space into screen space.
Parameters
V
3D vector in object space that will be projected into screen space.
ViewportX
Pixel coordinate of the upper-left corner of the viewport. Unless you want to render to a subset of
the surface, this parameter can be set to 0.
ViewportY
Pixel coordinate of the upper-left corner of the viewport on the render-target surface. Unless you want
to render to a subset of the surface, this parameter can be set to 0
.
ViewportWidth
Width dimension of the clip volume, in pixels. Unless you are rendering only to a subset of the surface,
this parameter should be set to the width dimension of the render-target surface.
ViewportHeight
Height dimension of the clip volume, in pixels. Unless you are rendering only to a subset of the surface,
this parameter should be set to the height dimension of the render-target surface.
ViewportMinZ
Together with ViewportMaxZ
, value describing the range of depth values into which a scene is to be
rendered, the minimum and maximum values of the clip volume. Most applications set this value to 0.0
.
Clipping is performed after applying the projection matrix.
ViewportMaxZ
Together with MinZ
, value describing the range of depth values into which a scene is to be rendered,
the minimum and maximum values of the clip volume. Most applications set this value to 1.0
. Clipping
is performed after applying the projection matrix.
Projection
Projection matrix.
View
View matrix.
World
World matrix.
Return value
Returns a vector in screen space.
Remarks
The ViewportX
, ViewportY
, ViewportWidth
, and ViewportHeight
parameters describe the position and dimensions
of the viewport on the render-target surface. Usually
, applications render to the entire target surface;
when rendering on a 640*480
surface, these parameters should be 0
, 0
, 640
, and 480
, respectively. The
ViewportMinZ
and ViewportMaxZ
are typically set to 0.0
and 1.0
but can be set to other values to achieve
specific effects.
Reference
https://docs.microsoft.com/en-us/windows/win32/api/directxmath/nf-directxmath-XMVector3Project