Digital Orchestra Toolbox

Authors: Joseph Malloch, Stephen Sinclair, Marlon Schumacher

This “toolbox” is a collection of Max/MSP objects that we have found useful in creating gesture processing patches for digital musical instruments. Each patch is accompanied with a help patch to demonstrate its use.

Download:

Current Dependencies:

  • Two objects from the Jamoma project
    • jcom.oscroute
    • jmod.change (Max4.6 version only)

Older Versions:*

Patch Name Function
dot.3dpolar Converts xyz to amplitude, angle, and elevation.
dot.addresscoll A coll wrapper for storing and managing OSC addresses and associated properties.
dot.admin Takes care of all mapping and network communications for the Digital Orchestra DMIs and synths.
dot.alloc Using a shared bus, deliberate to allocate a unique identifier.
dot.alloc2 Using a shared bus, deliberate to allocate a unique identifier. Peer with root index suggests identifiers to newcomers.
dot.appendaddr Append text to the end of the first item of a list.
dot.asyncdemod~ Asynchrouous demodulation of baseband signal from an AM-carrier.
dot.atoi Convert a symbol that starts with a decimal number to an integer.
dot.attackslope Given two thresholds, determine the slope between the points at which they are crossed in the positive direction. (i.e., attack speed)
dot.autoexpr User-definable expr-based scaling with autoscale and mapper-compatible output. (replaced by dot.dynamicexpr)
dot.autoscale Rescales signals according to auto-detected maximum and minimum values.
dot.autoscale~ Automatically scale incoming signal to a defined output-range.
dot.bitstobyte Converts 8 bits into a single decimal byte.
dot.bus Patcher-local communications.
dot.bytetobits Converts a single decimal byte into 8 binary bits.
dot.centre Automatically offsets input to re-centre signal around zero, with user-definable delay, ramp time, and time grain.
dot.channelthresh Combines ID-tagged channels into lists using a delay threshold. Like “thresh,” but keeps channel information.
dot.clip Clips a stream of numbers to a minimum, maximum, or both.
dot.combinote Combines 8 input signals into a single value such that any given combination will be a unique number.
dot.dampedenvelope Audio-rate envelope-generator with damping.
dot.debounce Filters multiple messages.
dot.distance Finds maximum or minimum distance between a scalar and a list.
dot.dynamicexpr User-definable expr-based scaling with autoscale and dot mapper compatible output.
dot.extrema Outputs values of local maxima and minima.
dot.fraction Looks at divisions of a list and outputs the highest value corresponding to nodes at 2 3 4 5 and 6 part divisions. Intended for use with dot.harmonicfilter.
dot.fromsignal~ Samples a signal triggered by change.
dot.getindex Retrieves indexes of data entries that match the query.
dot.harmonicfilter For damping gains in modal synthesis based on a harmonic series. Handles “string division” at 0.5, 0.3, 0.25, 0.2, 0.167
dot.history Outputs list of delayed samples: x[n], x[n-1], …, x[n-m].
dot.hz↔smp~ Converts between frequency in hz (cycles/second) and samples/cycle.
dot.index Generates the lowest unused index (for coll storage). Argument sets maximum index.
dot.interpolate4~ A sort of spectral interpolation of 4 signals via magnitude and phase vector.
dot.leakyintegrator An accumulator with a hole in it. The leakiness is highly customizable.
dot.line A wrapper for the line object so it accepts breakpoint trajectory lists like line~.
dot.listinterpolate Interpolates/extrapolates between two lists of equal length.
dot.listinterpolate4 The same for four lists.
dot.listpipe Delays a stream of input like pipe, but also works for lists.
dot.mappingcoll A coll wrapper for storing and managing mapping information.
dot.mass-spring Implements a simple mass–spring-damper model.
dot.median Outputs median value of a user-definable sample size.
dot.midiout Helper for quickly configuring MIDI output.
dot.mix4~ Mixes four signals via XY-coordinates.
dot.namealloc Using a multicast OSC bus, deliberate to allocate a unique device number with the given root.
dot.namespaceparse A regexp-based function for reading device definitions formatted as XML and dumping them into a coll.
dot.OSCcompress Simply removes spaces in OSC address strings.
dot.OSCexpand Simply expands OSC address strings so that the route object can parse them.
dot.OSCroute A wrapper for jmod.oscroute allowing multiple OSC addresses to be dynamically added and removed.
dot.phase→freq~ Instantaneous frequency estimation from phase deltas.
dot.playabsolute Play files recorded by dot.recordabsolute.
dot.polar Converts x/y into amplitude and angle. Change in angle with wrap-around correction is also calculated.
dot.portalloc Using a multicast OSC bus, deliberate to allocate a unique port number.
dot.prependaddr Prepend text to the beginning of the first item of a list.
dot.probgate A probabilistic gate with remote control.
dot.properties regexp wrapper for parsing tagged message properties expressed in the form @<label> <data>. Second outlet outputs number of backreferences.
dot.rad→norm~ Scales 2pi-radians to normalized range (0-1) with optional wraparound.
dot.recordabsolute Record an arbitrary number of datastreams with absolute timestamping.
dot.reg Like “zl reg” but right outlet bangs when empty.
dot.region Outputs and centre of multiple selected areas of a list (binary).
dot.repeat Repeats a message a sqecified number of times.
dot.route~ Separates signals from max-messages.
dot.router Performs OSC namespace translation, scaling, and clipping for an arbitrary number of mapping connections.
dot.scale~ MSP version of the Max scale-object (with 'proper' exponent).
dot.schmitt A trigger with hysteresis.
dot.schmitt~ Detect triggers from envelope of a signal.
dot.serial An abstraction containing the serial object, with menu generation and built-in polling and repeated-reading functionality.
dot.sintrack~ Track magnitude, instantaneous phase, and instantaneous freq. of a sinusoid.
dot.signaccum Accumulates positive vs. negative same-sign deltas.
dot.slipdecode Parses slip-encoded data with user-defined delimiter and escape character.
dot.slipencode Encodes data using slip-coding with user-defined delimiter and escape character.
dot.slope Output the slope between each successive point.
dot.smooth Simple sample-averaging filter.
dot.squeuedlim Limits the speed of messages passing through like speedlim, but queued like zl queue.
dot.swap Like the swap object, but for symbols and lists too!
dot.thresh A little hack to allow thresh to work with symbols.
dot.threshtrig Output a value only once after passing the threshold in the positive or negative directions.
dot.timedextrema Outputs the minimum and maximum value received with the last n milliseconds.
dot.timedsmooth Downsampled audio-rate averaging filter.
dot.transfer Table-based waveshaping with customizable transfer function.
dot.typecheck The dot.typecheck object routes input according to data type
dot.unwrap Assumes input is polar and lies between arg1 and arg2. Output is the shortest polar distance from the last sample.
dot.vscale Just like the scale object, but also for vectors. Includes clipping feature.
dot.wrap Simple offset with wrap-around.
dot.xmlread2 A native-Max XML parser - no externals!
dot.xmlwrite2 A native-Max XML parser - no externals!
 
Copyright © McGill University, All rights reserved.