PerspectiveProjection Class

Defines a perspective projection.

Inheritance Hierarchy

SystemObject
DigitalRune.GraphicsProjection
DigitalRune.GraphicsPerspectiveProjection

Namespace: DigitalRune.Graphics
Assembly: DigitalRune.Graphics (in DigitalRune.Graphics.dll) Version: 1.2.0.0 (1.2.1.14562)

Syntax

C++

Copy

public class PerspectiveProjection : Projection

Public Class PerspectiveProjection
	Inherits Projection

public ref class PerspectiveProjection : public Projection

type PerspectiveProjection =  
    class
        inherit Projection
    end

The PerspectiveProjection type exposes the following members.

Constructors

	Name	Description
	PerspectiveProjection	Initializes a new instance of the PerspectiveProjection class.

Top

Methods

	Name	Description
	Clone	Creates a new Projection that is a clone (deep copy) of the current instance. (Inherited from Projection.)
	CloneCore	Makes the instance a clone (deep copy) of the specified Projection. (Overrides ProjectionCloneCore(Projection).)
	ComputeProjection	Computes the projection matrix. (Overrides ProjectionComputeProjection.)
	CreateInstanceCore	When implemented in a derived class, creates a new instance of the Projection derived class. (Overrides ProjectionCreateInstanceCore.)
	Equals	Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
	Finalize	Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
	FromMatrix	Creates an perspective projection from a 4x4 transformation matrix.
	GetHashCode	Serves as a hash function for a particular type. (Inherited from Object.)
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	Invalidate	Invalidates the projection matrix. (Inherited from Projection.)
	MemberwiseClone	Creates a shallow copy of the current Object. (Inherited from Object.)
	Set(Matrix44F)	Sets the perspective projection from the given projection matrix. (Overrides ProjectionSet(Matrix44F).)
	Set(Single, Single)	Sets a symmetric, perspective projection based on size.
	Set(Single, Single, Single, Single)	Sets a symmetric, perspective projection based on size and depth.
	SetFieldOfView(Single, Single)	Sets a symmetric, perspective projection based on field of view.
	SetFieldOfView(Single, Single, Single, Single)	Sets a symmetric, perspective projection based on field of view and depth.
	SetOffCenter(Single, Single, Single, Single)	Sets an asymmetric (off-center), perspective projection based on the given values.
	SetOffCenter(Single, Single, Single, Single, Single, Single)	Sets an asymmetric (off-center), perspective projection based on the given values (including depth).
	ToMatrix44F	Converts a projection to a 4x4 transformation matrix. (Inherited from Projection.)
	ToString	Returns a string that represents the current object. (Inherited from Object.)
	ToXna	Converts a projection to a 4x4 transformation matrix (XNA Framework). (Only available in the XNA-compatible build.) (Inherited from Projection.)

Top

Operators

	Name	Description
	(Matrix44F to PerspectiveProjection)	Converts a 4x4 projection matrix to a perspective projection.

Top

Properties

	Name	Description
	AspectRatio	Gets the aspect ratio (width / height) of the view. (Inherited from Projection.)
	Bottom	Gets or sets the minimum y-value of the view volume at the near view-plane. (Inherited from Projection.)
	Depth	Gets the depth of the view volume (Far - Near). (Inherited from Projection.)
	Far	Gets or sets the distance to the far view plane. (Inherited from Projection.)
	FieldOfViewX	Gets the horizontal field of view in radians. (Inherited from Projection.)
	FieldOfViewY	Gets the vertical field of view in radians. (Inherited from Projection.)
	Height	Gets the height of the view volume at the near view plane. (Inherited from Projection.)
	Inverse	Gets the inverse of the projection matrix. (Inherited from Projection.)
	Left	Gets or sets the minimum x-value of the view volume at the near view-plane. (Inherited from Projection.)
	Near	Gets or sets the distance to the near view plane. (Inherited from Projection.)
	NearClipPlane	Gets or sets the near clip plane in view space.
	Right	Gets or sets the maximum x-value of the view volume at the near view-plane. (Inherited from Projection.)
	Top	Gets or sets the maximum y-value of the view volume at the near view-plane. (Inherited from Projection.)
	ViewVolume	Gets (or sets) the shape of the view volume (viewing frustum). (Inherited from Projection.)
	Width	Gets the width of the view volume at the near view plane. (Inherited from Projection.)

Top

Remarks

The perspective projection can be set in several ways:

By setting the properties Left, Right, Bottom, Top, Near, and Far.
By setting assigning a projection matrix using Set(Matrix44F) or the property Inverse.
By calling on of the following methods: Set(Single, Single), Set(Single, Single, Single, Single), Set(Matrix44F), SetFieldOfView(Single, Single), SetFieldOfView(Single, Single, Single, Single), SetOffCenter(Single, Single, Single, Single), SetOffCenter(Single, Single, Single, Single, Single, Single),

The property ViewVolume defines the bounding shape of the projection which can be used for frustum culling. The shape is updated automatically when the properties of the projection change.

This class supports near plane clipping for portal and reflection rendering, see NearClipPlane.

Reference

DigitalRune.Graphics Namespace

DigitalRune.GraphicsProjection