Microsoft DirectX 8.1 (Visual Basic)

D3DXMatrixOrthoRH

Builds a right-handed orthogonal projection matrix.

D3DXMatrixOrthoRH( _ 
    MOut As D3DMATRIX, _ 
    w As Single, _ 
    h As Single, _ 
    zn As Single, _ 
    zf As Single)

Parameters

MOut
D3DMATRIX type that is the result of the operation, a right-handed orthogonal projection matrix.
w
Width of the view-volume.
h
Height of the 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.

D3DERR_INVALIDCALL
D3DERR_OUTOFVIDEOMEMORY

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.

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

See Also

D3DXMatrixOrthoLH, D3DXMatrixOrthoOffCenterRH, D3DXMatrixOrthoOffCenterLH