trunk/src/voice.cpp

/***************************************************************************
 *                                                                         *
 *   LinuxSampler - modular, streaming capable sampler                     *
 *                                                                         *
 *   Copyright (C) 2003 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 "voice.h"

// FIXME: no support for layers (nor crossfades) yet

DiskThread* Voice::pDiskThread = NULL;

Voice::Voice(DiskThread* pDiskThread) {
    Active             = false;
    Voice::pDiskThread = pDiskThread;
}

Voice::~Voice() {
}

/**
 *  Initializes and triggers the voice, a disk stream will be launched if
 *  needed.
 *
 *  @returns  0 on success, a value < 0 if something failed
 */
int Voice::Trigger(int MIDIKey, uint8_t Velocity, gig::Instrument* Instrument) {
    Active          = true;
    this->MIDIKey   = MIDIKey;
    pRegion         = Instrument->GetRegion(MIDIKey);
    PlaybackState   = playback_state_ram; // we always start playback from RAM cache and switch then to disk if needed
    Pos             = 0;
    ReleaseVelocity = 127; // default release velocity value

    if (!pRegion) {
        std::cerr << "Audio Thread: No Region defined for MIDI key " << MIDIKey << std::endl << std::flush;
        Kill();
        return -1;
    }

    //TODO: current MIDI controller values are not taken into account yet
    gig::DimensionRegion* pDimRgn = NULL;
    for (int i = pRegion->Dimensions - 1; i >= 0; i--) { // Check if instrument has a velocity split
        if (pRegion->pDimensionDefinitions[i].dimension == gig::dimension_velocity) {
            uint DimValues[5] = {0,0,0,0,0};
                 DimValues[i] = Velocity;
            pDimRgn = pRegion->GetDimensionRegionByValue(DimValues[4],DimValues[3],DimValues[2],DimValues[1],DimValues[0]);
            break;
        }
    }
    if (!pDimRgn) { // if there was no velocity split
        pDimRgn = pRegion->GetDimensionRegionByValue(0,0,0,0,0);
    }

    pSample = pDimRgn->pSample; // sample won't change until the voice is finished

    // Check if the sample needs disk streaming or is too short for that
    long cachedsamples = pSample->GetCache().Size / pSample->FrameSize;
    DiskVoice          = cachedsamples < pSample->SamplesTotal;

    if (DiskVoice) { // voice to be streamed from disk
        MaxRAMPos = cachedsamples - (OutputBufferSize << MAX_PITCH) / pSample->Channels;

        // check if there's a loop defined which completely fits into the cached (RAM) part of the sample
        if (pSample->Loops && pSample->LoopEnd <= MaxRAMPos) {
            RAMLoop        = true;
            LoopCyclesLeft = pSample->LoopPlayCount;
        }
        else RAMLoop = false;

        if (pDiskThread->OrderNewStream(&DiskStreamRef, pSample, MaxRAMPos, !RAMLoop) < 0) {
            dmsg(1,("Disk stream order failed!\n"));
            Kill();
            return -1;
        }
        dmsg(4,("Disk voice launched (cached samples: %d, total Samples: %d, MaxRAMPos: %d, RAMLooping: %s\n", cachedsamples, pSample->SamplesTotal, MaxRAMPos, (RAMLoop) ? "yes" : "no"));
    }
    else { // RAM only voice
        MaxRAMPos = cachedsamples;
        if (pSample->Loops) {
            RAMLoop        = true;
            LoopCyclesLeft = pSample->LoopPlayCount;
        }
        else RAMLoop = false;
        dmsg(4,("RAM only voice launched (Looping: %s)\n", (RAMLoop) ? "yes" : "no"));
    }

    CurrentPitch = pow(2, (double) (MIDIKey - (int) pSample->MIDIUnityNote) / (double) 12);
    Volume       = pDimRgn->GetVelocityAttenuation(Velocity);

    // ************************************************
    // TODO: ARTICULATION DATA HANDLING IS MISSING HERE
    // ************************************************

    return 0; // success
}

/**
 *  Renders the audio data for this voice for the current audio fragment.
 *  The sample input data can either come from RAM (cached sample or sample
 *  part) or directly from disk. The output signal will be rendered by
 *  resampling / interpolation. If this voice is a disk streaming voice and
 *  the voice completely played back the cached RAM part of the sample, it
 *  will automatically switch to disk playback for the next RenderAudio()
 *  call.
 */
void Voice::RenderAudio() {

    switch (this->PlaybackState) {

        case playback_state_ram: {
                if (RAMLoop) InterpolateAndLoop((sample_t*) pSample->GetCache().pStart);
                else         Interpolate((sample_t*) pSample->GetCache().pStart);
                if (DiskVoice) {
                    // check if we reached the allowed limit of the sample RAM cache
                    if (Pos > MaxRAMPos) {
                        dmsg(5,("Voice: switching to disk playback (Pos=%f)\n", Pos));
                        this->PlaybackState = playback_state_disk;
                    }
                }
                else if (Pos >= pSample->GetCache().Size / pSample->FrameSize) {
                    this->PlaybackState = playback_state_end;
                }
            }
            break;

        case playback_state_disk: {
                if (!DiskStreamRef.pStream) {
                    // check if the disk thread created our ordered disk stream in the meantime
                    DiskStreamRef.pStream = pDiskThread->AskForCreatedStream(DiskStreamRef.OrderID);
                    if (!DiskStreamRef.pStream) {
                        std::cout << stderr << "Disk stream not available in time!" << std::endl << std::flush;
                        Kill();
                        return;
                    }
                    DiskStreamRef.pStream->IncrementReadPos(pSample->Channels * (double_to_int(Pos) - MaxRAMPos));
                    Pos -= double_to_int(Pos);
                }

                // add silence sample at the end if we reached the end of the stream (for the interpolator)
                if (DiskStreamRef.State == Stream::state_end && DiskStreamRef.pStream->GetReadSpace() < (OutputBufferSize << MAX_PITCH) / pSample->Channels) {
                    DiskStreamRef.pStream->WriteSilence((OutputBufferSize << MAX_PITCH) / pSample->Channels);
                    this->PlaybackState = playback_state_end;
                }

                sample_t* ptr = DiskStreamRef.pStream->GetReadPtr(); // get the current read_ptr within the ringbuffer where we read the samples from
                Interpolate(ptr);
                DiskStreamRef.pStream->IncrementReadPos(double_to_int(Pos) * pSample->Channels);
                Pos -= double_to_int(Pos);
            }
            break;

        case playback_state_end:
            Kill(); // free voice
            break;
    }
}

/**
 *  Interpolates the input audio data (no loop).
 *
 *  @param pSrc - pointer to input sample data
 */
void Voice::Interpolate(sample_t* pSrc) {
    float effective_volume = this->Volume;
    int   i = 0;

    // ************************************************
    // TODO: ARTICULATION DATA HANDLING IS MISSING HERE
    // ************************************************

    // FIXME: assuming either mono or stereo
    if (this->pSample->Channels == 2) { // Stereo Sample
        while (i < this->OutputBufferSize) {
            InterpolateOneStep_Stereo(pSrc, i, effective_volume);
        }
    }
    else { // Mono Sample
        while (i < this->OutputBufferSize) {
            InterpolateOneStep_Mono(pSrc, i, effective_volume);
        }
    }
}

/**
 *  Interpolates the input audio data, this method honors looping.
 *
 *  @param pSrc - pointer to input sample data
 */
void Voice::InterpolateAndLoop(sample_t* pSrc) {
    float effective_volume = this->Volume;
    int   i = 0;

    // ************************************************
    // TODO: ARTICULATION DATA HANDLING IS MISSING HERE
    // ************************************************

    // FIXME: assuming either mono or stereo
    if (pSample->Channels == 2) { // Stereo Sample
        if (pSample->LoopPlayCount) {
            // render loop (loop count limited)
            while (i < OutputBufferSize && LoopCyclesLeft) {
                InterpolateOneStep_Stereo(pSrc, i, effective_volume);
                if (Pos > pSample->LoopEnd) {
                    Pos = pSample->LoopStart + fmod(Pos - pSample->LoopEnd, pSample->LoopSize);;
                    LoopCyclesLeft--;
                }
            }
            // render on without loop
            while (i < OutputBufferSize) {
                InterpolateOneStep_Stereo(pSrc, i, effective_volume);
            }
        }
        else { // render loop (endless loop)
            while (i < OutputBufferSize) {
                InterpolateOneStep_Stereo(pSrc, i, effective_volume);
                if (Pos > pSample->LoopEnd) {
                    Pos = pSample->LoopStart + fmod(Pos - pSample->LoopEnd, pSample->LoopSize);
                }
            }
        }
    }
    else { // Mono Sample
        if (pSample->LoopPlayCount) {
            // render loop (loop count limited)
            while (i < OutputBufferSize && LoopCyclesLeft) {
                InterpolateOneStep_Mono(pSrc, i, effective_volume);
                if (Pos > pSample->LoopEnd) {
                    Pos = pSample->LoopStart + fmod(Pos - pSample->LoopEnd, pSample->LoopSize);;
                    LoopCyclesLeft--;
                }
            }
            // render on without loop
            while (i < OutputBufferSize) {
                InterpolateOneStep_Mono(pSrc, i, effective_volume);
            }
        }
        else { // render loop (endless loop)
            while (i < OutputBufferSize) {
                InterpolateOneStep_Mono(pSrc, i, effective_volume);
                if (Pos > pSample->LoopEnd) {
                    Pos = pSample->LoopStart + fmod(Pos - pSample->LoopEnd, pSample->LoopSize);;
                }
            }
        }
    }
}

/**
 *  Immediately kill the voice.
 */
void Voice::Kill() {
    if (DiskVoice && DiskStreamRef.State != Stream::state_unused) {
        pDiskThread->OrderDeletionOfStream(&DiskStreamRef);
    }
    DiskStreamRef.pStream = NULL;
    DiskStreamRef.hStream = 0;
    DiskStreamRef.State   = Stream::state_unused;
    DiskStreamRef.OrderID = 0;
    Active = false;
}
1	/***************************************************************************
2	* *
3	* LinuxSampler - modular, streaming capable sampler *
4	* *
5	* Copyright (C) 2003 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 "voice.h"
24
25	// FIXME: no support for layers (nor crossfades) yet
26
27	DiskThread* Voice::pDiskThread = NULL;
28
29	Voice::Voice(DiskThread* pDiskThread) {
30	Active = false;
31	Voice::pDiskThread = pDiskThread;
32	}
33
34	Voice::~Voice() {
35	}
36
37	/**
38	* Initializes and triggers the voice, a disk stream will be launched if
39	* needed.
40	*
41	* @returns 0 on success, a value < 0 if something failed
42	*/
43	int Voice::Trigger(int MIDIKey, uint8_t Velocity, gig::Instrument* Instrument) {
44	Active = true;
45	this->MIDIKey = MIDIKey;
46	pRegion = Instrument->GetRegion(MIDIKey);
47	PlaybackState = playback_state_ram; // we always start playback from RAM cache and switch then to disk if needed
48	Pos = 0;
49	ReleaseVelocity = 127; // default release velocity value
50
51	if (!pRegion) {
52	std::cerr << "Audio Thread: No Region defined for MIDI key " << MIDIKey << std::endl << std::flush;
53	Kill();
54	return -1;
55	}
56
57	//TODO: current MIDI controller values are not taken into account yet
58	gig::DimensionRegion* pDimRgn = NULL;
59	for (int i = pRegion->Dimensions - 1; i >= 0; i--) { // Check if instrument has a velocity split
60	if (pRegion->pDimensionDefinitions[i].dimension == gig::dimension_velocity) {
61	uint DimValues[5] = {0,0,0,0,0};
62	DimValues[i] = Velocity;
63	pDimRgn = pRegion->GetDimensionRegionByValue(DimValues[4],DimValues[3],DimValues[2],DimValues[1],DimValues[0]);
64	break;
65	}
66	}
67	if (!pDimRgn) { // if there was no velocity split
68	pDimRgn = pRegion->GetDimensionRegionByValue(0,0,0,0,0);
69	}
70
71	pSample = pDimRgn->pSample; // sample won't change until the voice is finished
72
73	// Check if the sample needs disk streaming or is too short for that
74	long cachedsamples = pSample->GetCache().Size / pSample->FrameSize;
75	DiskVoice = cachedsamples < pSample->SamplesTotal;
76
77	if (DiskVoice) { // voice to be streamed from disk
78	MaxRAMPos = cachedsamples - (OutputBufferSize << MAX_PITCH) / pSample->Channels;
79
80	// check if there's a loop defined which completely fits into the cached (RAM) part of the sample
81	if (pSample->Loops && pSample->LoopEnd <= MaxRAMPos) {
82	RAMLoop = true;
83	LoopCyclesLeft = pSample->LoopPlayCount;
84	}
85	else RAMLoop = false;
86
87	if (pDiskThread->OrderNewStream(&DiskStreamRef, pSample, MaxRAMPos, !RAMLoop) < 0) {
88	dmsg(1,("Disk stream order failed!\n"));
89	Kill();
90	return -1;
91	}
92	dmsg(4,("Disk voice launched (cached samples: %d, total Samples: %d, MaxRAMPos: %d, RAMLooping: %s\n", cachedsamples, pSample->SamplesTotal, MaxRAMPos, (RAMLoop) ? "yes" : "no"));
93	}
94	else { // RAM only voice
95	MaxRAMPos = cachedsamples;
96	if (pSample->Loops) {
97	RAMLoop = true;
98	LoopCyclesLeft = pSample->LoopPlayCount;
99	}
100	else RAMLoop = false;
101	dmsg(4,("RAM only voice launched (Looping: %s)\n", (RAMLoop) ? "yes" : "no"));
102	}
103
104	CurrentPitch = pow(2, (double) (MIDIKey - (int) pSample->MIDIUnityNote) / (double) 12);
105	Volume = pDimRgn->GetVelocityAttenuation(Velocity);
106
107	// ************************************************
108	// TODO: ARTICULATION DATA HANDLING IS MISSING HERE
109	// ************************************************
110
111	return 0; // success
112	}
113
114	/**
115	* Renders the audio data for this voice for the current audio fragment.
116	* The sample input data can either come from RAM (cached sample or sample
117	* part) or directly from disk. The output signal will be rendered by
118	* resampling / interpolation. If this voice is a disk streaming voice and
119	* the voice completely played back the cached RAM part of the sample, it
120	* will automatically switch to disk playback for the next RenderAudio()
121	* call.
122	*/
123	void Voice::RenderAudio() {
124
125	switch (this->PlaybackState) {
126
127	case playback_state_ram: {
128	if (RAMLoop) InterpolateAndLoop((sample_t*) pSample->GetCache().pStart);
129	else Interpolate((sample_t*) pSample->GetCache().pStart);
130	if (DiskVoice) {
131	// check if we reached the allowed limit of the sample RAM cache
132	if (Pos > MaxRAMPos) {
133	dmsg(5,("Voice: switching to disk playback (Pos=%f)\n", Pos));
134	this->PlaybackState = playback_state_disk;
135	}
136	}
137	else if (Pos >= pSample->GetCache().Size / pSample->FrameSize) {
138	this->PlaybackState = playback_state_end;
139	}
140	}
141	break;
142
143	case playback_state_disk: {
144	if (!DiskStreamRef.pStream) {
145	// check if the disk thread created our ordered disk stream in the meantime
146	DiskStreamRef.pStream = pDiskThread->AskForCreatedStream(DiskStreamRef.OrderID);
147	if (!DiskStreamRef.pStream) {
148	std::cout << stderr << "Disk stream not available in time!" << std::endl << std::flush;
149	Kill();
150	return;
151	}
152	DiskStreamRef.pStream->IncrementReadPos(pSample->Channels * (double_to_int(Pos) - MaxRAMPos));
153	Pos -= double_to_int(Pos);
154	}
155
156	// add silence sample at the end if we reached the end of the stream (for the interpolator)
157	if (DiskStreamRef.State == Stream::state_end && DiskStreamRef.pStream->GetReadSpace() < (OutputBufferSize << MAX_PITCH) / pSample->Channels) {
158	DiskStreamRef.pStream->WriteSilence((OutputBufferSize << MAX_PITCH) / pSample->Channels);
159	this->PlaybackState = playback_state_end;
160	}
161
162	sample_t* ptr = DiskStreamRef.pStream->GetReadPtr(); // get the current read_ptr within the ringbuffer where we read the samples from
163	Interpolate(ptr);
164	DiskStreamRef.pStream->IncrementReadPos(double_to_int(Pos) * pSample->Channels);
165	Pos -= double_to_int(Pos);
166	}
167	break;
168
169	case playback_state_end:
170	Kill(); // free voice
171	break;
172	}
173	}
174
175	/**
176	* Interpolates the input audio data (no loop).
177	*
178	* @param pSrc - pointer to input sample data
179	*/
180	void Voice::Interpolate(sample_t* pSrc) {
181	float effective_volume = this->Volume;
182	int i = 0;
183
184	// ************************************************
185	// TODO: ARTICULATION DATA HANDLING IS MISSING HERE
186	// ************************************************
187
188	// FIXME: assuming either mono or stereo
189	if (this->pSample->Channels == 2) { // Stereo Sample
190	while (i < this->OutputBufferSize) {
191	InterpolateOneStep_Stereo(pSrc, i, effective_volume);
192	}
193	}
194	else { // Mono Sample
195	while (i < this->OutputBufferSize) {
196	InterpolateOneStep_Mono(pSrc, i, effective_volume);
197	}
198	}
199	}
200
201	/**
202	* Interpolates the input audio data, this method honors looping.
203	*
204	* @param pSrc - pointer to input sample data
205	*/
206	void Voice::InterpolateAndLoop(sample_t* pSrc) {
207	float effective_volume = this->Volume;
208	int i = 0;
209
210	// ************************************************
211	// TODO: ARTICULATION DATA HANDLING IS MISSING HERE
212	// ************************************************
213
214	// FIXME: assuming either mono or stereo
215	if (pSample->Channels == 2) { // Stereo Sample
216	if (pSample->LoopPlayCount) {
217	// render loop (loop count limited)
218	while (i < OutputBufferSize && LoopCyclesLeft) {
219	InterpolateOneStep_Stereo(pSrc, i, effective_volume);
220	if (Pos > pSample->LoopEnd) {
221	Pos = pSample->LoopStart + fmod(Pos - pSample->LoopEnd, pSample->LoopSize);;
222	LoopCyclesLeft--;
223	}
224	}
225	// render on without loop
226	while (i < OutputBufferSize) {
227	InterpolateOneStep_Stereo(pSrc, i, effective_volume);
228	}
229	}
230	else { // render loop (endless loop)
231	while (i < OutputBufferSize) {
232	InterpolateOneStep_Stereo(pSrc, i, effective_volume);
233	if (Pos > pSample->LoopEnd) {
234	Pos = pSample->LoopStart + fmod(Pos - pSample->LoopEnd, pSample->LoopSize);
235	}
236	}
237	}
238	}
239	else { // Mono Sample
240	if (pSample->LoopPlayCount) {
241	// render loop (loop count limited)
242	while (i < OutputBufferSize && LoopCyclesLeft) {
243	InterpolateOneStep_Mono(pSrc, i, effective_volume);
244	if (Pos > pSample->LoopEnd) {
245	Pos = pSample->LoopStart + fmod(Pos - pSample->LoopEnd, pSample->LoopSize);;
246	LoopCyclesLeft--;
247	}
248	}
249	// render on without loop
250	while (i < OutputBufferSize) {
251	InterpolateOneStep_Mono(pSrc, i, effective_volume);
252	}
253	}
254	else { // render loop (endless loop)
255	while (i < OutputBufferSize) {
256	InterpolateOneStep_Mono(pSrc, i, effective_volume);
257	if (Pos > pSample->LoopEnd) {
258	Pos = pSample->LoopStart + fmod(Pos - pSample->LoopEnd, pSample->LoopSize);;
259	}
260	}
261	}
262	}
263	}
264
265	/**
266	* Immediately kill the voice.
267	*/
268	void Voice::Kill() {
269	if (DiskVoice && DiskStreamRef.State != Stream::state_unused) {
270	pDiskThread->OrderDeletionOfStream(&DiskStreamRef);
271	}
272	DiskStreamRef.pStream = NULL;
273	DiskStreamRef.hStream = 0;
274	DiskStreamRef.State = Stream::state_unused;
275	DiskStreamRef.OrderID = 0;
276	Active = false;
277	}