Interacting with MAX/PureData¶
When embedded in MAX, the systems appears as an antescofo~
object that
can be used in a patch. This object presents a fixed interface through
its inlets and outlets1.
Inlets¶
The main inlet is dedicated to the audio input. Antescofo’s default
observation mode is “audio” and based on pitch and can handle multiple
pitch scores (and audio). But it is also capable of handling other
inputs, such as control messages and user-defined audio features. To
tell Antescofo what to follow, you need to define the type of input
during object instantiation, after the operator @inlets
. The following
hardcoded input types are recognized:
-
KL
is the (default) audio observation module based on (multiple) pitch. -
HZ
refers to raw pitch input as control messages in the inlet (e.g. using fiddle\~ or yin\~ objects). -
MIDI
denotes to midi inputs.
You can also define your own inlets: by putting any other name after the
@inlets
operator you are telling Antescofo that this inlet is
accepting a LIST. By naming this inlet later in your score you can
assign Antescofo to use the right inlet, using the @inlet
to switch
the input stream.
Outlets¶
By default, there are three Antescofo’s outlets:
-
Main outlet
(for note index and messages), -
tempo
(BPM / Float), -
score label
(symbol) plus an additional BANG sent each time a new score is loaded.
Additional (predefined) outlets can be activated by naming them after
the @outlets
operator. The following codenames are recognized :
-
ANTEIOI
Anticipated IOI duration in ms and in runtime relative to detected tempo -
BEATNUM
Cumulative score position in beats -
CERTAINTY
Antescofo’s live certainty during detections [0,1] -
ENDBANG
Bang when the last (non-silence) event in the score is detected -
MIDIOUT
-
MISSED
-
NOTENUM
MIDI pitch number or sequenced list for trills/chords -
SCORETEMPO
Current tempo in the original score (BPM) -
TDIST
-
TRACE
-
VELOCITY
Predefined Messages¶
The Antescofo object accepts predefined message sent to antescofo-mess1. These messages correspond to the internal commands described in section internal command.
The setvar
command¶
See section setvar in the Reference Manual.
Sending and Receiving OSC messages¶
See section OSC message in the Reference Manual.
-
The tutorial patches in the Antescofo bundle, are good illustrations of the points sketched here. ↩