Class:            Amplitude

Environment:      Siren
Superclass:         Siren.Ergon
Category:         Music-Models-Representation

Instances of classes whose species is Amplitude are used for the loudness parameters of musical events.
Amplitudes come in several flavors, as in the classes RatioMagnitude, MIDIVelocity and SymbolicLoudness.
The class Amplitude is abstract, its class creation method answers an instance of a concrete Amplitude/Loudness class.

Examples:
   Amplitude value: 0.77      "create a ratio instance - range 0.0 to 1.0 (cmusic)"
   Amplitude value: 77      "create an MIDI instance - range 0 to 127"
   Amplitude value: #mp      "create a symbolic instance - range #ppp to #fff"

See also the class example.

MetaClass:         Amplitude class

instance creation

value: aValue
   Answer a new instance of a member of my species.

class constants

color
   Answer the default color to display instances with.

initialize
   Set up the class inst var, a generality table.

initializeGenerality
   Set up the class inst var, a generality table.

mostGeneral
   Answer the most general-purpose duration--relative

propertyName
   Answer the receiver class's default property name.

relativeMember
   Answer the receiver class's species member used as a relative magnitude.

species
   Answer Amplitude.

examples

example
   Print a simple message to the transcript demonstrating the various types.