TiltFive.GameBoard Class Reference

Represents the game board. More...

Inheritance diagram for TiltFive.GameBoard:

Classes
struct	GameboardDimensions
struct	GameboardExtents
	Represents the distances from the gameboard tracking origin to the borders of the gameboard's viewable area. More...

Public Types
enum	Edge { Near , Far , Left , Right }
	Represents cardinal positions around the gameboard (i.e. the centers of the edges of the gameboard), relative to a user positioned at the near (default) edge. More...
enum	Corner { FarLeft , FarRight , NearLeft , NearRight }
	Represents ordinal positions around the gameboard, relative to a user positioned at the near (default) edge. More...

Public Member Functions
bool	TransformPose (Vector3 positionInGameboardSpace, Quaternion rotationToGameboardSpace, PlayerIndex playerIndex, out Vector3 positionInWorldSpace, out Quaternion rotationToWorldSpace)
	Transforms the provided pose from gameboard space to world space.
bool	TransformPose (Pose poseInGameboardSpace, PlayerIndex playerIndex, out Pose poseInWorldSpace)
	Transforms the provided pose from gameboard space to world space.
bool	TransformPoint (Vector3 pointInGameboardSpace, PlayerIndex playerIndex, out Vector3 pointInWorldSpace)
	Transforms the provided position from gameboard space to world space.
bool	InverseTransformPose (Vector3 positionInWorldSpace, Quaternion rotationToWorldSpace, PlayerIndex playerIndex, out Vector3 positionInGameboardSpace, out Quaternion rotationToGameboardSpace)
	Transforms the provided pose from world space to gameboard space.
bool	InverseTransformPose (Pose poseInWorldSpace, PlayerIndex playerIndex, out Pose poseInGameboardSpace)
	Transforms the provided pose from world space to gameboard space.
bool	InverseTransformPoint (Vector3 pointInWorldSpace, PlayerIndex playerIndex, out Vector3 pointInGameboardSpace)
	Transforms the provided position from world space to gameboard space.
Public Member Functions inherited from TiltFive.UniformScaleTransform
void	Awake ()

Static Public Member Functions
static bool	TryGetGameboardType (out GameboardType gameboardType)
	Attempts to check the latest glasses pose for the current gameboard type, such as LE, XE, or none.
static bool	TryGetGameboardType (PlayerIndex playerIndex, out GameboardType gameboardType)
static bool	TryGetGameboardDimensions (GameboardType gameboardType, out GameboardDimensions gameboardDimensions)
	Attempts to obtain the physical dimensions for a particular gameboard type.
static bool	TryGetGameboardExtents (GameboardType gameboardType, out GameboardExtents gameboardExtents)
	Attempts to obtain the physical dimensions for a particular gameboard type.

Public Attributes
bool	ShowGizmo
	Shows the game board gizmo in the editor.
bool	ShowGrid
float	GridHeightOffset = 0f
bool	StickyHeightOffset = true
float	GizmoOpacity = 0.75f
	Sets the opacity of the game board gizmo in the editor.
GameboardType	GameboardType
	The gameboard configuration, such as LE, XE, or folded XE.

Additional Inherited Members
Protected Member Functions inherited from TiltFive.UniformScaleTransform
void	UnifyScale ()
	Synchronizes the component values of the game object's local scale vector (e.g. [1,2,3] becomes [3,3,3]).
Properties inherited from TiltFive.UniformScaleTransform
float	localScale [get, set]
	The size of the object as a single float value, rather than a scale vector.
Vector3	position [get, set]
	The position vector for the associated transform.
Quaternion	rotation [get, set]
	The rotation vector for the associated transform.

Detailed Description

Represents the game board.

Member Enumeration Documentation

Corner

enum TiltFive.GameBoard.Corner

Represents ordinal positions around the gameboard, relative to a user positioned at the near (default) edge.

Enumerator
FarLeft
FarRight
NearLeft
NearRight

Edge

enum TiltFive.GameBoard.Edge

Represents cardinal positions around the gameboard (i.e. the centers of the edges of the gameboard), relative to a user positioned at the near (default) edge.

Enumerator
Near	The near edge of the gameboard. This is the side of the gameboard with the T5 logo.
Far	The far edge of the gameboard. This edge is positioned opposite the near edge.
Left	The left edge of the gameboard. From the perspective of a user sitting at the near edge of the gameboard, this edge is to their left.
Right	The right edge of the gameboard. From the perspective of a user sitting at the near edge of the gameboard, this edge is to their right.

Member Function Documentation

InverseTransformPoint()

bool TiltFive.GameBoard.InverseTransformPoint	(	Vector3	pointInWorldSpace,
		PlayerIndex	playerIndex,
		out Vector3	pointInGameboardSpace )

Transforms the provided position from world space to gameboard space.

Parameters

pointInWorldSpace	A position in Unity world space.
playerIndex	The player whose content scale settings should be considered while converting between spaces. This is necessary because multiple players with differing scale settings may share the same gameboard.
pointInGameboardSpace	The resulting point in gameboard space.

Returns

Returns false and sets pointInGameboardSpace to Vector3.zero if the function failed while calculating the transformed point; returns true otherwise. This function can fail if playerIndex is invalid.

InverseTransformPose() [1/2]

bool TiltFive.GameBoard.InverseTransformPose	(	Pose	poseInWorldSpace,
		PlayerIndex	playerIndex,
		out Pose	poseInGameboardSpace )

Transforms the provided pose from world space to gameboard space.

Parameters

poseInWorldSpace	A position and orientation in Unity world space.
playerIndex	The player whose content scale settings should be considered while converting between spaces. This is necessary because multiple players with differing scale settings may share the same gameboard.
poseInGameboardSpace	The resulting position and orientation in gameboard space.

Returns

Returns false and sets poseInGameboardSpace to an empty pose if the function failed while calculating the transformed pose; returns true otherwise. This function can fail if playerIndex is invalid.

InverseTransformPose() [2/2]

bool TiltFive.GameBoard.InverseTransformPose	(	Vector3	positionInWorldSpace,
		Quaternion	rotationToWorldSpace,
		PlayerIndex	playerIndex,
		out Vector3	positionInGameboardSpace,
		out Quaternion	rotationToGameboardSpace )

Transforms the provided pose from world space to gameboard space.

Parameters

positionInWorldSpace	A position in Unity world space.
rotationToWorldSpace	An orientation in Unity world space.
playerIndex	The player whose content scale settings should be considered while converting between spaces. This is necessary because multiple players with differing scale settings may share the same gameboard.
positionInGameboardSpace	The resulting position in gameboard space.
rotationToGameboardSpace	The resulting orientation in gameboard space.

Returns

Returns false and sets positionInGameboardSpace and rotationToGameboardSpace to default values if the function failed while calculating the transformed pose; returns true otherwise. This function can fail if playerIndex is invalid.

TransformPoint()

bool TiltFive.GameBoard.TransformPoint	(	Vector3	pointInGameboardSpace,
		PlayerIndex	playerIndex,
		out Vector3	pointInWorldSpace )

Transforms the provided position from gameboard space to world space.

Parameters

pointInGameboardSpace	A point in gameboard space.
playerIndex	The player whose content scale settings should be considered while converting between spaces. This is necessary because multiple players with differing scale settings may share the same gameboard.
pointInWorldSpace	The resulting point in Unity world space.

Returns

Returns false and sets pointInWorldSpace to Vector3.zero if the function failed while calculating the transformed point; returns true otherwise. This function can fail if playerIndex is invalid.

TransformPose() [1/2]

bool TiltFive.GameBoard.TransformPose	(	Pose	poseInGameboardSpace,
		PlayerIndex	playerIndex,
		out Pose	poseInWorldSpace )

Transforms the provided pose from gameboard space to world space.

Parameters

poseInGameboardSpace	A position and orientation in gameboard space.
playerIndex	The player whose content scale settings should be considered while converting between spaces. This is necessary because multiple players with differing scale settings may share the same gameboard.
poseInWorldSpace	The resulting position and orientation in Unity world space.

Returns

Returns false and sets poseInWorldSpace to an empty pose if the function failed while calculating the transformed pose; returns true otherwise. This function can fail if playerIndex is invalid.

TransformPose() [2/2]

bool TiltFive.GameBoard.TransformPose	(	Vector3	positionInGameboardSpace,
		Quaternion	rotationToGameboardSpace,
		PlayerIndex	playerIndex,
		out Vector3	positionInWorldSpace,
		out Quaternion	rotationToWorldSpace )

Transforms the provided pose from gameboard space to world space.

Parameters

positionInGameboardSpace	A position in gameboard space.
rotationToGameboardSpace	An orientation in gameboard space.
playerIndex	The player whose content scale settings should be considered while converting between spaces. This is necessary because multiple players with differing scale settings may share the same gameboard.
positionInWorldSpace	The resulting position in Unity world space.
rotationToWorldSpace	The resulting orientation in Unity world space.

Returns

Returns false and sets positionInGameboardSpace and rotationToWorldSpace to default values if the function failed while calculating the transformed pose; returns true otherwise. This function can fail if playerIndex is invalid.

TryGetGameboardDimensions()

bool TiltFive.GameBoard.TryGetGameboardDimensions ( GameboardType gameboardType, out GameboardDimensions gameboardDimensions )

static

Attempts to obtain the physical dimensions for a particular gameboard type.

Parameters

gameboardType
gameboardDimensions

Returns

Returns dimensions for GameboardType.GameboardType_LE if it fails.

TryGetGameboardExtents()

bool TiltFive.GameBoard.TryGetGameboardExtents ( GameboardType gameboardType, out GameboardExtents gameboardExtents )

static

Attempts to obtain the physical dimensions for a particular gameboard type.

Parameters

gameboardType
gameboardExtents

Returns

Returns true on successful gameboard extents retrieval, and false otherwise. Use this return value to determine whether gameboardExtents is valid.

TryGetGameboardType() [1/2]

bool TiltFive.GameBoard.TryGetGameboardType ( out GameboardType gameboardType )

static

Attempts to check the latest glasses pose for the current gameboard type, such as LE, XE, or none.

Parameters

gameboardType

Output gameboard type. Contains GameboardType.GameboardType_None if no pose was provided, which can happen if the user looks away and the head tracking camera loses sight of the gameboard.

Returns

Returns true on successful pose retrieval, false otherwise.

TryGetGameboardType() [2/2]

bool TiltFive.GameBoard.TryGetGameboardType ( PlayerIndex playerIndex, out GameboardType gameboardType )

static

Member Data Documentation

GameboardType

GameboardType TiltFive.GameBoard.GameboardType

The gameboard configuration, such as LE, XE, or folded XE.

GizmoOpacity

float TiltFive.GameBoard.GizmoOpacity = 0.75f

Sets the opacity of the game board gizmo in the editor.

GridHeightOffset

float TiltFive.GameBoard.GridHeightOffset = 0f

ShowGizmo

bool TiltFive.GameBoard.ShowGizmo

Shows the game board gizmo in the editor.

ShowGrid

bool TiltFive.GameBoard.ShowGrid

StickyHeightOffset

bool TiltFive.GameBoard.StickyHeightOffset = true