lmms/include/midi.h

/*
 * midi.h - constants, structs etc. concerning MIDI
 *
 * Copyright (c) 2005-2013 Tobias Doerffel <tobydox/at/users.sourceforge.net>
 *
 * This file is part of Linux MultiMedia Studio - http://lmms.sourceforge.net
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public
 * License as published by the Free Software Foundation; either
 * version 2 of the License, or (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * General Public License for more details.
 *
 * You should have received a copy of the GNU General Public
 * License along with this program (see COPYING); if not, write to the
 * Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
 * Boston, MA 02110-1301 USA.
 *
 */

#ifndef _MIDI_H
#define _MIDI_H

#include "lmms_basics.h"
#include "panning_constants.h"
#include <cstdlib>


enum MidiEventTypes
{
	// messages
	MidiNoteOff = 0x80,
	MidiNoteOn = 0x90,
	MidiKeyPressure = 0xA0,
	MidiControlChange = 0xB0,
	MidiProgramChange = 0xC0,
	MidiChannelPressure = 0xD0,
	MidiPitchBend = 0xE0,
	// system exclusive
	MidiSysEx= 0xF0,
	// system common - never in midi files
	MidiTimeCode= 0xF1,
	MidiSongPosition = 0xF2,
	MidiSongSelect = 0xF3,
	MidiTuneRequest = 0xF6,
	MidiEOX= 0xF7,
	// system real-time - never in midi files
	MidiSync = 0xF8,
	MidiTick = 0xF9,
	MidiStart = 0xFA,
	MidiContinue = 0xFB,
	MidiStop = 0xFC,
	MidiActiveSensing = 0xFE,
	MidiSystemReset = 0xFF,
	// meta event - for midi files only
	MidiMetaEvent = 0xFF
} ;

enum MidiMetaEvents
{
	MidiMetaInvalid = 0x00,
	MidiCopyright = 0x02,
	MidiTrackName = 0x03,
	MidiInstName = 0x04,
	MidiLyric = 0x05,
	MidiMarker = 0x06,
	MidiCuePoint = 0x07,
	MidiPortNumber = 0x21,
	MidiEOT = 0x2f,
	MidiSetTempo = 0x51,
	MidiSMPTEOffset = 0x54,
	MidiTimeSignature = 0x58,
	MidiKeySignature = 0x59,
	MidiSequencerEvent = 0x7f,
	MidiMetaCustom = 0x80,
	MidiNotePanning
} ;


enum MidiStandardControllers
{
	MidiControllerBankSelect = 0,
	MidiControllerModulationWheel = 1,
	MidiControllerBreathController = 2,
	MidiControllerFootController = 4,
	MidiControllerPortamentoTime = 5,
	MidiControllerMainVolume = 7,
	MidiControllerBalance = 8,
	MidiControllerPan = 10,
	MidiControllerEffectControl1 = 12,
	MidiControllerEffectControl2 = 13,
	MidiControllerSustain = 64,
	MidiControllerPortamento = 65,
	MidiControllerSostenuto = 66,
	MidiControllerSoftPedal = 67,
	MidiControllerLegatoFootswitch = 68,
	// Channel Mode Messages are controllers too...
	MidiControllerAllSoundOff = 120,
	MidiControllerResetAllControllers = 121,
	MidiControllerLocalControl = 122,
	MidiControllerAllNotesOff = 123,
	MidiControllerOmniOn = 124,
	MidiControllerOmniOff = 125,
	MidiControllerMonoOn = 126,
	MidiControllerPolyOn = 127,

};

const int MidiChannelCount = 16;
const int MidiControllerCount = 128;
const int MidiProgramCount = 128;
const int MidiMaxVelocity = 127;
const int MidiMaxControllerValue = 127;
const int MidiMaxNote = 127;

const int MidiMaxPanning = 127;
const int MidiMinPanning = -128;


struct midiEvent
{
	midiEvent( MidiEventTypes _type = MidiActiveSensing,
			int8_t _channel = 0,
			int16_t _param1 = 0,
			int16_t _param2 = 0,
			const void * _sourcePort = NULL ) :
		m_type( _type ),
		m_metaEvent( MidiMetaInvalid ),
		m_channel( _channel ),
		m_sysExData( NULL ),
		m_sourcePort( _sourcePort ),
		m_fromMidiPort( false )
	{
		m_data.m_param[0] = _param1;
		m_data.m_param[1] = _param2;
	}

	midiEvent( MidiEventTypes _type, const char * _sysex_data,
							int _data_len ) :
		m_type( _type ),
		m_metaEvent( MidiMetaInvalid ),
		m_channel( 0 ),
		m_sysExData( _sysex_data ),
		m_sourcePort( NULL ),
		m_fromMidiPort( false )
	{
		m_data.m_sysExDataLen = _data_len;
	}

	midiEvent( const midiEvent & _copy ) :
		m_type( _copy.m_type ),
		m_metaEvent( _copy.m_metaEvent ),
		m_channel( _copy.m_channel ),
		m_data( _copy.m_data ),
		m_sysExData( _copy.m_sysExData ),
		m_sourcePort( _copy.m_sourcePort ),
		m_fromMidiPort( _copy.m_fromMidiPort )
	{
	}

	inline MidiEventTypes type() const
	{
		return m_type;
	}

	inline int channel() const
	{
		return m_channel;
	}

	inline int16_t key() const
	{
		return m_data.m_param[0];
	}

	inline int16_t & key()
	{
		return m_data.m_param[0];
	}

	inline uint8_t controllerNumber() const
	{
		return m_data.m_param[0];
	}

	inline uint8_t controllerValue() const
	{
		return m_data.m_param[1];
	}

	inline int16_t velocity() const
	{
		return m_data.m_param[1];
	}

	inline int16_t & velocity()
	{
		return m_data.m_param[1];
	}

	inline int16_t midiPanning() const
	{
		return m_data.m_param[1];
	}

	inline volume_t getVolume() const
	{
		return (volume_t)( velocity() * 100 / MidiMaxVelocity );
	}

	inline const void * sourcePort() const
	{
		return m_sourcePort;
	}

	inline panning_t getPanning() const
	{
		return (panning_t) ( PanningLeft +
			( (float)( midiPanning() - MidiMinPanning ) ) / 
			( (float)( MidiMaxPanning - MidiMinPanning ) ) *
			( (float)( PanningRight - PanningLeft ) ) );
	}

	void setFromMidiPort( bool enabled )
	{
		m_fromMidiPort = enabled;
	}

	bool isFromMidiPort() const
	{
		return m_fromMidiPort;
	}

	MidiEventTypes m_type;		// MIDI event type
	MidiMetaEvents m_metaEvent;	// Meta event (mostly unused)
	int8_t m_channel;		// MIDI channel
	union
	{
		int16_t m_param[2];	// first/second parameter (key/velocity)
		uint8_t m_bytes[4];		// raw bytes
		int32_t m_sysExDataLen;	// len of m_sysExData
	} m_data;

	const char * m_sysExData;
	const void * m_sourcePort;


private:
	bool m_fromMidiPort;

} ;


#endif