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
|
/*----------------------------------------------------------------------------
*
* File:
* eas_wtengine.h
*
* Contents and purpose:
* This file defines the interface for wavetable synthesis engine
*
* Copyright Sonic Network Inc. 2004
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
*----------------------------------------------------------------------------
* Revision Control:
* $Revision: 818 $
* $Date: 2007-08-02 15:19:41 -0700 (Thu, 02 Aug 2007) $
*----------------------------------------------------------------------------
*/
#ifndef _EAS_WTENGINE_H
#define _EAS_WTENGINE_H
/* option sanity check */
#if defined(_OPTIMIZED_MONO) && defined(_FILTER_ENABLED)
#error "Incompatible build settings: _OPTIMIZED_MONO cannot be used with _FILTER_ENABLED"
#endif
#if defined(_OPTIMIZED_MONO) && (NUM_OUTPUT_CHANNELS != 1)
#error "Incompatible build settings: _OPTIMIZED_MONO can only be used with NUM_OUTPUT_CHANNELS = 1"
#endif
#include "eas_wt_IPC_frame.h"
/*----------------------------------------------------------------------------
* defines
*----------------------------------------------------------------------------
*/
#define WT_NOISE_GENERATOR 0xffffffff
/*----------------------------------------------------------------------------
* typedefs
*----------------------------------------------------------------------------
*/
/*----------------------------------------------------------------------------
* S_WT_INT_FRAME
*
* This structure includes S_WT_FRAME plus the bus mixing
* parameters for the internal voices.
*----------------------------------------------------------------------------
*/
typedef struct s_wt_int_frame_tag
{
S_WT_FRAME frame;
EAS_PCM *pAudioBuffer;
EAS_I32 *pMixBuffer;
EAS_I32 numSamples;
EAS_I32 prevGain;
} S_WT_INT_FRAME;
#if defined(_FILTER_ENABLED)
/*----------------------------------------------------------------------------
* S_FILTER_CONTROL data structure
*----------------------------------------------------------------------------
*/
typedef struct s_filter_control_tag
{
EAS_I16 z1; /* 1 sample delay state variable */
EAS_I16 z2; /* 2 sample delay state variable */
} S_FILTER_CONTROL;
#endif
/*------------------------------------
* S_LFO_CONTROL data structure
*------------------------------------
*/
typedef struct s_lfo_control_tag
{
EAS_I16 lfoValue; /* LFO current output value */
EAS_I16 lfoPhase; /* LFO current phase */
} S_LFO_CONTROL;
/* bit definitions for S_WT_VOICE:flags */
#define WT_FLAGS_ADPCM_NIBBLE 1 /* high/low nibble flag */
#define WT_FLAGS_ADPCM_READY 2 /* first 2 samples are decoded */
#define WT_FLAGS_USE_ADPCM 4 /* sample is ADPCM encoded */
/* eg1State and eg2State */
typedef enum {
eEnvelopeStateInit = 0,
eEnvelopeStateDelay,
eEnvelopeStateAttack,
eEnvelopeStateHold,
eEnvelopeStateDecay,
eEnvelopeStateSustain,
eEnvelopeStateRelease,
eEnvelopeStateMuting,
eEnvelopeStateMuted,
eEnvelopeStateInvalid /* should never be in this state! */
} E_ENVELOPE_STATE;
#define DEFAULT_EG1_STATE eEnvelopeStateAttack
#define DEFAULT_EG1_VALUE 0
#define DEFAULT_EG1_INCREMENT 0
#define DEFAULT_EG2_STATE eEnvelopeStateAttack
#define DEFAULT_EG2_VALUE 0
#define DEFAULT_EG2_INCREMENT 0
/*----------------------------------------------------------------------------
* S_WT_VOICE
*
* This structure contains state data for the wavetable engine
*----------------------------------------------------------------------------
*/
typedef struct s_wt_voice_tag
{
EAS_U32 loopEnd; /* points to last PCM sample (not 1 beyond last) */
EAS_U32 loopStart; /* points to first sample at start of loop */
EAS_U32 phaseAccum; /* current sample, integer portion of phase */
EAS_U32 phaseFrac; /* fractional portion of phase */
#if (NUM_OUTPUT_CHANNELS == 2)
EAS_I16 gainLeft; /* current gain, left ch */
EAS_I16 gainRight; /* current gain, right ch */
#endif
#if defined(_FILTER_ENABLED)
S_FILTER_CONTROL filter; /* low pass filter */
#endif
S_LFO_CONTROL modLFO; /* modulator LFO */
#ifdef DLS_SYNTHESIZER
S_LFO_CONTROL vibLFO; /* vibrato LFO */
#endif
/* envelope control */
EAS_I16 eg1Value;
EAS_I16 eg2Value;
EAS_I16 eg1Increment;
EAS_I16 eg2Increment;
EAS_U8 eg1State;
EAS_U8 eg2State;
EAS_U16 artIndex; /* index to articulation params */
} S_WT_VOICE;
/*----------------------------------------------------------------------------
* prototypes
*----------------------------------------------------------------------------
*/
EAS_BOOL WT_CheckSampleEnd (S_WT_VOICE *pWTVoice, S_WT_INT_FRAME *pWTIntFrame, EAS_BOOL update);
void WT_ProcessVoice (S_WT_VOICE *pWTVoice, S_WT_INT_FRAME *pWTIntFrame);
#ifdef EAS_SPLIT_WT_SYNTH
void WTE_ConfigVoice (EAS_I32 voiceNum, S_WT_CONFIG *pWTConfig, EAS_FRAME_BUFFER_HANDLE pFrameBuffer);
void WTE_ProcessVoice (EAS_I32 voiceNum, S_WT_FRAME *pWTParams, EAS_FRAME_BUFFER_HANDLE pFrameBuffer);
#endif
#endif
|
