Matrix.CreatePerspective Method (Single, Single, Single, Single)
Builds a perspective projection matrix and returns the result by value.
Namespace: Microsoft.Xna.Framework
Assembly: Microsoft.Xna.Framework (in microsoft.xna.framework.dll)
Syntax
public static Matrix CreatePerspective (
float width,
float height,
float nearPlaneDistance,
float farPlaneDistance
)
Parameters
- width
Type: Single
Width of the view volume at the near view plane. - height
Type: Single
Height of the view volume at the near view plane. - nearPlaneDistance
Type: Single
Distance to the near view plane. - farPlaneDistance
Type: Single
Distance to the far view plane.
Return Value
The projection matrix.
Exceptions
Exception type | Condition |
---|---|
ArgumentOutOfRangeException | One of the following conditions is true:
|
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 a z-coordinate ranging from 0 to 1.
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.
See Also
Reference
Matrix Structure
Matrix Members
Microsoft.Xna.Framework Namespace
Platforms
Xbox 360, Windows 7, Windows Vista, Windows XP, Windows Phone