Article
11/17/2011

Matrix.CreateBillboard Method (Vector3%, Vector3%, Vector3%, Nullable<Vector3>, Matrix%)

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

Creates a spherical billboard that rotates around a specified object position.

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

Syntax

'Declaration
Public Shared Sub CreateBillboard ( _
    ByRef objectPosition As Vector3, _
    ByRef cameraPosition As Vector3, _
    ByRef cameraUpVector As Vector3, _
    cameraForwardVector As Nullable(Of Vector3), _
    <OutAttribute> ByRef result As Matrix _
)

public static void CreateBillboard(
    ref Vector3 objectPosition,
    ref Vector3 cameraPosition,
    ref Vector3 cameraUpVector,
    Nullable<Vector3> cameraForwardVector,
    out Matrix result
)

Parameters

objectPosition
Type: Microsoft.Xna.Framework.Vector3%
Position of the object the billboard will rotate around.

cameraPosition
Type: Microsoft.Xna.Framework.Vector3%
Position of the camera.

cameraUpVector
Type: Microsoft.Xna.Framework.Vector3%
The up vector of the camera.

cameraForwardVector
Type: System.Nullable<Vector3>
Optional forward vector of the camera.

result
Type: Microsoft.Xna.Framework.Matrix%
[OutAttribute] The created billboard matrix.

Remarks

This method computes the facing direction of the billboard from the object position and camera position. When the object and camera positions are too close, the matrix will not be accurate. To avoid this problem, the method uses the optional camera forward vector if the positions are too close.

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.

Share via