Matrix.CreateOrthographicOffCenter Method (Single, Single, Single, Single, Single, Single)

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Builds a customized, orthogonal projection matrix.

Namespace:  Microsoft.Xna.Framework
Assembly:  Microsoft.Xna.Framework.Math (in Microsoft.Xna.Framework.Math.dll)

Syntax

'Declaration
Public Shared Function CreateOrthographicOffCenter ( _
    left As Single, _
    right As Single, _
    bottom As Single, _
    top As Single, _
    zNearPlane As Single, _
    zFarPlane As Single _
) As Matrix
public static Matrix CreateOrthographicOffCenter(
    float left,
    float right,
    float bottom,
    float top,
    float zNearPlane,
    float zFarPlane
)

Parameters

  • zNearPlane
    Type: System.Single
    Minimum z-value of the view volume.
  • zFarPlane
    Type: System.Single
    Maximum z-value of the view volume.

Return Value

Type: Microsoft.Xna.Framework.Matrix
The projection matrix.

Remarks

Projection space refers to the space after applying projection transformation from view space. After the projection transformation, visible content has x and y coordinates ranging from -1 to 1, and z coordinates ranging from 0 to 1.

Unlike perspective projection, in orthographic projection there is no perspective foreshortening.

The viewable area of this orthographic projection extends from left to right on the x-axis, bottom to top on the y-axis, and zNearPlane to zFarPlane on the z-axis. These values are relative to the position and x, y, and z-axes of the view.

To obtain the viewable area (in world space) of a scene, create a BoundingFrustum and pass the combined view and projection matrix to the constructor.

Version Information

Silverlight

Supported in: 5

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.