Stethoscope provides a complete oscilloscope GUI. It displays a window containing a bus-plotting ScopeView and an interface to configure the plotting and choose among the buses.
Several classes provide a convenient 'scope' method that creates a Stethoscope to display their data. See for example: Server: -scope, Bus: -scope, Function: -scope.
The following keyboard shortcuts may be used when focused on the Stethoscope display:
| Shortcut | Action |
| J | one channel back |
| K | switch rate (audio vs. control) |
| L | one channel forward |
| O | jump to first hardware output channel and adjust numChannels to hardware |
| I | jump to first hardware input channel and adjust numChannels to hardware |
| space | run, if not running already |
| . (period) | stop |
| M | toggle screen size |
| + / - | zoom horizontally |
| * / _ | zoom vertically |
| S | change style between parallel and overlay |
| Shift+S | change style to lissajou |
| Shift+A | allocate buffer size so it fills the screen (to next power of two) (this can be dangerous, might crash) |
Create a Stethoscope, either as a window, or placed on a given parent view.
| server |
A valid Server (either a local or the internal server), or |
| numChannels |
An integer. Default value is 2. |
| index |
The offset index. An Integer. Default is nil. |
| bufsize |
The size of the analysis buffer. Default is 4096. See also -bufsize. |
| zoom |
Horizontal magnification of the displayed wave. Default is 1. See also -xZoom. |
| rate |
\audio or \control. Default is \audio. |
| view |
The optional parent view. Default is nil. If nil, then it will open in its own Window. |
| bufnum |
The id number of the Buffer to analyze. Default value is nil. If nil, then a Buffer of size bufSize is allocated. discussion: Example: |
Tests whether Stethoscope can operate on the given server (any local server. See Server: -isLocal).
| aServer |
A Server. |
A Boolean.
Returns an array of the running ugen scopes.
The server on which the scope operates.
Whether to operate on audio or control busses.
| argRate |
One of the two symbols: |
The starting index of the busses to scope.
| i |
An Integer. |
Defines the maximum allowed -cycle.
The exact scoping period, in signal frames. Reciprocal to what is also known as sweep speed in analog oscilloscopes. It is dynamically adjustable while the scope is running.
Data from scoped signals will be accumulated into a buffer until it reaches cycle amount frames, at which point the buffering will immediately restart. The view will repeatedly display the entire buffer; it may skip a cycle if the drawing is too slow to keep up with the speed of incoming data, but the cycle boundaries will never shift with respect to signals.
If you are scoping a periodic signal, setting cycle to match the signal's period will keep the waveform locked in place.
The (parent) Window of the scope.
Sets the width and the height of the scope window.
| value |
An Integer (the window is square). |
Toggle between small and large size.
A synonym for -xZoom.
Magnifies the displayed wave horizontally to the given factor.
This sets -cycle to 1024 * xZoom.reciprocal.
| val |
A Float. |
Magnifies the displayed wave vertically to the given factor.
| val |
A Float. |
The plotting style:
| val |
One of the above Integers. |
Starts the scope, if not already running.
Closes the window, and cleans up any used synths and buffers.
Sets several properties at once: -numChannels, -index, -bufsize, -zoom, and -rate.
You can pass your own view in to add a stethoscope to it: