adc~
MSP Reference
Open Help

adc~

Audio input and on/off

Description

adc~ is the audio-to-digital converter for a signal-processing patch which can be used to route signal inputs from external devices or inputs into your patch. It can also be used to turn MSP's signal-processing on or off entirely.

Examples

Audio input for processing and recording

Arguments

inputs [int]

Optional

You can create a adc~ object that uses one or more audio input channel numbers between 1 and 512. These numbers refer to logical channels and can be dynamically reassigned to physical device channels of a particular driver using either the Audio Status window, its I/O Mappings subwindow, or an adstatus object with an input keyword argument. If the computer's built-in audio hardware is being used, there will be two input channels available. Other audio drivers and/or devices may have more than two channels. If no argument is typed in, adc~ will have two outlets, initially set to logical input channels 1 and 2.

Attributes

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

on/off-flag [int]
A non-zero number turns on audio processing in all loaded patches. 0 turns off audio processing in all loaded patches.

list

Arguments

input-channel-designations [list]
list comprised of integers sets the logical input channels for each signal inlet.

(mouse)

Double-clicking on adc~ opens the Audio Status window.

open

Opens the Audio Status window.

set

Arguments

logical-output-channel [int]
logical-input-channel [int]
The word set , followed by two numbers, sets the logical input channel for one of the object's signal outlets. The first number specifies the outlet number, where 1 is the leftmost outlet. The second number specifies the logical input channel (from 1 to 512). If the second number is 0 , the outlet sends out the zero signal.

start

Turns on audio processing in all loaded patches.

startwindow

Turns on audio processing only in the patch in which this adc~ is located, and in subpatches of that patch. Turns off audio processing in all other patches.

stop

Turns off audio processing in all loaded patches.

wclose

Closes the Audio Status window if it is open

Output

signal

The signal arriving at the computer's input is sent out, one channel per outlet. If there are no typed-in arguments, the channels are 1 and 2, numbered left-to-right; otherwise the channels are in the order specified by the arguments.

See Also

Name Description
adstatus Report and control audio driver settings
ezadc~ Audio input and on/off button
ezdac~ Audio output and on/off button
dac~ Audio output and on/off
MSP: Audio Input and Output MSP: Audio Input and Output
MSP Sampling Tutorial 1: Recording and Playback MSP Sampling Tutorial 1: Recording and Playback