13
0
livetrax/libs/midi++2/midi++/manager.h
David Robillard e0aaed6d65 *** NEW CODING POLICY ***
All #include statements that include a header that is a part of a library
bundled with ardour MUST use quotes, not angle brackets.

Do this:

#include "ardour/types.h"

NOT this:

#include <ardour/types.h>

Rationale:

This is best practice in general, to ensure we include the local version
and not the system version.  That quotes mean "local" (in some sense)
and angle brackets mean "system" (in some sense) is a ubiquitous
convention and IIRC right in the C spec somewhere.

More pragmatically, this is required by (my) waf (stuff) for dependencies
to work correctly.  That is:

!!! FAILURE TO DO THIS CAN RESULT IN BROKEN BUILDS !!!

Failure to comply is punishable by death by torture. :)

P.S. It's not that dramatic in all cases, but this (in combination with some
GCC flags specific to the include type) is the best way I have found to be
absolutely 100% positive the local ones are being used (and we definitely
want to be absolutely 100% positive on that one).


git-svn-id: svn://localhost/ardour2/branches/3.0@4655 d708f5d6-7413-0410-9779-e7cbd77b26cf
2009-02-25 18:26:51 +00:00

104 lines
2.5 KiB
C++

/*
Copyright (C) 1998 Paul Barton-Davis
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; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
*/
#ifndef __midi_manager_h__
#define __midi_manager_h__
#include <map>
#include <vector>
#include <string>
#include "midi++/types.h"
#include "midi++/port.h"
namespace MIDI {
class Manager {
public:
~Manager ();
void set_api_data(void* data) { api_data = data; }
/** Signal the start of an audio cycle.
* This MUST be called before any reading/writing for this cycle.
* Realtime safe.
*/
void cycle_start(nframes_t nframes);
/** Signal the end of an audio cycle.
* This signifies that the cycle began with @ref cycle_start has ended.
* This MUST be called at the end of each cycle.
* Realtime safe.
*/
void cycle_end();
Port *add_port (const XMLNode& node);
int remove_port (Port*);
Port *port (std::string name);
size_t nports () { return ports_by_device.size(); }
/* defaults for clients who are not picky */
Port *inputPort;
Port *outputPort;
channel_t inputChannelNumber;
channel_t outputChannelNumber;
int set_input_port (std::string);
int set_output_port (std::string);
int set_input_channel (channel_t);
int set_output_channel (channel_t);
int foreach_port (int (*func)(const Port &, size_t n, void *),
void *arg);
typedef std::map<std::string, Port *> PortMap;
const PortMap& get_midi_ports() const { return ports_by_tag; }
static Manager *instance () {
if (theManager == 0) {
theManager = new Manager;
}
return theManager;
}
int get_known_ports (std::vector<PortSet>&);
private:
/* This is a SINGLETON pattern */
Manager ();
static Manager *theManager;
PortMap ports_by_device; /* canonical */
PortMap ports_by_tag; /* may contain duplicate Ports */
void* api_data;
void close_ports ();
};
} // namespace MIDI
#endif // __midi_manager_h__