Tilt Five NDK
T5_GameboardPose Struct Reference

Gameboard pose information to be retrieved by enumerating the output of t5GetGameboardPoses() More...

#include <types.h>

Collaboration diagram for T5_GameboardPose:

Data Fields

uint64_t timestampNanos
 The timestamp of the pose. More...
 
T5_Vec3 posBOARD_STAGE
 The position of the origin of the BOARD (gameboard) frame relative to the STAGE frame. More...
 
T5_Quat rotToBOARD_STAGE
 The rotation that transforms points in the STAGE frame orientation to the BOARD (gameboard) frame orientation. More...
 
T5_GameboardType gameboardType
 The type of gameboard represented by this pose. More...
 
uint64_t id
 The id of this gameboard pose. More...
 

Detailed Description

Gameboard pose information to be retrieved by enumerating the output of t5GetGameboardPoses()

The pose describes the relationship between two reference frames: one defined in terms of the stage, and the other in terms of the gameboard. Both reference frames are right-handed. The STAGE reference frame is oriented such that, when standing on the side of the physical gameboard with the T5 logo, +X points to the right, +Y points forward, and +Z points gravitationally up. The origin of the STAGE reference frame is located at the point equidistant from the three gameboard sides nearest to the T5 logo (i.e. the side on which the logo appears and the two adjacent sides). This places the gameboard origin in the center of the square LE gameboard, and off-center along the longer dimension of the rectangular XE gameboard. The gameboard reference frame, BOARD, is oriented such that +X points to the right, +Y points forward, and +Z points normal to and away from the reflective plane of the gameboard. The origin of BOARD space is located at the point equidistant from the three gameboard sides nearest to the T5 logo (i.e. the side on which the logo appears and the two adjacent sides). The BOARD space is identical to STAGE space when the physical gameboard is flat wrt gravity. When the physical gameboard is tilted up at an angle, STAGE space z remains gravity aligned where BOARD space z remains aligned with the normal vector to the reflective gameboard plane.

Definition at line 392 of file types.h.

Field Documentation

◆ gameboardType

T5_GameboardType T5_GameboardPose::gameboardType

The type of gameboard represented by this pose.

Definition at line 405 of file types.h.

Referenced by operator<<().

◆ id

uint64_t T5_GameboardPose::id

The id of this gameboard pose.

Definition at line 408 of file types.h.

◆ posBOARD_STAGE

T5_Vec3 T5_GameboardPose::posBOARD_STAGE

The position of the origin of the BOARD (gameboard) frame relative to the STAGE frame.

Definition at line 398 of file types.h.

Referenced by operator<<().

◆ rotToBOARD_STAGE

T5_Quat T5_GameboardPose::rotToBOARD_STAGE

The rotation that transforms points in the STAGE frame orientation to the BOARD (gameboard) frame orientation.

Definition at line 402 of file types.h.

Referenced by operator<<().

◆ timestampNanos

uint64_t T5_GameboardPose::timestampNanos

The timestamp of the pose.

Definition at line 394 of file types.h.

Referenced by operator<<().


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