Set the reference system in which tracking results are reported.

Sets the reference system relative to which tracking results are reported. The reference system is defined by a homogeneous transformation matrix (a row-major 4x4 matrix) representing a right-handed Cartesian coordinate system. The function checks if a valid, orthogonal transformation matrix has been supplied. When an invalid matrix has been supplied, it will not be applied.

See also: PSTapi/SetRelativeReference and PSTapi/SetDefaultReference

Endpoint

  
  POST /PSTapi/SetReference   HTTP/1.1
  Host: address:port

ReferenceMatrix Object

Key	Value Type	Description
ReferenceMatrix	array of double	Reference Matrix. Array of 16 float representing a row-major 4x4 homogeneous transformation matrix

POST Payload: Request body parameters example

 
  {"ReferenceMatrix":[1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1]}

Response

Returns an array of 16 float representing the new Reference system as a row-major 4x4 homogeneous transformation matrix

ReferenceMatrix Object

Key	Value Type	Description
ReferenceMatrix	Array of numbers	Reference Matrix. Array of 16 float representing a row-major 4x4 homogeneous transformation matrix

Example

 
  {"ReferenceMatrix":[1,0,0,0,0,1,0,0,0,0,1,0,0,0,0,1]}

Verification table

Status Code	Content Example	Meaning
200	Json payload	Success message
400	{"message":"JSON_ERROR: <...>"}	an error occured when parsing a json object
500	{"message":"TrackerException: <...>"}	an other type of internal error