engines/gig/EGDecay.h

/***************************************************************************
 *                                                                         *
 *   LinuxSampler - modular, streaming capable sampler                     *
 *                                                                         *
 *   Copyright (C) 2003, 2004 by Benno Senoner and Christian Schoenebeck   *
 *   Copyright (C) 2005 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                                                   *
 ***************************************************************************/

#ifndef __LS_GIG_EGDECAY_H__
#define __LS_GIG_EGDECAY_H__

#include "../../common/global.h"

#if DEBUG_HEADERS
# warning EGDecay.h included
#endif // DEBUG_HEADERS

#include "../../common/RTMath.h"
#include "../common/Event.h"
#include "Engine.h"

namespace LinuxSampler { namespace gig {

    // just symbol prototyping
    class Engine;

    /**
     * Decay Envelope Generator
     *
     * Simple Envelope Generator with only one stage: 'Decay'. We currently use
     * this specific EG only for pitch and thus it's not generalized yet, means
     * the initial envelope level (given by 'Depth') will raise / drop in
     * 'DecayTime' seconds to a level of exactly 1.0. If the initial level
     * ('Depth') is already 1.0, nothing happens. Beside that, the EG just
     * multiplies it's levels to the synthesis parameter sequence.
     */
    class EGDecay {
        public:
            EGDecay(gig::Engine* pEngine, Event::destination_t ModulationDestination);
            bool Process(uint Samples);
            void Trigger(float Depth, double DecayTime, uint Delay);
        protected:
            gig::Engine* pEngine;
            Event::destination_t ModulationDestination;
            uint  TriggerDelay;    ///< number of sample points triggering should be delayed
            float Level;
            float DecayCoeff;
            long  DecayStepsLeft;
    };

}} // namespace LinuxSampler::gig

#endif // __LS_GIG_EGDECAY_H__
1	/***************************************************************************
2	* *
3	* LinuxSampler - modular, streaming capable sampler *
4	* *
5	* Copyright (C) 2003, 2004 by Benno Senoner and Christian Schoenebeck *
6	* Copyright (C) 2005 Christian Schoenebeck *
7	* *
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_EGDECAY_H__
25	#define __LS_GIG_EGDECAY_H__
26
27	#include "../../common/global.h"
28
29	#if DEBUG_HEADERS
30	# warning EGDecay.h included
31	#endif // DEBUG_HEADERS
32
33	#include "../../common/RTMath.h"
34	#include "../common/Event.h"
35	#include "Engine.h"
36
37	namespace LinuxSampler { namespace gig {
38
39	// just symbol prototyping
40	class Engine;
41
42	/**
43	* Decay Envelope Generator
44	*
45	* Simple Envelope Generator with only one stage: 'Decay'. We currently use
46	* this specific EG only for pitch and thus it's not generalized yet, means
47	* the initial envelope level (given by 'Depth') will raise / drop in
48	* 'DecayTime' seconds to a level of exactly 1.0. If the initial level
49	* ('Depth') is already 1.0, nothing happens. Beside that, the EG just
50	* multiplies it's levels to the synthesis parameter sequence.
51	*/
52	class EGDecay {
53	public:
54	EGDecay(gig::Engine* pEngine, Event::destination_t ModulationDestination);
55	bool Process(uint Samples);
56	void Trigger(float Depth, double DecayTime, uint Delay);
57	protected:
58	gig::Engine* pEngine;
59	Event::destination_t ModulationDestination;
60	uint TriggerDelay; ///< number of sample points triggering should be delayed
61	float Level;
62	float DecayCoeff;
63	long DecayStepsLeft;
64	};
65
66	}} // namespace LinuxSampler::gig
67
68	#endif // __LS_GIG_EGDECAY_H__