Matrix44D.CreateLookAt Method

Matrix44DCreateLookAt Method

Creates a right-handed look-at matrix (view matrix). (Only available in the XNA-compatible build.)

Namespace: DigitalRune.Mathematics.Algebra
Assembly: DigitalRune.Mathematics (in DigitalRune.Mathematics.dll) Version: 1.14.0.0 (1.14.0.14427)

Syntax

C++

Copy

public static Matrix44D CreateLookAt(
	Vector3D position,
	Vector3D target,
	Vector3D upVector
)

Public Shared Function CreateLookAt ( 
	position As Vector3D,
	target As Vector3D,
	upVector As Vector3D
) As Matrix44D

public:
static Matrix44D CreateLookAt(
	Vector3D position, 
	Vector3D target, 
	Vector3D upVector
)

static member CreateLookAt : 
        position : Vector3D * 
        target : Vector3D * 
        upVector : Vector3D -> Matrix44D

Parameters

position: Type: DigitalRune.Mathematics.AlgebraVector3D
The position of the viewer.
target: Type: DigitalRune.Mathematics.AlgebraVector3D
The target at which the viewer is looking.
upVector: Type: DigitalRune.Mathematics.AlgebraVector3D
The direction that is "up" from the viewer's point of view. (Does not need to be normalized.)

Return Value

Type: Matrix44D
The right-handed look-at matrix (view matrix).

Exceptions

Exception	Condition
ArgumentException	position is the same as target.
ArgumentException	upVector is (0, 0, 0).
DivideByZeroException	The camera direction (target - position) is probably pointing in the same or opposite direction as upVector. (The two vectors must not be parallel.)

Remarks

This method is available only in the XNA-compatible build of the DigitalRune.Mathematics.dll.

A look-at matrix is also known as view matrix. It transforms a position from world space to the view space. In view space x-axis points to the right, the y-axis points up, and the z-axis points towards the viewer.

Reference

Matrix44D Structure

DigitalRune.Mathematics.Algebra Namespace