Musical Bands API

The Musical Bands widget simply requires two things:

  1. The application must have an SdgManager control
  2. Configuration through the widget properties

SdgManager Control

  • This control must exist somewhere within the application and must be active. Other than that, there are no configuration settings which the MusicalBands widget relies on.

Configuration

  • All configuration of the MusicalBands widget can be completed through the properties dialog in visual studios:
    • Color - This property sets the color of the elastic band to any available colour on the system.
    • LengthMin - Sets the minimum length (in screen pixels) of the elastic band. It will not be alowed to shrink beyond this.
    • MIDIChannel - Sets which MIDI channel (0-15) that the sound should be played on. Note that each instrument should have its own MIDI channel in order for the stretching effects and varying instrument sounds to work properly. However, sharing a channel will not break the widget.
    • MIDIInstrument - Sets the instrument of the elastic band to any general midi instrument.
    • MININoteBase - Sets the lowest note that the elastic band will generate. From here, the highest note is dependent on the length of the band.


These properties can be changed at runtime. However, changing the MIDI Channel or MIDI Instrument may have undesireable effects such as not destroying a sustaining note when creating a new one.