Extended Header Information

 Previous  Next

 

The following type of Extended Headers have been defined

 

'9'        Command Extended Header (CEH).  Used to send commands to the host (MaxREAL) application so it can be controlled remotely.

 

Command Extended Header Format

 

General Format of the Command Extended Header:

<space><module><command><property><parameter type><parameter>

 

Where these are currently defined

 

<space>

'A'

Application

'S'

Streaming3D

'W'

WorkSpace

 

<module>

'I'

Input/Camera

'C'

Calibration

'T'

Tracking

'P'

Processing

'O'

Output

 

<command>

'S'

Set

 

<property>

Camera Set command properties valid with <space>'W' and <module>'I'

'E'

Exposure.  Sets the cameras Exposure.  Type Integer with valid range 0-100

'G'

Gain.  Sets the cameras Gain.  Type Integer with valid range 0-200

'T'

Threshold.  Sets the cameras Threshold level.  Type Integer with valid range 0-255

'F'

Frame Rate.  Sets the frame rate.  Parameter Type integer

'S'

Marker Size filter.  Type Integer where the lower 16 bit is min size and upper 16 bit is max size.

'I'

Marker Intensity filter.  Type Integer where the lower 16 bit is min intensity and upper 16 bit is max intensity.

'D'

Max Marker Size Difference.  This is the difference between X and Y marker size.  Type integer with a valid range of 0-255.

'R'

Roundness.  Sets max slant of a marker where 0 denotes a perfect circle.  Type integer with a valid range of 0-255.

 

Tracking Set command properties valid with <space>'W' and <module>'T'

'B'

Set Body Definition.  Parameter can be one of '3', '4' or 'P'.  To make sure that the correct body definition file is being loaded when using a file, the file extension should be one of .BD3 or .BD4.  Loading a body definition file will reset  tracker settings to the defaults so this should be the first command before changing any other tracking settings.  Also Note;  The current selected Tracker Type must match the Body Definition file.  The correct sequence of commands is:

1.Set Tracker Type
2.Select Body Definition File
3.Set additional Tracking Parameters

Current version of MaxREAL only supports this command with the 'P' parameter

'R'

Max Residual.  Sets the Max 3D tracking residual.  Type float

'M'

Tracker Type.  Select the tracker.  Type Integer.  Can be 3 or 4.

'P'

Predictor Window.  Parameter Type Integer

'A'

Acceleration Factor. Parameter Type integer.  Valid range 0-100

'N'

No of Bodies to track.  Type Integer

'T'

Tolerance.  Sets the body recognition tolerance.  Type float.  Valid range 0-100

'F'

Filter.  Set the filter coefficient for the Complimentary filter.  Lower value means less filtering while a higher number will filter more.  Type integer.  Valid range 0-75.

 

<parameter type>

'A'

ASCII.  In this case <parameter> is an integer with length of ASCII stream.  The ASCII stream will follow directly after the CEH.

'F'

Single Precision Floating Point using little endian.

'I'

32 bit Integer using little endian

'X'

XML.  <parameter> is an integer with length of the XML stream.  The XML code will follow directly after the CEH

'S'

Script.  <parameter> is an integer with length of the Script.  The Script contents will follow directly after the CEH.

'P'

File or Folder Name.  <parameter> is an integer with length of the name.  The file or folder name will follow directly after the CEH.

'3'

Body Definition type 3.  <parameter> is an integer with length of the contents.  The Body Definition will follow directly after the CEH.

'4'

Body Definition type 4.  <parameter> is an integer with length of the contents.  The Body Definition will follow directly after the CEH.