scope~
MSP Reference
Open Help

scope~

Visualize an audio signal

Description

Use the scope~ object to visualize and audio signal using an oscilloscope-style display.

Examples

Display a signal, or plot two signals in X-Y mode

Arguments

None.

Attributes

bgcolor [4 floats]

Sets the background color in RGBA format.

bufsize [atom_long] (default: 128)

Number of samples stored in the buffer

calccount [atom_long] (default: 256)

Sets the number of samples per pixel to display

delay [float] (default: 0.)

Delay between each "trace" of oscilloscope in milliseconds

drawstyle [int] (default: 0)

Toggles an alternate drawing style which may make some waveforms more easily visible

fgcolor [4 floats]

Sets the phosphor color in RGBA format. The fgcolor attribute is mapped to the color style color.

gridcolor [4 floats]

Sets the grid color in RGBA format. The gridcolor attribute is mapped to the elementcolor style color.

range [2 floats] (default: -1. 1.)

Minimum/maximum amplitudes displayed vertically

style [symbol]7.0.0

Sets the style to be applied to the object. Styles can be set using the Format palette.

trigger [int] (default: 0)

Trigger mode determines when a new waveform trace begins (following the delay ).
trigger 1 sets an upward trigger in which the signal must go from being below the triglevel to being equal to it or above it.
trigger 2 sets a downward trigger in which the signal must go from being above the triglevel level to being equal to it or below it.
The default trigger mode is 0, which does not wait after a non-zero delay period before collecting samples again.

Possible values:

0 = 'None'
1 = 'Up'
2 = 'Down'

triglevel [float] (default: 0.)

Threshold to trip trigger mode. When trigger mode is 1 or 2, the waveform must increase or decrease past this value to trigger a new trace. If you are displaying a periodic waveform, slight changes to the trigger level will shift the waveform to the left or right.

Common Box Attributes

annotation [symbol]

Sets the text that will be displayed in the Clue window when the user moves the mouse over the object.

background [int] (default: 0)

Adds or removes the object from the patcher's background layer. background 1 adds the object to the background layer, background 0 removes it. Objects in the background layer are shown behind all objects in the default foreground layer.

color [4 floats]

Sets the color for the object box outline.

fontface [int]

Sets the type style used by the object. The options are:

plain
bold
italic
bold italic

Possible values:

0 = 'regular'
1 = 'bold'
2 = 'italic'
3 = 'bold italic'

fontname [symbol]

Sets the object's font.

fontsize [float]

Sets the object's font size (in points).

Possible values:

'8'
'9'
'10'
'11'
'12'
'13'
'14'
'16'
'18'
'20'
'24'
'30'
'36'
'48'
'64'
'72'

hidden [int] (default: 0)

Toggles whether an object is hidden when the patcher is locked.

hint [symbol]

Sets the text that will be displayed in as a pop-up hint when the user moves the mouse over the object in a locked patcher.

ignoreclick [int] (default: 0)

Toggles whether an object ignores mouse clicks in a locked patcher.

patching_rect [4 floats] (default: 0. 0. 100. 0.)

Sets the position and size of the object in the patcher window.

position [2 floats]

g/s(set)

Sets the object's x and y position in both patching and presentation modes (if the object belongs to its patcher's presentation), leaving its size unchanged.

presentation [int] (default: 0)

Sets whether an object belongs to the patcher's presentation.

presentation_rect [4 floats] (default: 0. 0. 0. 0.)

Sets the x and y position and width and height of the object in the patcher's presentation, leaving its patching position unchanged.

rect [4 floats]

g/s(set)

Sets the x and y position and width and height of the object in both patching and presentation modes (if the object belongs to its patcher's presentation).

size [2 floats]

g/s(set)

Sets the object's width and height in both patching and presentation modes (if the object belongs to its patcher's presentation), leaving its position unchanged.

textcolor [float]

Sets the color for the object's text in RGBA format.

textjustification [int]

Text Justification

Possible values:

0 = 'left'
1 = 'center'
2 = 'right'

varname [symbol]

Sets the patcher's scripting name, which can be used to address the object by name in pattr, scripting messages to thispatcher, and the js object.

Messages

int

Arguments

object-settings [int]
Left inlet: Number of samples collected for each value in the display buffer. Smaller numbers expand the image but make it scroll by on the screen faster. The minimum value is 2, the maximum is 8092, and the default initial value is 256. In X or Y mode, the most maximum or minimum value seen within this period is used. In X-Y mode, a representative sample from this period is used.

Right inlet: Size of the display buffer. This controls the rate at which scope~ redisplays new information as well as the scaling of that information. If the buffer size is larger, the signal image will stay on the screen longer and be visually compressed. If the buffer size is smaller, the signal image will stay on the screen a shorter time before it is refreshed and will be visually expanded.

It might appear that the samples per display buffer element and the display buffer size controls do the same thing but they have subtly different effects. You may need to experiment with both controls to find the optimum display parameters for your application.

(mouse)

Click to freeze the display for as long as you hold the click

signal

Left inlet: signal to display on the X axis of the oscilloscope
Right inlet: signal to display on the Y axis of the oscilloscope

If signal objects are connected to both the left and right inlets, scope~ operates in X-Y mode, plotting points whose horizontal position corresponds to the value of the signal coming into the left (X) inlet and whose vertical position corresponds to the value of the signal coming into the right (Y) inlet. If the two signals are identical and in phase, a straight line increasing from left to right will be seen. If the two signals are identical and 180 degrees out of phase, a straight line decreasing from left to right will be seen. Other combinations may produce circles, ellipses, and Lissajous figures.

Output

visual

The waveform of the incoming signal is displayed within the oscilloscope display.

See Also

Name Description
meter~ Visual peak level indicator
MSP Analysis Tutorial 2: Oscilloscope and Spectroscope MSP Analysis Tutorial 2: Oscilloscope and Spectroscope