Set the reference system in which tracking results are reported.

Sets the reference system 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 floats 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 floats 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 occurred when parsing a JSON object
500	{"message":"TrackerException: <...>"}	An other type of internal error