You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
212 lines
6.8 KiB
212 lines
6.8 KiB
/*
|
|
Rosegarden
|
|
A sequencer and musical notation editor.
|
|
|
|
This program is Copyright 2000-2008
|
|
Guillaume Laurent <glaurent@telegraph-road.org>,
|
|
Chris Cannam <cannam@all-day-breakfast.com>,
|
|
Richard Bown <bownie@bownie.com>
|
|
|
|
The moral right of the authors to claim authorship of this work
|
|
has been asserted.
|
|
|
|
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. See the file
|
|
COPYING included with this distribution for more information.
|
|
*/
|
|
|
|
#ifndef _MIDIDEVICE_H_
|
|
#define _MIDIDEVICE_H_
|
|
|
|
#include <string>
|
|
#include <vector>
|
|
|
|
#include "Device.h"
|
|
#include "Instrument.h"
|
|
#include "MidiProgram.h"
|
|
#include "ControlParameter.h"
|
|
#include "Controllable.h"
|
|
|
|
namespace Rosegarden
|
|
{
|
|
|
|
typedef std::vector<std::string> StringList;
|
|
typedef std::vector<MidiByte> MidiByteList;
|
|
|
|
class MidiDevice : public Device, public Controllable
|
|
{
|
|
public:
|
|
typedef enum
|
|
{
|
|
Play = 0,
|
|
Record = 1
|
|
} DeviceDirection;
|
|
|
|
typedef enum
|
|
{
|
|
NoVariations,
|
|
VariationFromLSB,
|
|
VariationFromMSB
|
|
} VariationType;
|
|
|
|
MidiDevice();
|
|
MidiDevice(const MidiDevice &);
|
|
MidiDevice(DeviceId id,
|
|
const MidiDevice &);
|
|
MidiDevice(DeviceId id,
|
|
const std::string &name,
|
|
DeviceDirection dir);
|
|
MidiDevice(DeviceId id,
|
|
const std::string &name,
|
|
const std::string &label,
|
|
DeviceDirection dir);
|
|
virtual ~MidiDevice();
|
|
|
|
// Assignment
|
|
MidiDevice &operator=(const MidiDevice &);
|
|
|
|
// Instrument must be on heap; I take ownership of it
|
|
virtual void addInstrument(Instrument*);
|
|
|
|
void removeMetronome();
|
|
void setMetronome(const MidiMetronome &);
|
|
const MidiMetronome* getMetronome() const { return m_metronome; }
|
|
|
|
void addProgram(const MidiProgram &program);
|
|
void addBank(const MidiBank &bank);
|
|
void addKeyMapping(const MidiKeyMapping &mapping); // I own the result!
|
|
|
|
void clearBankList();
|
|
void clearProgramList();
|
|
void clearControlList();
|
|
|
|
const BankList &getBanks() const { return m_bankList; }
|
|
BankList getBanks(bool percussion) const;
|
|
BankList getBanksByMSB(bool percussion, MidiByte msb) const;
|
|
BankList getBanksByLSB(bool percussion, MidiByte lsb) const;
|
|
|
|
MidiByteList getDistinctMSBs(bool percussion, int lsb = -1) const;
|
|
MidiByteList getDistinctLSBs(bool percussion, int msb = -1) const;
|
|
|
|
const ProgramList &getPrograms() const { return m_programList; }
|
|
ProgramList getPrograms(const MidiBank &bank) const;
|
|
|
|
const KeyMappingList &getKeyMappings() const { return m_keyMappingList; }
|
|
const MidiKeyMapping *getKeyMappingByName(const std::string &) const;
|
|
const MidiKeyMapping *getKeyMappingForProgram(const MidiProgram &program) const;
|
|
void setKeyMappingForProgram(const MidiProgram &program, std::string mapping);
|
|
|
|
std::string getBankName(const MidiBank &bank) const;
|
|
std::string getProgramName(const MidiProgram &program) const;
|
|
|
|
void replaceBankList(const BankList &bank);
|
|
void replaceProgramList(const ProgramList &program);
|
|
void replaceKeyMappingList(const KeyMappingList &mappings);
|
|
|
|
void mergeBankList(const BankList &bank);
|
|
void mergeProgramList(const ProgramList &program);
|
|
void mergeKeyMappingList(const KeyMappingList &mappings);
|
|
|
|
virtual InstrumentList getAllInstruments() const;
|
|
virtual InstrumentList getPresentationInstruments() const;
|
|
|
|
// Retrieve Librarian details
|
|
//
|
|
const std::string getLibrarianName() const { return m_librarian.first; }
|
|
const std::string getLibrarianEmail() const { return m_librarian.second; }
|
|
std::pair<std::string, std::string> getLibrarian() const
|
|
{ return m_librarian; }
|
|
|
|
// Set Librarian details
|
|
//
|
|
void setLibrarian(const std::string &name, const std::string &email)
|
|
{ m_librarian = std::pair<std::string, std::string>(name, email); }
|
|
|
|
DeviceDirection getDirection() const { return m_direction; }
|
|
void setDirection(DeviceDirection dir) { m_direction = dir; }
|
|
|
|
VariationType getVariationType() const { return m_variationType; }
|
|
void setVariationType(VariationType v) { m_variationType = v; }
|
|
|
|
// Controllers - for mapping Controller names to values for use in
|
|
// the InstrumentParameterBoxes (IPBs) and Control rulers.
|
|
//
|
|
ControlList::const_iterator beginControllers() const
|
|
{ return m_controlList.begin(); }
|
|
ControlList::const_iterator endControllers() const
|
|
{ return m_controlList.end(); }
|
|
|
|
// implemented from Controllable interface
|
|
//
|
|
virtual const ControlList &getControlParameters() const { return m_controlList; }
|
|
|
|
// Only those on the IPB list
|
|
//
|
|
ControlList getIPBControlParameters() const;
|
|
|
|
// Access ControlParameters (read/write)
|
|
//
|
|
virtual ControlParameter *getControlParameter(int index);
|
|
virtual const ControlParameter *getControlParameter(int index) const;
|
|
virtual ControlParameter *getControlParameter(const std::string &type, MidiByte controllerNumber);
|
|
virtual const ControlParameter *getControlParameter(const std::string &type, MidiByte controllerNumber) const;
|
|
|
|
// Modify ControlParameters
|
|
//
|
|
void addControlParameter(const ControlParameter &con);
|
|
void addControlParameter(const ControlParameter &con, int index);
|
|
bool removeControlParameter(int index);
|
|
bool modifyControlParameter(const ControlParameter &con, int index);
|
|
|
|
void replaceControlParameters(const ControlList &);
|
|
|
|
// Check to see if the passed ControlParameter is unique in
|
|
// our ControlParameter list.
|
|
//
|
|
bool isUniqueControlParameter(const ControlParameter &con) const;
|
|
|
|
// Generate some default controllers for the MidiDevice
|
|
//
|
|
void generateDefaultControllers();
|
|
|
|
virtual std::string toXmlString();
|
|
|
|
// Accessors for recording property
|
|
bool isRecording() {return m_recording; }
|
|
void setRecording(bool recording) {m_recording = recording;}
|
|
|
|
protected:
|
|
void generatePresentationList();
|
|
|
|
ProgramList m_programList;
|
|
BankList m_bankList;
|
|
ControlList m_controlList;
|
|
KeyMappingList m_keyMappingList;
|
|
MidiMetronome *m_metronome;
|
|
|
|
// used when we're presenting the instruments
|
|
InstrumentList m_presentationInstrumentList;
|
|
|
|
// Is this device Play or Record?
|
|
//
|
|
DeviceDirection m_direction;
|
|
|
|
// Is this device recording?
|
|
//
|
|
bool m_recording;
|
|
|
|
// Should we present LSB or MSB of bank info as a Variation number?
|
|
//
|
|
VariationType m_variationType;
|
|
|
|
// Librarian contact details
|
|
//
|
|
std::pair<std::string, std::string> m_librarian; // name. email
|
|
};
|
|
|
|
}
|
|
|
|
#endif // _MIDIDEVICE_H_
|