adstatus
Description
Use the adstatus object to control Max audio settings.
Examples
Arguments
Controllable-settings: [symbol]
The first argument is a symbol that specifies the setting to be controlled by the adstatus object. Some settings require an additional integer argument. The possible settings are:
cpu: Reports current CPU utilization.
cpulimit: Reports and sets the CPU utilization limit as a percentage from 0-100.
driver: Lists the available audio drivers and allows the current one to be changed.
info: Reports the number of function calls and signals used in the top level
input (Requires an additional argument specifying a logical channel number (used by the adc~ object) between 1 and 512): Lists the available audio driver input channels and allows the current setting to be changed.
iovs: Reports the available I/O vector sizes of the current audio driver and
latency: If supported by the audio driver, reports the input and output latencies of the driver in samples.
numinputs: Reports the number of input channels of the current audio driver.
numoutputs: Reports the number of output channels of the current audio driver.
option (Requires an additional argument specifying the option number (starting at 1): If the current audio driver uses the numbered option, reports the available choices for setting the value of the option.
optionname (Requires an additional argument specifying the option number (starting at 1): If the current audio driver uses the numbered option, the name of the option is reported.
output (Requires an additional argument specifying a logical channel number (used by the dac~ object) between 1 and 512): Lists the available audio driver output channels and allows the current setting to be changed.
overdrive: Controls the setting of overdrive mode (where the scheduler runs in a
sigvs: Reports the available signal vector sizes and allows the current signal vector size setting to be changed.
sr: Reports the available sampling rates and allows the current sampling rate setting to be changed.
switch: Turns the DSP on or off.
takeover: Controls the setting of scheduler in audio interrupt mode.
timecode: If supported by the audio driver, reports the current timecode value.
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.
adds the object to the background layer, 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.
jspainterfile [symbol]
JS Painter File
patching_rect [4 floats] (default: 0. 0. 100. 0.)
Sets the position and size of the object in the patcher window.
position [2 floats]
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]
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]
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 [4 floats]
Sets the color for the object's text in RGBA format.
textjustification [int]
Sets the justification for the object's text.
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
bang
int
Arguments
(inlet1)
Arguments
float
Arguments
loadbang
override
Arguments
set
Arguments
update
Output
cpu
Reports CPU utilization as a percentage (normally from 0 to 100).
cpulimit
Reports the current CPU utilization limit.
driver
Lists all current audio driver choices.
float
Out left outlet: For objects that don't use a menu-style output, the current value of the setting is sent out the left outlet. Here are details for specific settings:
float
Out right outlet: Here are the objects that output something out the value outlet of the object:
info
Reports the number of function calls used in the top-level DSP chain.
info
Reports the number of signals used in the top-level DSP chain.
input
Lists audio input channels for the audio driver currently in use.
input
Reports the current input channel for the specified logical channel.
int
Out left outlet: For objects that don't use a menu-style output, the current value of the setting is sent out the left outlet. Here are details for specific settings:
int
Out right outlet: Here are the objects that output something out the value outlet of the object:
iovs
Lists I/O vector sizes for the audio driver currently in use.
iovs
Reports the current I/O vector size.
latency
If supported by the audio driver, reports the input latency of the audio driver.
numinputs
Reports the number of inputs in the current audio driver.
numinputs
Reports the number of inputs in the current audio driver (same as left outlet).
numoutputs
Reports the number of outputs in the current audio driver.
numoutputs
Reports the number of outputs in the current audio driver (same as left outlet).
option
Creates a list of choices for the specified option.
option
Reports the menu item index of the option's current value.
optionname
Sets a menu that names the specified option. Intended for use with a pop-up menu object in label mode.
output
Lists audio output channels for the audio driver currently in use.
output
Reports the current output channel for the specified logical channel.
overdrive
Creates an On/Off menu for use with this setting.
overdrive
Reports the current on/off setting of overdrive mode.
overdrive
Reports the current on/off setting of overdrive mode.
set
Out left outlet: When a
message is received or when the value of the setting that has a menu-style output is changed, the word , followed by a number with a menu item index (starting at 0) is sent out. Here are details of outputs from the left outlet for specific settings with menu-style outputs:sigvs
Lists signal vector sizes for the audio driver currently in use.
sigvs
Reports the current signal vector size.
sr
Lists sampling rates available for the audio driver currently in use.
sr
Reports the current sampling rate.
switch
Creates an On/Off menu for turning the DSP on and off.
switch
Reports the current on/off setting of the DSP.
takeover
Creates an On/Off menu for switching scheduler in audio interrupt mode.
takeover
Reports the current on/off setting of takeover mode.
timecode
If supported by the audio driver, reports the current timecode as a list in the following format:
1. time code sample count most significant word
2. time code sample count least significant word
3. time code subframes
4. time code flags
5. time code frame rate
various
Out left outlet: For many settings, a series of messages intended to set up a pop-up menu object are sent out the left outlet when the reset or loadbang message is received by adstatus. See the message in the Input section for more details.
The following settings have a menu-style output: , , , , , , , and .
See Also
Name | Description |
---|---|
dspstate~ | Report current DSP settings |
adoutput~ | Access audio driver output channel |
MSP: Audio Input and Output | MSP: Audio Input and Output |
MSP Analysis Tutorial 4: Signal Processing with pfft~ | MSP Analysis Tutorial 4: Signal Processing with pfft~ |