Matrix.PerspectiveRH(Single,Single,Single,Single) Method (Microsoft.DirectX)

  • Article

Builds a right-handed perspective projection matrix.

Definition

Visual Basic Public Shared Function PerspectiveRH( _
    ByVal width As Single, _
    ByVal height As Single, _
    ByVal znearPlane As Single, _
    ByVal zfarPlane As Single _
) As Matrix
C# public static Matrix PerspectiveRH(
    float width,
    float height,
    float znearPlane,
    float zfarPlane
);
C++ public:
static Matrix PerspectiveRH(
    float width,
    float height,
    float znearPlane,
    float zfarPlane
);
JScript public static function PerspectiveRH(
    width : float,
    height : float,
    znearPlane : float,
    zfarPlane : float
) : Matrix;

Parameters

width System.Single
Width of the view volume at the near view plane.
height System.Single
Height of the view volume at the near view plane.
znearPlane System.Single
Z-value of the near view plane.
zfarPlane System.Single
Z-value of the far view plane.

Return Value

Microsoft.DirectX.Matrix
Pointer to a Matrix structure that is a right-handed perspective projection matrix.

Remarks

All of the parameters of the PerspectiveRH method are distances in camera space. The parameters describe the dimensions of the view volume.

This method uses the following formula to compute the returned matrix.

2*znearPlane/width  0                    0                                            0
0                   2*znearPlane/height  0                                            0
0                   0                    zfarPlane/(znearPlane-zfarPlane)            -1
0                   0                    znearPlane*zfarPlane/(znearPlane-zfarPlane)  0

See Also