1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
|
/*
* ***** BEGIN GPL LICENSE BLOCK *****
*
* Copyright 2009-2011 Jörg Hermann Müller
*
* This file is part of AudaSpace.
*
* Audaspace 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.
*
* AudaSpace 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 Audaspace; if not, write to the Free Software Foundation,
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*
* ***** END GPL LICENSE BLOCK *****
*/
/** \file audaspace/jack/AUD_JackDevice.h
* \ingroup audjack
*/
#ifndef __AUD_JACKDEVICE_H__
#define __AUD_JACKDEVICE_H__
#include "AUD_SoftwareDevice.h"
#include "AUD_Buffer.h"
#include <string>
#include <AUD_JackLibrary.h>
typedef void (*AUD_syncFunction)(void*, int, float);
/**
* This device plays back through JACK.
*/
class AUD_JackDevice : public AUD_SoftwareDevice
{
private:
/**
* The output ports of jack.
*/
jack_port_t** m_ports;
/**
* The jack client.
*/
jack_client_t* m_client;
/**
* The output buffer.
*/
AUD_Buffer m_buffer;
/**
* The deinterleaving buffer.
*/
AUD_Buffer m_deinterleavebuf;
jack_ringbuffer_t** m_ringbuffers;
/**
* Whether the device is valid.
*/
bool m_valid;
/**
* Invalidates the jack device.
* \param data The jack device that gets invalidet by jack.
*/
static void jack_shutdown(void *data);
/**
* Mixes the next bytes into the buffer.
* \param length The length in samples to be filled.
* \param data A pointer to the jack device.
* \return 0 what shows success.
*/
static int jack_mix(jack_nframes_t length, void *data);
static int jack_sync(jack_transport_state_t state, jack_position_t* pos, void* data);
/**
* Next JACK Transport state (-1 if not expected to change).
*/
jack_transport_state_t m_nextState;
/**
* Current jack transport status.
*/
jack_transport_state_t m_state;
/**
* Syncronisation state.
*/
int m_sync;
/**
* External syncronisation callback function.
*/
AUD_syncFunction m_syncFunc;
/**
* Data for the sync function.
*/
void* m_syncFuncData;
/**
* The mixing thread.
*/
pthread_t m_mixingThread;
/**
* Mutex for mixing.
*/
pthread_mutex_t m_mixingLock;
/**
* Condition for mixing.
*/
pthread_cond_t m_mixingCondition;
/**
* Mixing thread function.
* \param device The this pointer.
* \return NULL.
*/
static void* runMixingThread(void* device);
/**
* Updates the ring buffers.
*/
void updateRingBuffers();
// hide copy constructor and operator=
AUD_JackDevice(const AUD_JackDevice&);
AUD_JackDevice& operator=(const AUD_JackDevice&);
protected:
virtual void playing(bool playing);
public:
/**
* Creates a JACK client for audio output.
* \param name The client name.
* \param specs The wanted audio specification, where only the channel count
* is important.
* \param buffersize The size of the internal buffer.
* \exception AUD_Exception Thrown if the audio device cannot be opened.
*/
AUD_JackDevice(std::string name, AUD_DeviceSpecs specs, int buffersize = AUD_DEFAULT_BUFFER_SIZE);
/**
* Closes the JACK client.
*/
virtual ~AUD_JackDevice();
/**
* Starts jack transport playback.
*/
void startPlayback();
/**
* Stops jack transport playback.
*/
void stopPlayback();
/**
* Seeks jack transport playback.
* \param time The time to seek to.
*/
void seekPlayback(float time);
/**
* Sets the sync callback for jack transport playback.
* \param sync The callback function.
* \param data The data for the function.
*/
void setSyncCallback(AUD_syncFunction sync, void* data);
/**
* Retrieves the jack transport playback time.
* \return The current time position.
*/
float getPlaybackPosition();
/**
* Returns whether jack transport plays back.
* \return Whether jack transport plays back.
*/
bool doesPlayback();
};
#endif //__AUD_JACKDEVICE_H__
|
