Matrix.CreateBillboard Method (Vector3, Vector3, Vector3, Nullable<Vector3>)
Creates a spherical billboard that rotates around a specified object position.
Syntax
'Declaration
Public Shared Function CreateBillboard ( _
objectPosition As Vector3, _
cameraPosition As Vector3, _
cameraUpVector As Vector3, _
cameraForwardVector As Nullable(Of Vector3) _
) As Matrix
public static Matrix CreateBillboard (
Vector3 objectPosition,
Vector3 cameraPosition,
Vector3 cameraUpVector,
Nullable<Vector3> cameraForwardVector
)
public:
static Matrix CreateBillboard(
Vector3 objectPosition,
Vector3 cameraPosition,
Vector3 cameraUpVector,
Nullable<Vector3> cameraForwardVector
)
Parameters
- objectPosition
Type: Vector3
Position of the object the billboard will rotate around. - cameraPosition
Type: Vector3
Position of the camera. - cameraUpVector
Type: Vector3
The up vector of the camera. - cameraForwardVector
Type: Nullable<Vector3>
Optional forward vector of the camera.
Return Value
Type: Matrix
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.
Requirements
Namespace: Microsoft.Xna.Framework
Assembly: Microsoft.Xna.Framework (in microsoft.xna.framework.dll)
See Also
Reference
Matrix Structure
Matrix Members
Microsoft.Xna.Framework Namespace
Platforms
Windows Phone