System.MIDI.Base

The hardware-independent part of the MIDI binding.

Documentation

type TimeStamp = Word32

data MidiMessage'

A "regular" MIDI message.

Remark: According to the MIDI standard, NoteOff also has a velocity. However, most keyboards do not use this feature (send the default value 64), and there are keyboards which do not send NoteOff messages at all, but send NoteOn messages with zero velocity instead (for example the EMU Xboard series). At the moment, the code auto-translates NoteOn messages with zero velocity to NoteOff messages with velocity 64. This behaviour can be inverted with the Cabal flag noNoteOff, which translates all NoteOff messages to NoteOn messages with velocity 0.

Constructors

NoteOff !Int !Int

Note Off (key, velocity)

NoteOn !Int !Int

Note On (key, velocity)

PolyAftertouch !Int !Int

Polyphonic key pressure (key, pressure)

CC !Int !Int

Control Change (controller, value)

ProgramChange !Int

Program Change (program)

Aftertouch !Int

Global aftertouch (pressure)

PitchWheel !Int

Pitch wheel (value, from -8192..+8191)

Instances

Eq MidiMessage'

Defined in System.MIDI.Base

Methods

(==) :: MidiMessage' -> MidiMessage' -> Bool

(/=) :: MidiMessage' -> MidiMessage' -> Bool

Show MidiMessage'

Defined in System.MIDI.Base

Methods

showsPrec :: Int -> MidiMessage' -> ShowS

show :: MidiMessage' -> String

showList :: [MidiMessage'] -> ShowS

data MidiMessage

The type representing a MIDI message.

Constructors

MidiMessage !Int !MidiMessage'

first argument is the MIDI channel (1..16)

SysEx [Word8]

not including the bytes 0xf0, 0xf7

SongPosition !Int

measured in "MIDI beats" (1/16th notes).

SongSelect !Int

TuneRequest

SRTClock

clock is sent 24 times per quarter note

SRTStart

SRTContinue

SRTStop

ActiveSensing

Reset

Undefined

Instances

Eq MidiMessage

Defined in System.MIDI.Base

Methods

(==) :: MidiMessage -> MidiMessage -> Bool

(/=) :: MidiMessage -> MidiMessage -> Bool

Show MidiMessage

Defined in System.MIDI.Base

Methods

showsPrec :: Int -> MidiMessage -> ShowS

show :: MidiMessage -> String

showList :: [MidiMessage] -> ShowS

data MidiEvent

The type representing a timestamped MIDI message. Time is measured in milisecs elapsed since the last call to start.

Constructors

MidiEvent !TimeStamp !MidiMessage

Instances

Eq MidiEvent

Defined in System.MIDI.Base

Methods

(==) :: MidiEvent -> MidiEvent -> Bool

(/=) :: MidiEvent -> MidiEvent -> Bool

Show MidiEvent

Defined in System.MIDI.Base

Methods

showsPrec :: Int -> MidiEvent -> ShowS

show :: MidiEvent -> String

showList :: [MidiEvent] -> ShowS

type ClientCallback = MidiEvent -> IO ()

Type of the user callback function.

data ShortMessage

Low level stuff.

Constructors

ShortMessage

Fields

• sm_channel :: Word8
• sm_msg :: Word8
• sm_byte1 :: Word8
• sm_byte2 :: Word8

Instances

Show ShortMessage

Defined in System.MIDI.Base

Methods

showsPrec :: Int -> ShortMessage -> ShowS

show :: ShortMessage -> String

showList :: [ShortMessage] -> ShowS

translateShortMessage :: ShortMessage -> MidiMessage

untranslateShortMessage :: MidiMessage -> ShortMessage

shortMessage :: Int -> Int -> Int -> Int -> ShortMessage

data MidiException

Constructors

MidiException String

Instances

Show MidiException

Defined in System.MIDI.Base

Methods

showsPrec :: Int -> MidiException -> ShowS

show :: MidiException -> String

showList :: [MidiException] -> ShowS

Exception MidiException

Defined in System.MIDI.Base

Methods

toException :: MidiException -> SomeException

fromException :: SomeException -> Maybe MidiException

displayException :: MidiException -> String