2 Copyright (C) 2002 Paul Davis
4 This program is free software; you can redistribute it and/or modify
5 it under the terms of the GNU General Public License as published by
6 the Free Software Foundation; either version 2 of the License, or
7 (at your option) any later version.
9 This program is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 GNU General Public License for more details.
14 You should have received a copy of the GNU General Public License
15 along with this program; if not, write to the Free Software
16 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
21 #ifndef __ardour_port_h__
22 #define __ardour_port_h__
24 #include <sigc++/signal.h>
25 #include <pbd/failed_constructor.h>
26 #include <ardour/ardour.h>
27 #include <jack/jack.h>
33 class Port : public sigc::trackable {
39 Sample *get_buffer (nframes_t nframes) {
40 if (_flags & JackPortIsOutput) {
43 return (Sample *) jack_port_get_buffer (_port, nframes);
47 void reset_buffer () {
48 if (_flags & JackPortIsOutput) {
49 _buffer = (Sample *) jack_port_get_buffer (_port, 0);
51 _buffer = 0; /* catch illegal attempts to use it */
60 std::string short_name() {
61 return jack_port_short_name (_port);
64 int set_name (std::string str);
66 JackPortFlags flags() const {
70 bool is_mine (jack_client_t *client) {
71 return jack_port_is_mine (client, _port);
74 const char* type() const {
78 int connected () const {
79 return jack_port_connected (_port);
82 bool connected_to (const std::string& portname) const {
83 return jack_port_connected_to (_port, portname.c_str());
86 const char ** get_connections () const {
87 return jack_port_get_connections (_port);
96 void reset_peak_meter () {
100 void reset_meters () {
105 void enable_metering() {
109 void disable_metering () {
110 if (_metering) { _metering--; }
113 float peak_db() const { return _peak_db; }
114 jack_default_audio_sample_t peak() const { return _peak; }
116 uint32_t short_overs () const { return _short_overs; }
117 uint32_t long_overs () const { return _long_overs; }
119 static void set_short_over_length (nframes_t);
120 static void set_long_over_length (nframes_t);
122 bool receives_input() const {
123 return _flags & JackPortIsInput;
126 bool sends_output () const {
127 return _flags & JackPortIsOutput;
130 bool monitoring_input () const {
131 return jack_port_monitoring_input (_port);
134 bool can_monitor () const {
135 return _flags & JackPortCanMonitor;
138 void ensure_monitor_input (bool yn) {
140 #ifdef HAVE_JACK_PORT_ENSURE_MONITOR
141 jack_port_ensure_monitor (_port, yn);
143 jack_port_request_monitor(_port, yn);
148 /*XXX completely bloody useless imho*/
149 void request_monitor_input (bool yn) {
150 jack_port_request_monitor (_port, yn);
153 nframes_t latency () const {
154 return jack_port_get_latency (_port);
157 void set_latency (nframes_t nframes) {
158 jack_port_set_latency (_port, nframes);
161 sigc::signal<void,bool> MonitorInputChanged;
162 sigc::signal<void,bool> ClockSyncChanged;
164 bool is_silent() const { return _silent; }
166 /** Assumes that the port is an audio output port */
167 void silence (nframes_t nframes, nframes_t offset) {
169 memset (_buffer + offset, 0, sizeof (Sample) * nframes);
171 /* XXX this isn't really true, but i am not sure
172 how to set this correctly. we really just
173 want to set it true when the entire port
174 buffer has been overrwritten.
181 void mark_silence (bool yn) {
186 friend class AudioEngine;
188 Port (jack_port_t *port);
191 /* engine isn't supposed to below here */
195 /* cache these 3 from JACK so that we can
196 access them for reconnecting.
199 JackPortFlags _flags;
203 bool _last_monitor : 1;
207 jack_default_audio_sample_t _peak;
209 uint32_t _short_overs;
210 uint32_t _long_overs;
211 unsigned short _metering;
213 static nframes_t _long_over_length;
214 static nframes_t _short_over_length;
217 } // namespace ARDOUR
219 #endif /* __ardour_port_h__ */