MMOVE

Moving source room-simulation.

in RTcmix/insts/std/MMOVE

quick syntax:

MMOVE(outskip, inskip, dur, AMP, dist_between_mikes[, inputchan])

RVB(outsk, insk, dur, AMP)

space(front, right, -back, -left, ceiling, absorb, rvbtime)

path(time0, sound_dist0, sound_angle0, … timeN, sound_distN, sound_angleN)

cpath(time0, sound_x-coord0, sound_y-coord0, … timeN, sound_x-coordN, sound_y-coordN)

param(function1, function2)

cparam(function1, function2)

threshold(update_rate)

mikes(mike_angle, pattern)

mikes_off()

set_attenuation_params(min_dist, max_dist, dist_exponent)

matrix(amp, matrixval1, matrixval2, … matrixval144)

CAPITALIZED parameters are pfield-enabled for table or dynamic control (see the maketable or makeconnection scorefile commands). Parameters after the [bracket] are optional and default to 0 unless otherwise noted.

MMOVE employs several subcommands to set the room-simulation characteristics, the sound-source trajectory and one sub-instrument (RVB) to operate.

NOTE: This is an old RTcmix instrument. If you wish to dynamically control the location of a sound source, use the newer DMOVE instrument which allows the sound trajectory to be controlled using pfield-enabled parameters.

MMOVE

p3 (amplitude) can receive dynamic updates from a table or real-time control source.

RVB

NOTE: this associated instrument is required for MMOVE to function

space

NOTE: this subcommand is required for MMOVE to function

path

The pfields for path are triples:

Up to 100 triples may be specified.

cpath

The pfields for cpath are triples:

Up to 100 triples may be specified.

NOTE: one of the subcommands (path, cpath, param, cparam) is required for MMOVE to function

param

The two function tables are loaded with values representing the polar coordinates of the sound source location (p0 table == distance to sound [feet] and p1 table == angle to sound [degrees]). These values will be spread over the duration of the note

Because this instrument has not been updated for pfield control, the older makegen function table system should be used to create the tables.

NOTE: one of the subcommands (path, cpath, param, cparam) is required for MMOVE to function

cparam

The two function tables are loaded with values representing the x-coordinate location of the sound source (feet) and the y-coordinate location of the sound source (feet). The listener is assumed to be centered at coordinate [0,0]. These values will be spread over the duration of the note

Because this instrument has not been updated for pfield control, the older makegen function table system should be used to create the tables.

NOTE: one of the subcommands (path, cpath, param, cparam) is required for MMOVE to function

threshold

NOTE: this subcommand is optional for MMOVE to function. Default is RTBUFSAMPS/SR (both set in rtsetparams).

mikes

NOTE: this subcommand is optional for MMOVE to function (the default is “mikes_off”)

mikes_off

No pfields. This turns off the microphone angle and pattern settings to allow binaural simulation.

NOTE: this subcommand is optional for MMOVE to function

set_attenuation_params

NOTE: this subcommand is optional for MMOVE to function

matrix

NOTE: this subcommand is optional for MMOVE to function

MMOVE is an updated version of the original MOVE room-simulation program. It uses the same methodology as the MPLACE instrument to model the acoustics of a room. The difference is that MMOVE allows you to specify a trajectory for the sound source instead of a single, fixed location for the duration of processing.

NOTE: This is an older RTcmix instrument, the newer DMOVE instrument allows the sound trajectory to be controlled using pfield-enabled parameters.

Usage Notes

Most of the subcommands for MMOVE are identical to the equivalent subcommands in MPLACE. See the MPLACE Usage Notes for more information.

The new subcommands in MMOVE (path, cpath, param, cparam) relate to specifying the sound source trajectory over the duration of processing. The parameters should be self-explanatory; you set the coordinate locations for the sound source (in polar or cartesian coordinates) at relative times and the instrument will calculate the movement trajectory to intersect these points. For higher rates of speed the delay-line interpolation used in MMOVE will effectively simulate a Doppler shift in all the calculated sound paths. Be careful, it is easy to inadvertently create high rates of speed for the sound source!

The threshold rate will determine how often the various delay lengths and attentuation factors are calculated, based on where the sound source location has moved along the trajectory. This rate is independent of the reset rate used for pfield updates.

The RVB subinstrument needs to be configured with the appropriate bus_config setup. MPLACE/RVB requires stereo output.

Sample Scores

basic use:

   rtsetparams(44100, 2, 1024)
   load("MMOVE")

   bus_config("MMOVE", "in 0", "aux 0-1 out")
   bus_config("RVB", "aux 0-1 in", "out 0-1")
   
   rtinput("mysoundfile.wav")

   mikes(45, 0.5)
   
   dist_front = 100
   dist_right = 130
   dist_rear = -145
   dist_left = -178
   height = 100
   rvbtime = 2
   abs_fac = 4
   space(dist_front, dist_right, dist_rear, dist_left, height, abs_fac, rvbtime)
   
   /* 5 feet is min distance,  100 feet max,  scale by 1/distance**1.5 */
   set_attenuation_params(5.0, 100.0, 1.5);
   
   insk = 0
   outsk = 0
   dur = 15;
   pre_amp = 25
   dist_mikes = 2.2     /* for normal */
   //dist_mikes = 0.67  /* for binaural */
   inchan = 0
   
   threshold(0.0005)
   
   // slow,  then zoom in and out again
   path(0,50,-90, 10,50,0, 11,10,20, 12,80,30, 15,30,90)
   
   // MMOVE does not have rvb level arg that MOVE had.  Handled in RVB call now
   MMOVE(outsk, insk, dur, pre_amp, dist_mikes, inchan)
   
   // Reverb gain increases over time
   handle rvblevel
   rvblevel = maketable("line", 1024, 0, 0.01, 1, 1.0);
   RVB(0, 0, dur+rvbtime+0.5, rvblevel)

See Also

DMOVE, FREEVERB, GVERB, MOVE, MPLACE, MROOM, PLACE, REV, REVERBIT, ROOM, SROOM