MBANDEDWG()

MBANDEDWG

Banded-waveguide physical model.

in RTcmix/insts/stk

quick syntax:

MBANDEDWG(outsk, dur, AMP, FREQ, strikepos, pluckflag, maxvel, preset, BOWPRESSURE, RESONANCE, INTEGRATION[, PAN, VELOCITYENV])

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.

Param Field	Parameter	Units	Dynamic	Optional	Notes
p0	output start time	seconds	no	no
p1	duration	seconds	no	no
p2	amplitude	absolute, for 16-bit soundfiles: 0-32768	yes	no
p3	frequency	Hz	yes	no
p4	strike position	0.0-1.0	no	no
p5	pluck flag	0: no pluck, 1: pluck	no	no
p6	max velocity	0.0-1.0	no	no
p7	preset #	-	no	no	preset values listed below
p8	bow pressure	0.0-1.0	yes	no	0.0 == strike onl
p9	mode resonance	0.0-1.0	yes	no	0.99 == normal strik
p10	integration constant	0.0-1.0	yes	no	0.0 == normal
p11	pan	0-1 stereo; 0.5 is middle	yes	yes	default: 0.5
p12	velocity envelope	reference to a pfield table-handle	yes	yes	if 0, default value is 1.0

Parameters labled as Dynamic can receive dynamic updates from a table or real-time control source.

Author: Brad Garton, based on code from the Synthesis ToolKit

p7 Preset values

Uniform Bar = 0
Tuned Bar = 1
Glass Harmonica = 2
Tibetan Bowl = 3

MBANDEDWG is the “BandedWG” physical model in Perry Cook and Gary Scavone’s STK, the Synthesis ToolKit.

Usage Notes

MBANDEDWG is a physical model instrument that recreates the sounds of struck and bowed modal/metal objects (xylophones, glass harmonicas, Tibetan bowls, etc.).

The description that Perry Cook (and Georg Essl on this one) give about the “BandedWG” physical model:

Parameter p5 (“pluckflag”) is used to determine if the model will be activated by an impulse. p4 (“strikepos”) is used to set how the impulse will activate the model). Setting p5 to 0 allows the ‘bow pressure’ (p8, “BOWPRESSURE”), the ‘maximum velocity’ (p6, “maxvel”) and the ‘velocity envelope’ (p12, “VELOCITYENV”) to operate. By modulating p12, the sound of a bowed metal bar can be produced.

The preset selected using p7 (“preset”) configures the model for different sounds. p9 (“RESONANCE”) and p10 (“INTEGRATION”) also alter characteristics of the model.

MBANDEDWG can produce other mono or stereo output.

Sample Scores

very basic:

   rtsetparams(44100, 2)
   load("MBANDEDWG")

   amp = 20000
   ampenv = maketable("line", 1000, 0,1, 2,0)

   MBANDEDWG(0, 5.0, amp*ampenv, cpspch(8.04), 0.3, 1, 0.5, 3, 0.0, 1.0, 0.0)

   velocityenv = maketable("line", 1000, 0,1, 2,0)
   MBANDEDWG(6, 5.0, amp*ampenv, cpspch(8.04), 0.3, 0, 0.5, 3, 0.3, 0.2, 0.8, 0.5, velocityenv)

slightly more advanced:

   rtsetparams(44100, 2)
   load("MBANDEDWG")

   amp = 10000
   ampenv = maketable("line", 1000, 0,1, 1,0)

   pitches  = { 8.00, 8.02, 8.04, 8.05, 8.07, 8.08, 8.10, 9.00 }
    lpitches = len(pitches)

   st = 0.0
   for (i = 0; i < 50; i = i+1)
   {
      index = trand(0, lpitches)
      pch = pitches[index]
      MBANDEDWG(st, 1.0, amp*ampenv, cpspch(pch), 0.3, 1, 0.5, 0, 0.0, 1.0, 0.0, random())
      st = st + 0.1
   }

   for (i = 0; i < 50; i = i+1)
   {
      index = trand(0, lpitches)
      pch = pitches[index]
      MBANDEDWG(st, 1.0, amp*ampenv, cpspch(pch), 0.3, 1, 0.5, 1, 0.0, 1.0, 0.0, random())
      st = st + 0.15
   }

   for (i = 0; i < 50; i = i+1)
   {
      index = trand(0, lpitches)
      pch = pitches[index]
      MBANDEDWG(st, 1.0, amp*ampenv, cpspch(pch), 0.3, 1, 0.5, 2, 0.0, 1.0, 0.0, random())
      st = st + 0.2
   }

   for (i = 0; i < 50; i = i+1)
   {
      index = trand(0, lpitches)
      pch = pitches[index]
      MBANDEDWG(st, 1.0, amp*ampenv, cpspch(pch), 0.3, 1, 0.5, 3, 0.0, 1.0, 0.0, random())
      st = st + 0.25
   }

MBANDEDWG

quick syntax:

p7 Preset values

Usage Notes

Sample Scores

See Also