The Wand API and runtime. More...

Inheritance diagram for TiltFive.Wand:

Classes
class	WaitUntilWandConnected
	Suspends coroutine execution until the provided player's wand has connected. More...

class	WandCore
	Internal Wand core runtime. More...

struct	WandPair

Static Public Member Functions
static Vector3	GetPosition (ControllerIndex controllerIndex=ControllerIndex.Right, ControllerPosition controllerPosition=ControllerPosition.Grip, PlayerIndex playerIndex=PlayerIndex.One)
	Gets the position of the wand in world space. More...

static Quaternion	GetRotation (ControllerIndex controllerIndex=ControllerIndex.Right, PlayerIndex playerIndex=PlayerIndex.One)
	Gets the rotation of the wand in world space. More...

static bool	IsTracked (ControllerIndex controllerIndex=ControllerIndex.Right, PlayerIndex playerIndex=PlayerIndex.One)

static bool	TryCheckConnected (out bool connected, PlayerIndex playerIndex, ControllerIndex controllerIndex=ControllerIndex.Right)
	Gets the connection status of the indicated wand. More...

static bool	TrySendImpulse (float amplitude, float duration, PlayerIndex playerIndex=PlayerIndex.One, ControllerIndex controllerIndex=ControllerIndex.Right)
	Try to send a haptics impulse to the specified wand More...

static void	Update (WandSettings wandSettings, ScaleSettings scaleSettings, GameBoardSettings gameBoardSettings, PlayerIndex playerIndex=PlayerIndex.One)

static void	ScanForWands ()

Private Member Functions
WandCore	ObtainWandCore (GlassesHandle glassesHandle, ControllerIndex controllerIndex)

Static Private Member Functions
static bool	TryScanForWands ()

static bool	TryGetWandAvailability (out bool connected, GlassesHandle glassesHandle, ControllerIndex controllerIndex)

Private Attributes
Dictionary< GlassesHandle, WandPair >	wandCores = new Dictionary<GlassesHandle, WandPair>()
	The collection of WandCores. GlassesHandles are mapped to pairs of right/left WandCores. More...

HashSet< GlassesHandle >	incomingHandles = new HashSet<GlassesHandle>()

HashSet< GlassesHandle >	lostHandles = new HashSet<GlassesHandle>()

HashSet< WandCore >	lostWands = new HashSet<WandCore>()

Static Private Attributes
static readonly Vector3	DEFAULT_WAND_POSITION_GAME_BOARD_SPACE = new Vector3(0f, 0.25f, -0.25f)
	The default position of the wand relative to the board. More...

static readonly Vector3	DEFAULT_WAND_HANDEDNESS_OFFSET_GAME_BOARD_SPACE = new Vector3(0.125f, 0f, 0f)
	A left/right offset to the default wand position, depending on handedness. More...

static readonly Quaternion	DEFAULT_WAND_ROTATION_GAME_BOARD_SPACE = Quaternion.Euler(new Vector3(-33f, 0f, 0f))
	The default rotation of the wand relative to the board. More...

static DateTime	lastScanAttempt = System.DateTime.MinValue

static readonly double	wandScanInterval = 0.5d

static bool	wandAvailabilityErroredOnce = false

static int	currentFrame = -1

Additional Inherited Members
Protected Member Functions inherited from TiltFive.Singleton< Wand >
	Singleton ()

Properties inherited from TiltFive.Singleton< Wand >
static T	Instance `[get]`

Detailed Description

The Wand API and runtime.

Definition at line 55 of file Wand.cs.

Member Function Documentation

◆ GetPosition()

static Vector3 TiltFive.Wand.GetPosition	(	ControllerIndex	controllerIndex = `ControllerIndex.Right`,
		ControllerPosition	controllerPosition = `ControllerPosition.Grip`,
		PlayerIndex	playerIndex = `PlayerIndex.One`
	)

static

Gets the position of the wand in world space.

Parameters

controllerIndex
controllerPosition
glassesHandle	The specified glasses. If null is provided, this uses the default glasses.

Returns: If the indicated wand is not connected, this returns the zero vector.

Definition at line 158 of file Wand.cs.

         {
             if(!Player.TryGetGlassesHandle(playerIndex, out var glassesHandle)
                 || !Instance.wandCores.TryGetValue(glassesHandle, out var wandPair)
                 || !wandPair.TryGet(controllerIndex, out var wandCore))
             {
                 return Vector3.zero;
             }
  
             switch (controllerPosition)
             {
                 case ControllerPosition.Fingertips:
                     return wandCore.fingertipsPose_UnityWorldSpace.position;
                 case ControllerPosition.Aim:
                     return wandCore.aimPose_UnityWorldSpace.position;
                 case ControllerPosition.Grip:
                     return wandCore.Pose_UnityWorldSpace.position;
                 default:
                     return Vector3.zero;
             }
         }

References TiltFive.Singleton< Wand >.Instance.

◆ GetRotation()

static Quaternion TiltFive.Wand.GetRotation	(	ControllerIndex	controllerIndex = `ControllerIndex.Right`,
		PlayerIndex	playerIndex = `PlayerIndex.One`
	)

static

Gets the rotation of the wand in world space.

Parameters

controllerIndex
glassesHandle	The specified glasses. If null is provided, this uses the default glasses.

Returns: If the indicated wand is not connected, this returns the identity quaternion.

Definition at line 189 of file Wand.cs.

         {
             if (!Player.TryGetGlassesHandle(playerIndex, out var glassesHandle)
                 || !Instance.wandCores.TryGetValue(glassesHandle, out var wandPair)
                 || !wandPair.TryGet(controllerIndex, out var wandCore))
             {
                 return Quaternion.identity;
             }
  
             return wandCore.Pose_UnityWorldSpace.rotation;
         }

References TiltFive.Singleton< Wand >.Instance.

◆ IsTracked()

static bool TiltFive.Wand.IsTracked	(	ControllerIndex	controllerIndex = `ControllerIndex.Right`,
		PlayerIndex	playerIndex = `PlayerIndex.One`
	)

static

Definition at line 201 of file Wand.cs.

         {
             if (!Player.TryGetGlassesHandle(playerIndex, out var glassesHandle)
                 || !Instance.wandCores.TryGetValue(glassesHandle, out var wandPair)
                 || !wandPair.TryGet(controllerIndex, out var wandCore))
             {
                 return false;
             }
  
             return wandCore.IsTracked;
         }

References TiltFive.Singleton< Wand >.Instance.

◆ ObtainWandCore()

WandCore TiltFive.Wand.ObtainWandCore	(	GlassesHandle	glassesHandle,
		ControllerIndex	controllerIndex
	)

private

Definition at line 670 of file Wand.cs.

         {
             WandCore wandCore = null;
             var glassesAlreadyMonitored = wandCores.TryGetValue(glassesHandle, out var wandPair);
  
             // Ask the native plugin whether this wand is currently connected.
             if (TryGetWandAvailability(out var wandConnected, glassesHandle, controllerIndex) && wandConnected)
             {
                 // If we're not already monitoring this wand, go ahead and create a corresponding WandCore.
                 if (!glassesAlreadyMonitored || !wandPair.TryGet(controllerIndex, out wandCore))
                 {
 #if UNITY_2019_1_OR_NEWER && INPUTSYSTEM_AVAILABLE
                     wandCore = new WandDeviceCore(glassesHandle, controllerIndex);
 #else
                     wandCore = new WandCore(glassesHandle, controllerIndex);
 #endif
                 }
                 return wandCore;
             }
             // If this wand is disconnected and we were previously monitoring it, mark it as disconnected
             else if(glassesAlreadyMonitored && wandPair.TryGet(controllerIndex, out var lostWandCore))
             {
                 lostWands.Add(lostWandCore);
             }
  
             return wandCore;
         }

References TiltFive.Wand.lostWands, TiltFive.Wand.TryGetWandAvailability(), and TiltFive.Wand.wandCores.

◆ ScanForWands()

static void TiltFive.Wand.ScanForWands ( )

static

Definition at line 311 of file Wand.cs.

         {
             Scan();
         }

◆ TryCheckConnected()

static bool TiltFive.Wand.TryCheckConnected	(	out bool	connected,
		PlayerIndex	playerIndex,
		ControllerIndex	controllerIndex = `ControllerIndex.Right`
	)

static

Gets the connection status of the indicated wand.

Parameters

connected
playerIndex
controllerIndex

Returns: Returns false if something went wrong while attempting to check wand connectivity.

Definition at line 220 of file Wand.cs.

         {
             if(!Player.TryGetGlassesHandle(playerIndex, out var glassesHandle)
                 || !Instance.wandCores.TryGetValue(glassesHandle, out var wandPair)
                 || !wandPair.TryGet(controllerIndex, out var wandCore))
             {
                 connected = false;
                 return true;
             }
  
             connected = wandCore.IsConnected;
             return true;
         }

References TiltFive.Singleton< Wand >.Instance.

Referenced by TiltFive.Input.GetWandAvailability().

◆ TryGetWandAvailability()

static bool TiltFive.Wand.TryGetWandAvailability	(	out bool	connected,
		GlassesHandle	glassesHandle,
		ControllerIndex	controllerIndex
	)

staticprivate

Definition at line 637 of file Wand.cs.

         {
             if (!wandAvailabilityErroredOnce)
             {
                 try
                 {
                     T5_Bool wandAvailable = false;
                     int result = NativePlugin.GetWandAvailability(glassesHandle, ref wandAvailable, controllerIndex);
  
                     if (result == NativePlugin.T5_RESULT_SUCCESS)
                     {
                         connected = wandAvailable;
                         return true;
                     }
                 }
                 catch (DllNotFoundException e)
                 {
                     Log.Info("Could not connect to Tilt Five plugin for wand: {0}", e.Message);
                     wandAvailabilityErroredOnce = true;
                 }
                 catch (Exception e)
                 {
                     Log.Error(
                         "Failed to connect to Tilt Five plugin for wand availability: {0}",
                         e.ToString());
                     wandAvailabilityErroredOnce = true;
                 }
             }
  
             connected = false;
             return false;
         }

References TiltFive.Logging.Log.Error(), TiltFive.Logging.Log.Info(), and TiltFive.Wand.wandAvailabilityErroredOnce.

Referenced by TiltFive.Wand.ObtainWandCore().

◆ TryScanForWands()

static bool TiltFive.Wand.TryScanForWands ( )

staticprivate

Definition at line 605 of file Wand.cs.

         {
             var currentTime = System.DateTime.Now;
             var timeSinceLastScan = currentTime - lastScanAttempt;
  
             // Scan for wands if the scan interval has elapsed to catch newly connected wands.
             if (timeSinceLastScan.TotalSeconds >= wandScanInterval)
             {
                 int result = NativePlugin.T5_RESULT_UNKNOWN_ERROR;
  
                 try
                 {
                     result = NativePlugin.ScanForWands();
                 }
                 catch (System.DllNotFoundException e)
                 {
                     Log.Info(
                         "Could not connect to Tilt Five plugin to scan for wands: {0}",
                         e);
                 }
                 catch (Exception e)
                 {
                     Log.Error(e.Message);
                 }
  
                 lastScanAttempt = currentTime;
                 return (result == NativePlugin.T5_RESULT_SUCCESS);
             }
  
             return false;
         }

References TiltFive.Logging.Log.Error(), TiltFive.Logging.Log.Info(), TiltFive.Wand.lastScanAttempt, and TiltFive.Wand.wandScanInterval.

◆ TrySendImpulse()

static bool TiltFive.Wand.TrySendImpulse	(	float	amplitude,
		float	duration,
		PlayerIndex	playerIndex = `PlayerIndex.One`,
		ControllerIndex	controllerIndex = `ControllerIndex.Right`
	)

static

Try to send a haptics impulse to the specified wand

Parameters

amplitude	The amplitude of the impulse, between [0.0,1.0].
duration	The duration of the impulse, between 0.0 and 0.320 s.
playerIndex
controllerIndex

Returns: Returns false if something went wrong while attempting to send the impulse command

Definition at line 267 of file Wand.cs.

         {
             if (!Player.TryGetGlassesHandle(playerIndex, out var glassesHandle)
                 || !Instance.wandCores.TryGetValue(glassesHandle, out var wandPair)
                 || !wandPair.TryGet(controllerIndex, out var wandCore))
             {
                 return false;
             }
  
             try
             {
                 if (NativePlugin.SendImpulse(glassesHandle, controllerIndex, amplitude, (UInt16)(Mathf.Clamp(duration, 0.0f, 0.320f) * 1000)) == 0)
                 {
                     return true;
                 }
                 else
                 {
                     return false;
                 }
             }
             catch (DllNotFoundException e)
             {
                 Log.Info("Tilt Five library missing. Could not connect to wand: {0}", e.Message);
                 return false;
             }
             catch (Exception e)
             {
                 Log.Error(
                     "Failed to send impulse to wand: {0}",
                     e.ToString());
                 return false;
             }
         }

References TiltFive.Logging.Log.Error(), TiltFive.Logging.Log.Info(), and TiltFive.Singleton< Wand >.Instance.

◆ Update()

static void TiltFive.Wand.Update	(	WandSettings	wandSettings,
		ScaleSettings	scaleSettings,
		GameBoardSettings	gameBoardSettings,
		PlayerIndex	playerIndex = `PlayerIndex.One`
	)

static

Definition at line 305 of file Wand.cs.

         {
             Update(playerIndex, wandSettings, scaleSettings, gameBoardSettings);
         }

Referenced by TiltFive.TiltFiveManager.GetLatestPoseData(), and TiltFive.Player.PlayerCore.GetLatestPoseData().

Member Data Documentation

◆ currentFrame

int TiltFive.Wand.currentFrame = -1

staticprivate

Definition at line 104 of file Wand.cs.

◆ DEFAULT_WAND_HANDEDNESS_OFFSET_GAME_BOARD_SPACE

readonly Vector3 TiltFive.Wand.DEFAULT_WAND_HANDEDNESS_OFFSET_GAME_BOARD_SPACE = new Vector3(0.125f, 0f, 0f)

staticprivate

A left/right offset to the default wand position, depending on handedness.

Definition at line 74 of file Wand.cs.

Referenced by TiltFive.Wand.WandCore.GetDefaultPoseGameboardSpace().

◆ DEFAULT_WAND_POSITION_GAME_BOARD_SPACE

readonly Vector3 TiltFive.Wand.DEFAULT_WAND_POSITION_GAME_BOARD_SPACE = new Vector3(0f, 0.25f, -0.25f)

staticprivate

The default position of the wand relative to the board.

The wand GameObject will snap back to this position if the glasses and/or wand are unavailable.

Definition at line 70 of file Wand.cs.

Referenced by TiltFive.Wand.WandCore.GetDefaultPoseGameboardSpace().

◆ DEFAULT_WAND_ROTATION_GAME_BOARD_SPACE

readonly Quaternion TiltFive.Wand.DEFAULT_WAND_ROTATION_GAME_BOARD_SPACE = Quaternion.Euler(new Vector3(-33f, 0f, 0f))

staticprivate

The default rotation of the wand relative to the board.

The wand GameObject will snap back to this rotation if the glasses are unavailable. If different behavior is desired in this scenario, a different camera should be used.

Definition at line 83 of file Wand.cs.

Referenced by TiltFive.Wand.WandCore.GetDefaultPoseGameboardSpace().

◆ incomingHandles

HashSet<GlassesHandle> TiltFive.Wand.incomingHandles = new HashSet<GlassesHandle>()

private

Definition at line 87 of file Wand.cs.

◆ lastScanAttempt

DateTime TiltFive.Wand.lastScanAttempt = System.DateTime.MinValue

staticprivate

Definition at line 95 of file Wand.cs.

Referenced by TiltFive.Wand.TryScanForWands().

◆ lostHandles

HashSet<GlassesHandle> TiltFive.Wand.lostHandles = new HashSet<GlassesHandle>()

private

Definition at line 89 of file Wand.cs.

◆ lostWands

HashSet<WandCore> TiltFive.Wand.lostWands = new HashSet<WandCore>()

private

Definition at line 91 of file Wand.cs.

Referenced by TiltFive.Wand.ObtainWandCore().

◆ wandAvailabilityErroredOnce

bool TiltFive.Wand.wandAvailabilityErroredOnce = false

staticprivate

Definition at line 100 of file Wand.cs.

Referenced by TiltFive.Wand.WandCore.TryCheckConnected(), and TiltFive.Wand.TryGetWandAvailability().

◆ wandCores

Dictionary<GlassesHandle, WandPair> TiltFive.Wand.wandCores = new Dictionary<GlassesHandle, WandPair>()

private

The collection of WandCores. GlassesHandles are mapped to pairs of right/left WandCores.

Definition at line 62 of file Wand.cs.

Referenced by TiltFive.Wand.ObtainWandCore().

◆ wandScanInterval

readonly double TiltFive.Wand.wandScanInterval = 0.5d

staticprivate

Definition at line 98 of file Wand.cs.

Referenced by TiltFive.Wand.TryScanForWands().

The documentation for this class was generated from the following file:

Wand.cs

Classes

Static Public Member Functions

Private Member Functions

Static Private Member Functions

Private Attributes

Static Private Attributes

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ GetPosition()

◆ GetRotation()

◆ IsTracked()

◆ ObtainWandCore()

◆ ScanForWands()

◆ TryCheckConnected()

◆ TryGetWandAvailability()

◆ TryScanForWands()

◆ TrySendImpulse()

◆ Update()

Member Data Documentation

◆ currentFrame

◆ DEFAULT_WAND_HANDEDNESS_OFFSET_GAME_BOARD_SPACE

◆ DEFAULT_WAND_POSITION_GAME_BOARD_SPACE

◆ DEFAULT_WAND_ROTATION_GAME_BOARD_SPACE

◆ incomingHandles

◆ lastScanAttempt

◆ lostHandles

◆ lostWands

◆ wandAvailabilityErroredOnce

◆ wandCores

◆ wandScanInterval