X-Git-Url: https://main.carlh.net/gitweb/?a=blobdiff_plain;f=libs%2Fmidi%2B%2B2%2Fmidi%2B%2B%2Fport.h;h=4e63d41141653f8e976e1acbf679f6e54eb06869;hb=4a71e6f28fed69ce8f82e98430180fdbf2da1684;hp=4a5319b120da103e5a75a8957046a0513da101ec;hpb=79986643c0c904f6574bb5323e2233a43a9e622e;p=ardour.git diff --git a/libs/midi++2/midi++/port.h b/libs/midi++2/midi++/port.h index 4a5319b120..4e63d41141 100644 --- a/libs/midi++2/midi++/port.h +++ b/libs/midi++2/midi++/port.h @@ -1,5 +1,5 @@ /* - Copyright (C) 1998-99 Paul Barton-Davis + Copyright (C) 1998-2010 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 @@ -14,132 +14,135 @@ along with this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. - $Id$ */ -#ifndef __libmidi_port_h__ -#define __libmidi_port_h__ +#ifndef __libmidi_port_base_h__ +#define __libmidi_port_base_h__ #include +#include -#include +#include "pbd/xml++.h" +#include "pbd/crossthread.h" +#include "pbd/signals.h" +#include "pbd/ringbuffer.h" -#include -#include +#include "midi++/types.h" +#include "midi++/parser.h" namespace MIDI { class Channel; class PortRequest; -class Port : public sigc::trackable { +class Port { public: - enum Type { - Unknown, - ALSA_RawMidi, - ALSA_Sequencer, - CoreMidi_MidiPort, - Null, - FIFO + enum Flags { + IsInput = JackPortIsInput, + IsOutput = JackPortIsOutput, }; - - - Port (PortRequest &); + + Port (std::string const &, Flags); + Port (const XMLNode&); virtual ~Port (); - /* Direct I/O */ - - virtual int write (byte *msg, size_t msglen) = 0; - virtual int read (byte *buf, size_t max) = 0; - - /* slowdown i/o to a loop of single byte emissions - interspersed with a busy loop of 10000 * this value. + virtual XMLNode& get_state () const; + virtual void set_state (const XMLNode&); + + /** Write a message to port. + * @param msg Raw MIDI message to send + * @param msglen Size of @a msg + * @param timestamp Time stamp in frames of this message (relative to cycle start) + * @return number of bytes successfully written + */ + virtual int write (const byte *msg, size_t msglen, timestamp_t timestamp) = 0; + + /** Read raw bytes from a port. + * @param buf memory to store read data in + * @param bufsize size of @a buf + * @return number of bytes successfully read, negative if error + */ + virtual int read (byte *buf, size_t bufsize) = 0; + + /** block until the output FIFO used by non-process threads + * is empty, checking every @a check_interval_usecs usecs + * for current status. Not to be called by a thread that + * executes any part of a JACK process callback (will + * simply return immediately in that situation). + */ + virtual void drain (int /* check_interval_usecs */) {} + + /** Write a message to port. + * @return true on success. + * FIXME: describe semantics here + */ + int midimsg (byte *msg, size_t len, timestamp_t timestamp) { + return !(write (msg, len, timestamp) == (int) len); + } - This may be ignored by a particular instance - of this virtual class. See FD_MidiPort for an - example of where it used. - */ + virtual void parse (framecnt_t timestamp) = 0; - void set_slowdown (size_t n) { slowdown = n; } + bool clock (timestamp_t timestamp); /* select(2)/poll(2)-based I/O */ - virtual int selectable() const = 0; - - //void selector_read_callback (Select::Selectable *, Select::Condition); + /** Get the file descriptor for port. + * @return File descriptor, or -1 if not selectable. + */ + virtual int selectable () const = 0; - static void xforms_read_callback (int cond, int fd, void *ptr); - static void gtk_read_callback (void *ptr, int fd, int cond); - - static void write_callback (byte *msg, unsigned int len, void *); - Channel *channel (channel_t chn) { return _channel[chn&0x7F]; } - Parser *input() { return input_parser; } - Parser *output() { return output_parser; } - - void iostat (int *written, int *read, - const size_t **in_counts, - const size_t **out_counts) { - - *written = bytes_written; - *read = bytes_read; - if (input_parser) { - *in_counts = input_parser->message_counts(); - } else { - *in_counts = 0; - } - if (output_parser) { - *out_counts = output_parser->message_counts(); - } else { - *out_counts = 0; - } + Parser* parser () { + return _parser; } - int midimsg (byte *msg, size_t len) { - return !(write (msg, len) == (int) len); - } + const char *name () const { return _tagname.c_str(); } + bool ok () const { return _ok; } + + virtual bool centrally_parsed() const; + void set_centrally_parsed (bool yn) { _centrally_parsed = yn; } - int three_byte_msg (byte a, byte b, byte c) { - byte msg[3]; + bool receives_input () const { + return _flags == IsInput; + } - msg[0] = a; - msg[1] = b; - msg[2] = c; + bool sends_output () const { + return _flags == IsOutput; + } - return !(write (msg, 3) == 3); - } - - int clock (); - - const char *device () const { return _devname.c_str(); } - const char *name () const { return _tagname.c_str(); } - Type type () const { return _type; } - int mode () const { return _mode; } - bool ok () const { return _ok; } - size_t number () const { return _number; } + struct Descriptor { + std::string tag; + Flags flags; + + Descriptor (const XMLNode&); + XMLNode& get_state(); + }; + + static std::string state_node_name; protected: - bool _ok; - Type _type; - std::string _devname; - std::string _tagname; - int _mode; - size_t _number; - Channel *_channel[16]; - sigc::connection thru_connection; - unsigned int bytes_written; - unsigned int bytes_read; - Parser *input_parser; - Parser *output_parser; - size_t slowdown; - - private: - static size_t nports; + bool _ok; + std::string _tagname; + Channel* _channel[16]; + Parser* _parser; + Flags _flags; + bool _centrally_parsed; + + void init (std::string const &, Flags); }; +struct PortSet { + PortSet (std::string str) : owner (str) { } + + std::string owner; + std::list ports; +}; + +std::ostream & operator << (std::ostream& os, const Port& port); + } // namespace MIDI -#endif // __libmidi_port_h__ +#endif // __libmidi_port_base_h__