Connect-153 File Log

Connect can write the messages it outputs from the digitizer to a file, with time stamps for each message that was output.

File(s)

Each time the File toggle is set, a new file will be created.

Clicking the File toggle while holding down the Alt/Option key on the keyboard will log all OSC, MIDI and Web messages output by Connect to separate files for each output type.

The file(s) are saved in the folder ~\Documents\Connect\Logs with the following format for the name:

<digitizer_name>_yyyy-MM-dd_hh-mm-ss.txt

where yyyy is the year, MM is the month, dd is the day, hh is the hour, mm is the minute, ss is the second, all with leading zero.

For example "USB-microDig_0208_2018-01-14_17-12-54.txt".

When logging all data using the Alt/Option-click method, three files will created, with names like:

"USB-microDig_0208_MIDI_2018-01-14_17-15-23.txt"

"USB-microDig_0208_OSC_2018-01-14_17-15-23.txt"

"USB-microDig_0208_WEB_2018-01-14_17-15-23.txt"

Note that if an output type is not enabled, no data will be logged. For example if OSC output is not enabled, the file with OSC messages will remain empty.

Data

The data written to the file is preceded by a timestamp. When logging the sensor data only (ie. not using the Alt/Option-click method), the content is the same as the OSC output preceded by the timestamp. It conforms to one of the following formats, depending on the type of sensor and the digitizer's mode of operation:

Analog sensor

<timestamp> /<digitizer_name>/<input_name> <sensor_value>, eg. "2018-01-18 17:08:01.112 /USB-microDig_0208/Input_02/V 76"

Digital sensor, standalone mode

<timestamp> /<digitizer_name>/<input_name><parameter_name> <sensor_value>, eg. "2018-01-18 17:08:10.435 /USB-microDig_0208/Input_02/H 76" for an Orient3D outputting its Heading value.

Digital sensor, host mode

<timestamp> /<digitizer_name>/<input_name>/[<parameter_name_array>] <sensor_value_array>, eg. "2018-01-18 17:08:20.332 /USB-microDig_0208/Input_02/[H,P,R] 298.7, 6, 0" for an Orient3D outputting Heading, Pitch and Roll.

The timestamp format is as follows:

yyyy-MM-dd hh:mm:ss.SSS

where yyyy is the year, MM is the month, dd is the day, hh is the hour, mm is the minute, ss is the second and SSS is the millisecond, all with leading zero(s).