Matrix.PerspectiveRH Method

Article
10/19/2012

Builds a right-handed perspective projection matrix.

Namespace: Microsoft.WindowsMobile.DirectX
Assembly: Microsoft.WindowsMobile.DirectX (in Microsoft.WindowsMobile.DirectX.dll)

Syntax

'Declaration
Public Shared Function PerspectiveRH ( _
    width As Single, _
    height As Single, _
    znearPlane As Single, _
    zfarPlane As Single _
) As Matrix
'Usage
Dim width As Single 
Dim height As Single 
Dim znearPlane As Single 
Dim zfarPlane As Single 
Dim returnValue As Matrix 

returnValue = Matrix.PerspectiveRH(width, _
    height, znearPlane, zfarPlane)

public static Matrix PerspectiveRH(
    float width,
    float height,
    float znearPlane,
    float zfarPlane
)

public:
static Matrix PerspectiveRH(
    float width, 
    float height, 
    float znearPlane, 
    float zfarPlane
)

public static function PerspectiveRH(
    width : float, 
    height : float, 
    znearPlane : float, 
    zfarPlane : float
) : Matrix

Parameters

width
Type: System.Single

Width of the view volume at the near view plane.

height
Type: System.Single

Height of the view volume at the near view plane.

znearPlane
Type: System.Single

Z-value of the near view plane.

zfarPlane
Type: System.Single

Z-value of the far view plane.

Return Value

Type: Microsoft.WindowsMobile.DirectX.Matrix
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

.NET Framework Security

Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

Platforms

Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Compact Framework

Supported in: 3.5, 2.0

Share via