drivers/audio/AudioOutputDeviceJack.cpp

/***************************************************************************
 *                                                                         *
 *   LinuxSampler - modular, streaming capable sampler                     *
 *                                                                         *
 *   Copyright (C) 2003, 2004 by Benno Senoner and Christian Schoenebeck   *
 *                                                                         *
 *   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., 59 Temple Place, Suite 330, Boston,                 *
 *   MA  02111-1307  USA                                                   *
 ***************************************************************************/

#include "AudioOutputDeviceJack.h"
#include "AudioOutputDeviceFactory.h"

#include <errno.h>

#if HAVE_JACK

#ifndef HAVE_JACK_CLIENT_NAME_SIZE
#define jack_client_name_size() 33
#endif

namespace LinuxSampler {

    /// number of currently existing JACK audio output devices in LinuxSampler
    static int existingJackDevices = 0;

// *************** AudioChannelJack::ParameterName ***************
// *

    AudioOutputDeviceJack::AudioChannelJack::ParameterName::ParameterName(AudioChannelJack* pChannel) : AudioChannel::ParameterName(ToString(pChannel->ChannelNr)) {
        this->pChannel = pChannel;
    }

    void AudioOutputDeviceJack::AudioChannelJack::ParameterName::OnSetValue(String s) {
        if (jack_port_set_name(pChannel->hJackPort, s.c_str())) throw AudioOutputException("Failed to rename JACK port");
    }


// *************** AudioChannelJack::ParameterJackBindings ***************
// *

    AudioOutputDeviceJack::AudioChannelJack::ParameterJackBindings::ParameterJackBindings(AudioChannelJack* pChannel) : DeviceRuntimeParameterStrings(std::vector<String>()) {
        this->pChannel = pChannel;
    }

    String AudioOutputDeviceJack::AudioChannelJack::ParameterJackBindings::Description() {
        return "Bindings to other JACK clients";
    }

    bool AudioOutputDeviceJack::AudioChannelJack::ParameterJackBindings::Fix() {
        return false;
    }

    std::vector<String> AudioOutputDeviceJack::AudioChannelJack::ParameterJackBindings::PossibilitiesAsString() {
        const char** pPortNames = jack_get_ports(pChannel->pDevice->hJackClient, NULL, NULL, JackPortIsInput);
        if (!pPortNames) return std::vector<String>();
        std::vector<String> result;
        for (int i = 0; pPortNames[i]; i++) result.push_back(pPortNames[i]);
        //free(pPortNames); FIXME: pPortNames should be freed here
        return result;
    }

    void AudioOutputDeviceJack::AudioChannelJack::ParameterJackBindings::OnSetValue(std::vector<String> vS) {
        // TODO: we should remove all existing bindings before we connect new ones here
        String src_name = ((DeviceCreationParameterString*)pChannel->pDevice->Parameters["NAME"])->ValueAsString() + ":" +
                          ((DeviceRuntimeParameterString*)pChannel->Parameters["NAME"])->ValueAsString();
        for (int i = 0; i < vS.size(); i++) {
            String dst_name = vS[i];
            int res = jack_connect(pChannel->pDevice->hJackClient, src_name.c_str(), dst_name.c_str());
            if (res == EEXIST) throw AudioOutputException("Jack: Connection to port '" + dst_name + "' already established");
            else if (res)      throw AudioOutputException("Jack: Cannot connect port '" + src_name + "' to port '" + dst_name + "'");
        }
    }

    String AudioOutputDeviceJack::AudioChannelJack::ParameterJackBindings::Name() {
        return "JACK_BINDINGS";
    }


// *************** AudioChannelJack ***************
// *

    AudioOutputDeviceJack::AudioChannelJack::AudioChannelJack(uint ChannelNr, AudioOutputDeviceJack* pDevice) throw (AudioOutputException) : AudioChannel(ChannelNr, CreateJackPort(ChannelNr, pDevice), pDevice->uiMaxSamplesPerCycle) {
        this->pDevice   = pDevice;
        this->ChannelNr = ChannelNr;
        Parameters["NAME"]          = new ParameterName(this);
        Parameters["JACK_BINDINGS"] = new ParameterJackBindings(this);
    }

    AudioOutputDeviceJack::AudioChannelJack::~AudioChannelJack() {
        //TODO: delete JACK port
    }

    float* AudioOutputDeviceJack::AudioChannelJack::CreateJackPort(uint ChannelNr, AudioOutputDeviceJack* pDevice) throw (AudioOutputException) {
        String port_id = ToString(ChannelNr);
        hJackPort = jack_port_register(pDevice->hJackClient, port_id.c_str(), JACK_DEFAULT_AUDIO_TYPE, JackPortIsOutput, 0);
        if (!hJackPort) throw AudioOutputException("Jack: Cannot register Jack output port.");
        return (float*) jack_port_get_buffer(hJackPort, pDevice->uiMaxSamplesPerCycle);
    }


// *************** AudioOutputDeviceJack::ParameterName ***************
// *

    AudioOutputDeviceJack::ParameterName::ParameterName() : DeviceCreationParameterString() {
        InitWithDefault(); // use default name
    }

    AudioOutputDeviceJack::ParameterName::ParameterName(String s) throw (LinuxSamplerException) : DeviceCreationParameterString(s) {
    }

    String AudioOutputDeviceJack::ParameterName::Description() {
        return "Arbitrary JACK client name";
    }

    bool AudioOutputDeviceJack::ParameterName::Fix() {
        return true;
    }

    bool AudioOutputDeviceJack::ParameterName::Mandatory() {
        return false;
    }

    std::map<String,DeviceCreationParameter*> AudioOutputDeviceJack::ParameterName::DependsAsParameters() {
        return std::map<String,DeviceCreationParameter*>(); // no dependencies
    }

    std::vector<String> AudioOutputDeviceJack::ParameterName::PossibilitiesAsString(std::map<String,String> Parameters) {
        return std::vector<String>();
    }

    optional<String> AudioOutputDeviceJack::ParameterName::DefaultAsString(std::map<String,String> Parameters) {
        return (existingJackDevices) ? "LinuxSampler" + ToString(existingJackDevices) : "LinuxSampler";
    }

    void AudioOutputDeviceJack::ParameterName::OnSetValue(String s) throw (LinuxSamplerException) {
        // not possible, as parameter is fix
    }

    String AudioOutputDeviceJack::ParameterName::Name() {
        return "NAME";
    }


// *************** AudioOutputDeviceJack ***************
// *

    /**
     * Open and initialize connection to the JACK system.
     *
     * @param Parameters - optional parameters
     * @throws AudioOutputException  on error
     * @see AcquireChannels()
     */
    AudioOutputDeviceJack::AudioOutputDeviceJack(std::map<String,DeviceCreationParameter*> Parameters) : AudioOutputDevice(Parameters) {
        if (((DeviceCreationParameterString*)Parameters["NAME"])->ValueAsString().size() >= jack_client_name_size())
            throw LinuxSamplerException("JACK client name too long");

        if ((hJackClient = jack_client_new(((DeviceCreationParameterString*)Parameters["NAME"])->ValueAsString().c_str())) == 0)
            throw AudioOutputException("Seems Jack server not running.");

        existingJackDevices++;

        jack_set_process_callback(hJackClient, __libjack_process_callback, this);
        jack_on_shutdown(hJackClient, __libjack_shutdown_callback, this);
        if (jack_activate(hJackClient))
            throw AudioOutputException("Jack: Cannot activate Jack client.");

        uiMaxSamplesPerCycle = jack_get_buffer_size(hJackClient);

        // create audio channels
        AcquireChannels(((DeviceCreationParameterInt*)Parameters["CHANNELS"])->ValueAsInt());

        // finally activate device if desired
        if (((DeviceCreationParameterBool*)Parameters["ACTIVE"])->ValueAsBool()) Play();
    }

    AudioOutputDeviceJack::~AudioOutputDeviceJack() {
        // destroy jack client
        jack_client_close(hJackClient);
        existingJackDevices--;
    }

    /**
     * This method should not be called directly! It will be called by
     * libjack to demand transmission of further sample points.
     */
    int AudioOutputDeviceJack::Process(uint Samples) {
        if (csIsPlaying.Pop()) {
            // let all connected engines render 'Samples' sample points
            return RenderAudio(Samples);
        }
        else {
            // playback stop by zeroing output buffer(s) and not calling connected sampler engines to render audio
            return RenderSilence(Samples);
        }
    }

    void AudioOutputDeviceJack::Play() {
        csIsPlaying.PushAndUnlock(true);
    }

    bool AudioOutputDeviceJack::IsPlaying() {
        csIsPlaying.GetUnsafe();
    }

    void AudioOutputDeviceJack::Stop() {
        csIsPlaying.PushAndUnlock(false);
    }

    AudioChannel* AudioOutputDeviceJack::CreateChannel(uint ChannelNr) {
        return new AudioChannelJack(ChannelNr, this);
    }

    uint AudioOutputDeviceJack::MaxSamplesPerCycle() {
        return jack_get_buffer_size(hJackClient);
    }

    uint AudioOutputDeviceJack::SampleRate() {
        return jack_get_sample_rate(hJackClient);
    }

    String AudioOutputDeviceJack::Name() {
        return "JACK";
    }

    String AudioOutputDeviceJack::Driver() {
        return Name();
    }

    String AudioOutputDeviceJack::Description() {
        return "JACK Audio Connection Kit";
    }

    String AudioOutputDeviceJack::Version() {
       String s = "$Revision: 1.17 $";
       return s.substr(11, s.size() - 13); // cut dollar signs, spaces and CVS macro keyword
    }

    // libjack callback functions

    int __libjack_process_callback(jack_nframes_t nframes, void* arg) {
        AudioOutputDeviceJack* pAudioOutputDeviceJack = (AudioOutputDeviceJack*) arg;
        return pAudioOutputDeviceJack->Process(nframes);
    }

    void __libjack_shutdown_callback(void* arg) {
        AudioOutputDeviceJack* pAudioOutputDeviceJack = (AudioOutputDeviceJack*) arg;
        pAudioOutputDeviceJack->Stop();
        fprintf(stderr, "Jack: Jack server shutdown, exiting.\n");
    }

} // namespace LinuxSampler

#endif // HAVE_JACK
1	schoenebeck	200	/***************************************************************************
2			* *
3			* LinuxSampler - modular, streaming capable sampler *
4			* *
5			* Copyright (C) 2003, 2004 by Benno Senoner and Christian Schoenebeck *
6			* *
7			* This program is free software; you can redistribute it and/or modify *
8			* it under the terms of the GNU General Public License as published by *
9			* the Free Software Foundation; either version 2 of the License, or *
10			* (at your option) any later version. *
11			* *
12			* This program is distributed in the hope that it will be useful, *
13			* but WITHOUT ANY WARRANTY; without even the implied warranty of *
14			* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
15			* GNU General Public License for more details. *
16			* *
17			* You should have received a copy of the GNU General Public License *
18			* along with this program; if not, write to the Free Software *
19			* Foundation, Inc., 59 Temple Place, Suite 330, Boston, *
20			* MA 02111-1307 USA *
21			***************************************************************************/
22
23			#include "AudioOutputDeviceJack.h"
24			#include "AudioOutputDeviceFactory.h"
25
26	capela	268	#include <errno.h>
27
28	schoenebeck	200	#if HAVE_JACK
29
30	persson	379	#ifndef HAVE_JACK_CLIENT_NAME_SIZE
31			#define jack_client_name_size() 33
32			#endif
33
34	schoenebeck	200	namespace LinuxSampler {
35
36	schoenebeck	374	/// number of currently existing JACK audio output devices in LinuxSampler
37			static int existingJackDevices = 0;
38
39			// ************* AudioChannelJack::ParameterName *************
40	schoenebeck	226	// *
41
42			AudioOutputDeviceJack::AudioChannelJack::ParameterName::ParameterName(AudioChannelJack* pChannel) : AudioChannel::ParameterName(ToString(pChannel->ChannelNr)) {
43			this->pChannel = pChannel;
44			}
45
46			void AudioOutputDeviceJack::AudioChannelJack::ParameterName::OnSetValue(String s) {
47	schoenebeck	227	if (jack_port_set_name(pChannel->hJackPort, s.c_str())) throw AudioOutputException("Failed to rename JACK port");
48	schoenebeck	226	}
49
50
51
52	schoenebeck	374	// ************* AudioChannelJack::ParameterJackBindings *************
53	schoenebeck	226	// *
54
55			AudioOutputDeviceJack::AudioChannelJack::ParameterJackBindings::ParameterJackBindings(AudioChannelJack* pChannel) : DeviceRuntimeParameterStrings(std::vector<String>()) {
56			this->pChannel = pChannel;
57			}
58
59			String AudioOutputDeviceJack::AudioChannelJack::ParameterJackBindings::Description() {
60			return "Bindings to other JACK clients";
61			}
62
63			bool AudioOutputDeviceJack::AudioChannelJack::ParameterJackBindings::Fix() {
64			return false;
65			}
66
67			std::vector<String> AudioOutputDeviceJack::AudioChannelJack::ParameterJackBindings::PossibilitiesAsString() {
68	schoenebeck	227	const char** pPortNames = jack_get_ports(pChannel->pDevice->hJackClient, NULL, NULL, JackPortIsInput);
69	schoenebeck	226	if (!pPortNames) return std::vector<String>();
70			std::vector<String> result;
71			for (int i = 0; pPortNames[i]; i++) result.push_back(pPortNames[i]);
72			//free(pPortNames); FIXME: pPortNames should be freed here
73			return result;
74			}
75
76			void AudioOutputDeviceJack::AudioChannelJack::ParameterJackBindings::OnSetValue(std::vector<String> vS) {
77	schoenebeck	227	// TODO: we should remove all existing bindings before we connect new ones here
78	schoenebeck	403	String src_name = ((DeviceCreationParameterString*)pChannel->pDevice->Parameters["NAME"])->ValueAsString() + ":" +
79			((DeviceRuntimeParameterString*)pChannel->Parameters["NAME"])->ValueAsString();
80	schoenebeck	226	for (int i = 0; i < vS.size(); i++) {
81			String dst_name = vS[i];
82	schoenebeck	227	int res = jack_connect(pChannel->pDevice->hJackClient, src_name.c_str(), dst_name.c_str());
83			if (res == EEXIST) throw AudioOutputException("Jack: Connection to port '" + dst_name + "' already established");
84			else if (res) throw AudioOutputException("Jack: Cannot connect port '" + src_name + "' to port '" + dst_name + "'");
85	schoenebeck	226	}
86			}
87
88			String AudioOutputDeviceJack::AudioChannelJack::ParameterJackBindings::Name() {
89			return "JACK_BINDINGS";
90			}
91
92
93
94			// ************* AudioChannelJack *************
95			// *
96
97			AudioOutputDeviceJack::AudioChannelJack::AudioChannelJack(uint ChannelNr, AudioOutputDeviceJack* pDevice) throw (AudioOutputException) : AudioChannel(ChannelNr, CreateJackPort(ChannelNr, pDevice), pDevice->uiMaxSamplesPerCycle) {
98			this->pDevice = pDevice;
99			this->ChannelNr = ChannelNr;
100			Parameters["NAME"] = new ParameterName(this);
101			Parameters["JACK_BINDINGS"] = new ParameterJackBindings(this);
102			}
103
104			AudioOutputDeviceJack::AudioChannelJack::~AudioChannelJack() {
105			//TODO: delete JACK port
106			}
107
108			float* AudioOutputDeviceJack::AudioChannelJack::CreateJackPort(uint ChannelNr, AudioOutputDeviceJack* pDevice) throw (AudioOutputException) {
109	schoenebeck	227	String port_id = ToString(ChannelNr);
110	schoenebeck	226	hJackPort = jack_port_register(pDevice->hJackClient, port_id.c_str(), JACK_DEFAULT_AUDIO_TYPE, JackPortIsOutput, 0);
111			if (!hJackPort) throw AudioOutputException("Jack: Cannot register Jack output port.");
112			return (float*) jack_port_get_buffer(hJackPort, pDevice->uiMaxSamplesPerCycle);
113			}
114
115
116
117	schoenebeck	374	// ************* AudioOutputDeviceJack::ParameterName *************
118			// *
119
120			AudioOutputDeviceJack::ParameterName::ParameterName() : DeviceCreationParameterString() {
121			InitWithDefault(); // use default name
122			}
123
124			AudioOutputDeviceJack::ParameterName::ParameterName(String s) throw (LinuxSamplerException) : DeviceCreationParameterString(s) {
125			}
126
127			String AudioOutputDeviceJack::ParameterName::Description() {
128			return "Arbitrary JACK client name";
129			}
130
131			bool AudioOutputDeviceJack::ParameterName::Fix() {
132			return true;
133			}
134
135			bool AudioOutputDeviceJack::ParameterName::Mandatory() {
136			return false;
137			}
138
139			std::map<String,DeviceCreationParameter*> AudioOutputDeviceJack::ParameterName::DependsAsParameters() {
140			return std::map<String,DeviceCreationParameter*>(); // no dependencies
141			}
142
143			std::vector<String> AudioOutputDeviceJack::ParameterName::PossibilitiesAsString(std::map<String,String> Parameters) {
144			return std::vector<String>();
145			}
146
147			optional<String> AudioOutputDeviceJack::ParameterName::DefaultAsString(std::map<String,String> Parameters) {
148			return (existingJackDevices) ? "LinuxSampler" + ToString(existingJackDevices) : "LinuxSampler";
149			}
150
151			void AudioOutputDeviceJack::ParameterName::OnSetValue(String s) throw (LinuxSamplerException) {
152			// not possible, as parameter is fix
153			}
154
155			String AudioOutputDeviceJack::ParameterName::Name() {
156			return "NAME";
157			}
158
159
160
161	schoenebeck	226	// ************* AudioOutputDeviceJack *************
162			// *
163
164	schoenebeck	200	/**
165			* Open and initialize connection to the JACK system.
166			*
167			* @param Parameters - optional parameters
168			* @throws AudioOutputException on error
169			* @see AcquireChannels()
170			*/
171	schoenebeck	226	AudioOutputDeviceJack::AudioOutputDeviceJack(std::map<String,DeviceCreationParameter*> Parameters) : AudioOutputDevice(Parameters) {
172	schoenebeck	374	if (((DeviceCreationParameterString*)Parameters["NAME"])->ValueAsString().size() >= jack_client_name_size())
173			throw LinuxSamplerException("JACK client name too long");
174
175			if ((hJackClient = jack_client_new(((DeviceCreationParameterString*)Parameters["NAME"])->ValueAsString().c_str())) == 0)
176	schoenebeck	200	throw AudioOutputException("Seems Jack server not running.");
177
178	schoenebeck	374	existingJackDevices++;
179
180	schoenebeck	200	jack_set_process_callback(hJackClient, __libjack_process_callback, this);
181			jack_on_shutdown(hJackClient, __libjack_shutdown_callback, this);
182			if (jack_activate(hJackClient))
183			throw AudioOutputException("Jack: Cannot activate Jack client.");
184
185			uiMaxSamplesPerCycle = jack_get_buffer_size(hJackClient);
186
187	schoenebeck	226	// create audio channels
188			AcquireChannels(((DeviceCreationParameterInt*)Parameters["CHANNELS"])->ValueAsInt());
189	schoenebeck	227
190			// finally activate device if desired
191			if (((DeviceCreationParameterBool*)Parameters["ACTIVE"])->ValueAsBool()) Play();
192	schoenebeck	200	}
193
194			AudioOutputDeviceJack::~AudioOutputDeviceJack() {
195			// destroy jack client
196			jack_client_close(hJackClient);
197	schoenebeck	374	existingJackDevices--;
198	schoenebeck	200	}
199
200			/**
201			* This method should not be called directly! It will be called by
202			* libjack to demand transmission of further sample points.
203			*/
204			int AudioOutputDeviceJack::Process(uint Samples) {
205			if (csIsPlaying.Pop()) {
206			// let all connected engines render 'Samples' sample points
207			return RenderAudio(Samples);
208			}
209			else {
210			// playback stop by zeroing output buffer(s) and not calling connected sampler engines to render audio
211			return RenderSilence(Samples);
212			}
213			}
214
215			void AudioOutputDeviceJack::Play() {
216			csIsPlaying.PushAndUnlock(true);
217			}
218
219			bool AudioOutputDeviceJack::IsPlaying() {
220			csIsPlaying.GetUnsafe();
221			}
222
223			void AudioOutputDeviceJack::Stop() {
224			csIsPlaying.PushAndUnlock(false);
225			}
226
227	schoenebeck	226	AudioChannel* AudioOutputDeviceJack::CreateChannel(uint ChannelNr) {
228			return new AudioChannelJack(ChannelNr, this);
229	schoenebeck	200	}
230
231			uint AudioOutputDeviceJack::MaxSamplesPerCycle() {
232			return jack_get_buffer_size(hJackClient);
233			}
234
235			uint AudioOutputDeviceJack::SampleRate() {
236			return jack_get_sample_rate(hJackClient);
237			}
238
239			String AudioOutputDeviceJack::Name() {
240	schoenebeck	221	return "JACK";
241	schoenebeck	200	}
242
243			String AudioOutputDeviceJack::Driver() {
244			return Name();
245			}
246
247			String AudioOutputDeviceJack::Description() {
248			return "JACK Audio Connection Kit";
249			}
250
251			String AudioOutputDeviceJack::Version() {
252	schoenebeck	403	String s = "$Revision: 1.17 $";
253	schoenebeck	200	return s.substr(11, s.size() - 13); // cut dollar signs, spaces and CVS macro keyword
254			}
255
256			// libjack callback functions
257
258			int __libjack_process_callback(jack_nframes_t nframes, void* arg) {
259			AudioOutputDeviceJack* pAudioOutputDeviceJack = (AudioOutputDeviceJack*) arg;
260			return pAudioOutputDeviceJack->Process(nframes);
261			}
262
263			void __libjack_shutdown_callback(void* arg) {
264			AudioOutputDeviceJack* pAudioOutputDeviceJack = (AudioOutputDeviceJack*) arg;
265			pAudioOutputDeviceJack->Stop();
266			fprintf(stderr, "Jack: Jack server shutdown, exiting.\n");
267			}
268
269			} // namespace LinuxSampler
270
271			#endif // HAVE_JACK