/[svn]/linuxsampler/trunk/src/engines/gig/Synthesizer.h
ViewVC logotype

Annotation of /linuxsampler/trunk/src/engines/gig/Synthesizer.h

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1424 - (hide annotations) (download) (as text)
Sun Oct 14 22:00:17 2007 UTC (16 years, 6 months ago) by schoenebeck
File MIME type: text/x-c++hdr
File size: 16008 byte(s)
* code cleanup:
- global.h now only covers global definitions that are needed for the C++
  API header files, all implementation internal global definitions are now
  in global_private.h
- atomic.h is not exposed to the C++ API anymore (replaced the references
  in SynchronizedConfig.h for this with local definitions)
- no need to include config.h anymore for using LS's API header files
- DB instruments classes are not exposed to the C++ API
- POSIX callback functions of Thread.h are hidden
- the (optional) gig Engine benchmark compiles again
- updated Doxyfile.in
- fixed warnings in API doc generation
* preparations for release 0.5.0

1 schoenebeck 320 /***************************************************************************
2     * *
3     * LinuxSampler - modular, streaming capable sampler *
4     * *
5     * Copyright (C) 2003, 2004 by Benno Senoner and Christian Schoenebeck *
6 schoenebeck 1424 * Copyright (C) 2005 - 2007 Christian Schoenebeck *
7 schoenebeck 320 * *
8     * This program is free software; you can redistribute it and/or modify *
9     * it under the terms of the GNU General Public License as published by *
10     * the Free Software Foundation; either version 2 of the License, or *
11     * (at your option) any later version. *
12     * *
13     * This program is distributed in the hope that it will be useful, *
14     * but WITHOUT ANY WARRANTY; without even the implied warranty of *
15     * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
16     * GNU General Public License for more details. *
17     * *
18     * You should have received a copy of the GNU General Public License *
19     * along with this program; if not, write to the Free Software *
20     * Foundation, Inc., 59 Temple Place, Suite 330, Boston, *
21     * MA 02111-1307 USA *
22     ***************************************************************************/
23    
24     #ifndef __LS_GIG_SYNTHESIZER_H__
25     #define __LS_GIG_SYNTHESIZER_H__
26    
27 schoenebeck 1424 #include "../../common/global_private.h"
28 schoenebeck 320 #include "../../common/RTMath.h"
29     #include "../common/Resampler.h"
30     #include "Filter.h"
31 schoenebeck 770 #include "SynthesisParam.h"
32 schoenebeck 320
33 schoenebeck 738 #define SYNTHESIS_MODE_SET_INTERPOLATE(iMode,bVal) if (bVal) iMode |= 0x01; else iMode &= ~0x01 /* (un)set mode bit 0 */
34     #define SYNTHESIS_MODE_SET_FILTER(iMode,bVal) if (bVal) iMode |= 0x02; else iMode &= ~0x02 /* (un)set mode bit 1 */
35     #define SYNTHESIS_MODE_SET_LOOP(iMode,bVal) if (bVal) iMode |= 0x04; else iMode &= ~0x04 /* (un)set mode bit 2 */
36     #define SYNTHESIS_MODE_SET_CHANNELS(iMode,bVal) if (bVal) iMode |= 0x08; else iMode &= ~0x08 /* (un)set mode bit 3 */
37 persson 903 #define SYNTHESIS_MODE_SET_BITDEPTH24(iMode,bVal) if (bVal) iMode |= 0x10; else iMode &= ~0x10 /* (un)set mode bit 4 */
38     #define SYNTHESIS_MODE_SET_IMPLEMENTATION(iMode,bVal) if (bVal) iMode |= 0x20; else iMode &= ~0x20 /* (un)set mode bit 5 */
39     #define SYNTHESIS_MODE_SET_PROFILING(iMode,bVal) if (bVal) iMode |= 0x40; else iMode &= ~0x40 /* (un)set mode bit 6 */
40 schoenebeck 320
41 schoenebeck 738 #define SYNTHESIS_MODE_GET_INTERPOLATE(iMode) iMode & 0x01
42     #define SYNTHESIS_MODE_GET_FILTER(iMode) iMode & 0x02
43     #define SYNTHESIS_MODE_GET_LOOP(iMode) iMode & 0x04
44     #define SYNTHESIS_MODE_GET_CHANNELS(iMode) iMode & 0x08
45 persson 903 #define SYNTHESIS_MODE_GET_BITDEPTH24(iMode) iMode & 0x10
46     #define SYNTHESIS_MODE_GET_IMPLEMENTATION(iMode) iMode & 0x20
47 schoenebeck 738
48 persson 903
49 schoenebeck 320 namespace LinuxSampler { namespace gig {
50    
51 schoenebeck 770 typedef void SynthesizeFragment_Fn(SynthesisParam* pFinalParam, Loop* pLoop);
52 schoenebeck 320
53     void* GetSynthesisFunction(const int SynthesisMode);
54 schoenebeck 770 void RunSynthesisFunction(const int SynthesisMode, SynthesisParam* pFinalParam, Loop* pLoop);
55 schoenebeck 320
56     enum channels_t {
57     MONO,
58     STEREO
59     };
60    
61 schoenebeck 563 /** @brief Main Synthesis algorithms for the gig::Engine
62     *
63     * Implementation of the main synthesis algorithms of the Gigasampler
64     * format capable sampler engine. This means resampling / interpolation
65     * for pitching the audio signal, looping, filter and amplification.
66     */
67 persson 903 template<channels_t CHANNELS, bool DOLOOP, bool USEFILTER, bool INTERPOLATE, bool BITDEPTH24>
68     class Synthesizer : public __RTMath<CPP>, public LinuxSampler::Resampler<INTERPOLATE,BITDEPTH24> {
69 persson 497
70     // declarations of derived functions (see "Name lookup,
71     // templates, and accessing members of base classes" in
72     // the gcc manual for an explanation of why this is
73     // needed).
74 schoenebeck 770 //using LinuxSampler::Resampler<INTERPOLATE>::GetNextSampleMonoCPP;
75     //using LinuxSampler::Resampler<INTERPOLATE>::GetNextSampleStereoCPP;
76 persson 903 using LinuxSampler::Resampler<INTERPOLATE,BITDEPTH24>::Interpolate1StepMonoCPP;
77     using LinuxSampler::Resampler<INTERPOLATE,BITDEPTH24>::Interpolate1StepStereoCPP;
78 persson 497
79 schoenebeck 320 public:
80     //protected:
81    
82 schoenebeck 770 static void SynthesizeSubFragment(SynthesisParam* pFinalParam, Loop* pLoop) {
83 schoenebeck 320 if (DOLOOP) {
84 schoenebeck 770 const float fLoopEnd = Float(pLoop->uiEnd);
85     const float fLoopStart = Float(pLoop->uiStart);
86     const float fLoopSize = Float(pLoop->uiSize);
87     if (pLoop->uiTotalCycles) {
88 schoenebeck 320 // render loop (loop count limited)
89 schoenebeck 770 for (; pFinalParam->uiToGo > 0 && pLoop->uiCyclesLeft; pLoop->uiCyclesLeft -= WrapLoop(fLoopStart, fLoopSize, fLoopEnd, &pFinalParam->dPos)) {
90     const uint uiToGo = Min(pFinalParam->uiToGo, DiffToLoopEnd(fLoopEnd, &pFinalParam->dPos, pFinalParam->fFinalPitch) + 1); //TODO: instead of +1 we could also round up
91     SynthesizeSubSubFragment(pFinalParam, uiToGo);
92 schoenebeck 320 }
93     // render on without loop
94 schoenebeck 770 SynthesizeSubSubFragment(pFinalParam, pFinalParam->uiToGo);
95     } else { // render loop (endless loop)
96     for (; pFinalParam->uiToGo > 0; WrapLoop(fLoopStart, fLoopSize, fLoopEnd, &pFinalParam->dPos)) {
97     const uint uiToGo = Min(pFinalParam->uiToGo, DiffToLoopEnd(fLoopEnd, &pFinalParam->dPos, pFinalParam->fFinalPitch) + 1); //TODO: instead of +1 we could also round up
98     SynthesizeSubSubFragment(pFinalParam, uiToGo);
99 schoenebeck 320 }
100     }
101 schoenebeck 770 } else { // no looping
102     SynthesizeSubSubFragment(pFinalParam, pFinalParam->uiToGo);
103 schoenebeck 320 }
104     }
105    
106 schoenebeck 563 /**
107     * Returns the difference to the sample's loop end.
108     */
109 schoenebeck 320 inline static int DiffToLoopEnd(const float& LoopEnd, const void* Pos, const float& Pitch) {
110 schoenebeck 770 return uint((LoopEnd - *((double *)Pos)) / Pitch);
111 schoenebeck 320 }
112    
113 schoenebeck 770 #if 0
114 schoenebeck 738 //TODO: this method is not in use yet, it's intended to be used for pitch=x.0f where we could use integer instead of float as playback position variable
115     inline static int WrapLoop(const int& LoopStart, const int& LoopSize, const int& LoopEnd, int& Pos) {
116 schoenebeck 770 //TODO: we can easily eliminate the branch here
117     if (Pos < LoopEnd) return 0;
118     Pos = (Pos - LoopEnd) % LoopSize + LoopStart;
119     return 1;
120 schoenebeck 738 }
121 schoenebeck 770 #endif
122 schoenebeck 738
123 schoenebeck 563 /**
124     * This method handles looping of the RAM playback part of the
125     * sample, thus repositioning the playback position once the
126     * loop limit was reached. Note: looping of the disk streaming
127     * part is handled by libgig (ReadAndLoop() method which will
128     * be called by the DiskThread).
129     */
130 schoenebeck 320 inline static int WrapLoop(const float& LoopStart, const float& LoopSize, const float& LoopEnd, void* vPos) {
131 schoenebeck 770 double * Pos = (double *)vPos;
132     if (*Pos < LoopEnd) return 0;
133     *Pos = fmod(*Pos - LoopEnd, LoopSize) + LoopStart;
134     return 1;
135 schoenebeck 320 }
136    
137 persson 903 static int getSample(sample_t* src, int pos) {
138     if (BITDEPTH24) {
139     pos *= 3;
140     unsigned char* p = (unsigned char*)src;
141     return p[pos] << 8 | p[pos + 1] << 16 | p[pos + 2] << 24;
142     } else {
143     return src[pos];
144     }
145     }
146    
147 schoenebeck 770 static void SynthesizeSubSubFragment(SynthesisParam* pFinalParam, uint uiToGo) {
148 persson 830 float fVolumeL = pFinalParam->fFinalVolumeLeft;
149     float fVolumeR = pFinalParam->fFinalVolumeRight;
150     sample_t* pSrc = pFinalParam->pSrc;
151     float* pOutL = pFinalParam->pOutLeft;
152     float* pOutR = pFinalParam->pOutRight;
153     #ifdef CONFIG_INTERPOLATE_VOLUME
154     float fDeltaL = pFinalParam->fFinalVolumeDeltaLeft;
155     float fDeltaR = pFinalParam->fFinalVolumeDeltaRight;
156     #endif
157 schoenebeck 770 switch (CHANNELS) {
158     case MONO: {
159 persson 830 float samplePoint;
160 schoenebeck 770 if (INTERPOLATE) {
161 persson 830 double dPos = pFinalParam->dPos;
162     float fPitch = pFinalParam->fFinalPitch;
163 schoenebeck 770 if (USEFILTER) {
164     Filter filterL = pFinalParam->filterLeft;
165     for (int i = 0; i < uiToGo; ++i) {
166     samplePoint = Interpolate1StepMonoCPP(pSrc, &dPos, fPitch);
167     samplePoint = filterL.Apply(samplePoint);
168 persson 830 #ifdef CONFIG_INTERPOLATE_VOLUME
169     fVolumeL += fDeltaL;
170     fVolumeR += fDeltaR;
171     #endif
172 schoenebeck 770 pOutL[i] += samplePoint * fVolumeL;
173     pOutR[i] += samplePoint * fVolumeR;
174     }
175     } else { // no filter needed
176     for (int i = 0; i < uiToGo; ++i) {
177     samplePoint = Interpolate1StepMonoCPP(pSrc, &dPos, fPitch);
178 persson 830 #ifdef CONFIG_INTERPOLATE_VOLUME
179     fVolumeL += fDeltaL;
180     fVolumeR += fDeltaR;
181     #endif
182 schoenebeck 770 pOutL[i] += samplePoint * fVolumeL;
183     pOutR[i] += samplePoint * fVolumeR;
184     }
185 schoenebeck 320 }
186 persson 830 pFinalParam->dPos = dPos;
187 schoenebeck 770 } else { // no interpolation
188 persson 830 int pos_offset = (int) pFinalParam->dPos;
189 schoenebeck 770 if (USEFILTER) {
190     Filter filterL = pFinalParam->filterLeft;
191     for (int i = 0; i < uiToGo; ++i) {
192 persson 903 samplePoint = getSample(pSrc, i + pos_offset);
193 schoenebeck 770 samplePoint = filterL.Apply(samplePoint);
194 persson 830 #ifdef CONFIG_INTERPOLATE_VOLUME
195     fVolumeL += fDeltaL;
196     fVolumeR += fDeltaR;
197     #endif
198 schoenebeck 770 pOutL[i] += samplePoint * fVolumeL;
199     pOutR[i] += samplePoint * fVolumeR;
200 schoenebeck 320 }
201 schoenebeck 770 } else { // no filter needed
202     for (int i = 0; i < uiToGo; ++i) {
203 persson 903 samplePoint = getSample(pSrc, i + pos_offset);
204 persson 830 #ifdef CONFIG_INTERPOLATE_VOLUME
205     fVolumeL += fDeltaL;
206     fVolumeR += fDeltaR;
207     #endif
208 schoenebeck 770 pOutL[i] += samplePoint * fVolumeL;
209     pOutR[i] += samplePoint * fVolumeR;
210     }
211 schoenebeck 320 }
212 persson 830 pFinalParam->dPos += uiToGo;
213 schoenebeck 320 }
214     break;
215     }
216 schoenebeck 770 case STEREO: {
217 persson 830 stereo_sample_t samplePoint;
218 schoenebeck 770 if (INTERPOLATE) {
219 persson 830 double dPos = pFinalParam->dPos;
220     float fPitch = pFinalParam->fFinalPitch;
221 schoenebeck 770 if (USEFILTER) {
222     Filter filterL = pFinalParam->filterLeft;
223     Filter filterR = pFinalParam->filterRight;
224     for (int i = 0; i < uiToGo; ++i) {
225     samplePoint = Interpolate1StepStereoCPP(pSrc, &dPos, fPitch);
226     samplePoint.left = filterL.Apply(samplePoint.left);
227     samplePoint.right = filterR.Apply(samplePoint.right);
228 persson 830 #ifdef CONFIG_INTERPOLATE_VOLUME
229     fVolumeL += fDeltaL;
230     fVolumeR += fDeltaR;
231     #endif
232 schoenebeck 770 pOutL[i] += samplePoint.left * fVolumeL;
233     pOutR[i] += samplePoint.right * fVolumeR;
234 schoenebeck 320 }
235 schoenebeck 770 } else { // no filter needed
236     for (int i = 0; i < uiToGo; ++i) {
237     samplePoint = Interpolate1StepStereoCPP(pSrc, &dPos, fPitch);
238 persson 830 #ifdef CONFIG_INTERPOLATE_VOLUME
239     fVolumeL += fDeltaL;
240     fVolumeR += fDeltaR;
241     #endif
242 schoenebeck 770 pOutL[i] += samplePoint.left * fVolumeL;
243     pOutR[i] += samplePoint.right * fVolumeR;
244     }
245 schoenebeck 320 }
246 persson 830 pFinalParam->dPos = dPos;
247 schoenebeck 770 } else { // no interpolation
248 persson 830 int pos_offset = ((int) pFinalParam->dPos) << 1;
249 schoenebeck 770 if (USEFILTER) {
250     Filter filterL = pFinalParam->filterLeft;
251     Filter filterR = pFinalParam->filterRight;
252     for (int i = 0, ii = 0; i < uiToGo; ++i, ii+=2) {
253 persson 903 samplePoint.left = getSample(pSrc, ii + pos_offset);
254     samplePoint.right = getSample(pSrc, ii + pos_offset + 1);
255 schoenebeck 770 samplePoint.left = filterL.Apply(samplePoint.left);
256     samplePoint.right = filterR.Apply(samplePoint.right);
257 persson 830 #ifdef CONFIG_INTERPOLATE_VOLUME
258     fVolumeL += fDeltaL;
259     fVolumeR += fDeltaR;
260     #endif
261 schoenebeck 770 pOutL[i] += samplePoint.left * fVolumeL;
262     pOutR[i] += samplePoint.right * fVolumeR;
263 schoenebeck 320 }
264 schoenebeck 770 } else { // no filter needed
265     for (int i = 0, ii = 0; i < uiToGo; ++i, ii+=2) {
266 persson 903 samplePoint.left = getSample(pSrc, ii + pos_offset);
267     samplePoint.right = getSample(pSrc, ii + pos_offset + 1);
268 persson 830 #ifdef CONFIG_INTERPOLATE_VOLUME
269     fVolumeL += fDeltaL;
270     fVolumeR += fDeltaR;
271     #endif
272 schoenebeck 770 pOutL[i] += samplePoint.left * fVolumeL;
273     pOutR[i] += samplePoint.right * fVolumeR;
274     }
275 schoenebeck 320 }
276 persson 830 pFinalParam->dPos += uiToGo;
277 schoenebeck 320 }
278 schoenebeck 770 break;
279 schoenebeck 320 }
280     }
281 persson 830 pFinalParam->fFinalVolumeLeft = fVolumeL;
282     pFinalParam->fFinalVolumeRight = fVolumeR;
283 schoenebeck 770 pFinalParam->pOutRight += uiToGo;
284     pFinalParam->pOutLeft += uiToGo;
285     pFinalParam->uiToGo -= uiToGo;
286 schoenebeck 320 }
287     };
288    
289     }} // namespace LinuxSampler::gig
290    
291     #endif // __LS_GIG_SYNTHESIZER_H__

  ViewVC Help
Powered by ViewVC