Matrix.OrthoLH Method

Article
10/19/2012

Builds a left-handed orthogonal projection matrix.

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

Syntax

'Declaration
Public Shared Function OrthoLH ( _
    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.OrthoLH(width, _
    height, znearPlane, zfarPlane)

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

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

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

Parameters

width
Type: System.Single

Width of the view volume.

height
Type: System.Single

Height of the view volume.

znearPlane
Type: System.Single

Minimum z-value of the view volume, which is referred to as z-near.

zfarPlane
Type: System.Single

Maximum z-value of the view volume, which is referred to as z-far.

Return Value

Type: Microsoft.WindowsMobile.DirectX.Matrix
A Matrix structure that is a left-handed orthogonal projection matrix.

Remarks

An orthogonal matrix is an invertible matrix for which the inverse is equal to the transpose.

All of the parameters of the OrthoLH 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/width    0         0                                  0
0          2/height  0                                  0
0          0         1/(zfarPlane-znearPlane)           0
0          0         znearPlane/(znearPlane-zfarPlane)  1

.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