D3DXMatrixOrthoOffCenterLH

Builds a customized, left-handed orthogonal projection matrix.

D3DXMatrixOrthoOffCenterLH( _ 
    MOut As D3DMATRIX, _ 
    l As Single, _ 
    r As Single, _ 
    b As Single, _ 
    t As Single, _ 
    zn As Single, _ 
    zf As Single)

Parameters

MOut

D3DMATRIX type that is the result of the operation, a customized, left-handed orthogonal projection matrix.

l

Minimum x-value of view-volume.

r

Maximum x-value of view-volume.

b

Maximum y-value of view-volume.

t

Minimum y-value of view-volume.

zn

Minimum z-value of the view volume.

zf

Maximum z-value of the view volume.

Error Codes

If the function fails, an error is raised and Err.Number can be set to one of the following values.

For information on trapping errors, see the Microsoft® Visual Basic® Error Handling topic.

Remarks

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

The D3DXMatrixOrthoLH function is a special case of the D3DXMatrixOrthoOffCenterLH function. To create the same projection using D3DXMatrixOrthoOffCenterLH, use the following values: l = -w/2, r = w/2, b = -h/2, and t = h/2.

All the parameters of the D3DXMatrixOrthoOffCenterLH function are distances in camera-space. The parameters describe the dimensions of the view-volume.

See Also

D3DXMatrixOrthoRH, D3DXMatrixOrthoLH, D3DXMatrixOrthoOffCenterRH