User Tools

Site Tools


manual:logging

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

manual:logging [2009/06/04 02:04] (current)
camille created
Line 1: Line 1:
 +====== Logging ======
 +
 +Debugging OSC can be sometimes tedious. ​ OSCulator provides a way to monitor the input data by using the Console Log event or the Quick Look Window.
 +
 +===== Console Log =====
 +
 +To use this event, choose '​Console Log' in the Event Type column. ​ There are two types of logging:
 +
 +  ; Simple Log : Use it when you want to see every input values logged to the Console application.
 +  ; Timed Log : If your input changes very often, it is better to use the ''​Timed Log''​ event because it only logs every seconds to the Console.
 +
 +When an OSC message is received, a log entry is written in the System Log.  To see it, you can use the system application '​Console.app',​ located in the ''/​Applications/​Utilities''​ folder.
 +
 +{{:​manual:​console_log.png|A view of the Console application}}
 +
 +===== Quick Look Window =====
 +
 +The Quick Look makes it even more easy to monitor input values. ​ To display the Quick Look Window, select the message argument you want to monitor, then either press the Space bar, press on the ''​Quick Look''​ toolbar item, or select the ''​Quick Look''​ menu item in the ''​Routings''​ menu.
 +
 +You can open as many Quick Look Windows as you want, resize and place them on the screen, and also save their position in the document file for later redisplay.
 +
 +{{ :​manual:​quick_look_continous.png |Quick Window showing the roll parameter of the Wiimote}}
 +
 +The Quick Look window displays the input with a real time graph. ​ The abcissa spans a duration of 10 seconds, and the ordinate shows values from ''​0.0''​ to ''​1.0''​ with a fixed scale. ​ The most recent activity is shown on the right, scrolling to the left.
 +
 +On the top left, there is an activity indicator glowing green when input activity is detected((that is, when an OSC message is received)), and resting grey when no input is received. ​ In the previous picture, the roll parameter of a Wiimote is displayed, showing that messages are sent continuously.
 +
 +The horizontal line drawn with a lighter grey shows the value ''​0.5'',​ value at which triggered events((like Notes, Key Combos, Toggles, etc.)) are fired.
 +
 +When a message doesn'​t change, the graph line keeps its current values, and is drawn in grey reflecting the color of the activity monitor:
 +
 +{{ :​manual:​quick_look_discrete.png |Quick Look window showing a button being monitored}}
 +
 +To dispose the Quick Look window, either click on the close button, or press the Space bar.
  
manual/logging.txt ยท Last modified: 2009/06/04 02:04 by camille