Difference between revisions of "Connect-163 File Log"

From I-CubeX Wiki
Jump to: navigation, search
(Created page with "Connect can write the messages it outputs from the digitizer to a file, with time stamps for each message that was output. File:connect-150_digitizer_view_umd_file.png...")
 
 
Line 9: Line 9:
 
Each time the File toggle is set, a new file will be created.
 
Each time the File toggle is set, a new file will be created.
  
Clicking the File toggle while holding down the option key on the keyboard will log all OSC, MIDI and Web messages output by Connect to separate files for each output type.  
+
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:
 
The file(s) are saved in the folder ~\Documents\Connect\Logs with the following format for the name:
Line 19: Line 19:
 
For example "USB-microDig_0208_2018-01-14_17-12-54.txt".
 
For example "USB-microDig_0208_2018-01-14_17-12-54.txt".
  
When logging all data using the option-click method, three files will created, with names like:
+
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_MIDI_2018-01-14_17-15-23.txt"
Line 32: Line 32:
 
<b>Data</b>
 
<b>Data</b>
  
The data written to the file is preceded by a timestamp. When logging the sensor data only (ie. not using the 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:
+
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:
  
 
<u>Analog sensor</u>
 
<u>Analog sensor</u>

Latest revision as of 03:57, 19 December 2019

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


Connect-150 digitizer view umd file.png


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).