| /*---------------------------------------------------------------------------- | |
| * | |
| * File: | |
| * eas_pcmdata.h | |
| * | |
| * Contents and purpose: | |
| * Data declarations for the PCM engine | |
| * | |
| * | |
| * Copyright Sonic Network Inc. 2005 | |
| * 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: 847 $ | |
| * $Date: 2007-08-27 21:30:08 -0700 (Mon, 27 Aug 2007) $ | |
| *---------------------------------------------------------------------------- | |
| */ | |
| #ifndef _EAS_PCMDATA_H | |
| #define _EAS_PCMDATA_H | |
| /* sets the maximum number of simultaneous PCM streams */ | |
| #ifndef MAX_PCM_STREAMS | |
| #define MAX_PCM_STREAMS 16 | |
| #define PCM_STREAM_THRESHOLD (MAX_PCM_STREAMS - 4) | |
| #endif | |
| /* coefficents for high-pass filter in ADPCM */ | |
| #define INTEGRATOR_COEFFICIENT 100 /* coefficient for leaky integrator */ | |
| /* additional flags in S_PCM_STATE.flags used internal to module */ | |
| #define PCM_FLAGS_EMPTY 0x01000000 /* unsigned format */ | |
| /*---------------------------------------------------------------------------- | |
| * S_PCM_STATE | |
| * | |
| * Retains state information for PCM streams. | |
| *---------------------------------------------------------------------------- | |
| */ | |
| typedef struct s_decoder_state_tag | |
| { | |
| EAS_I32 output; /* last output for DC offset filter */ | |
| EAS_I32 acc; /* accumulator for DC offset filter */ | |
| EAS_I32 step; /* current ADPCM step size */ | |
| EAS_PCM x1; /* current generated sample */ | |
| EAS_PCM x0; /* previous generated sample */ | |
| } S_DECODER_STATE; | |
| typedef enum | |
| { | |
| PCM_ENV_START = 0, | |
| PCM_ENV_ATTACK, | |
| PCM_ENV_DECAY, | |
| PCM_ENV_SUSTAIN, | |
| PCM_ENV_RELEASE, | |
| PCM_ENV_END | |
| } E_PCM_ENV_STATE; | |
| typedef struct s_pcm_state_tag | |
| { | |
| #ifdef _CHECKED_BUILD | |
| EAS_U32 handleCheck; /* signature check for checked build */ | |
| #endif | |
| EAS_FILE_HANDLE fileHandle; /* pointer to input file */ | |
| EAS_PCM_CALLBACK pCallback; /* pointer to callback function */ | |
| EAS_VOID_PTR cbInstData; /* instance data for callback function */ | |
| struct s_decoder_interface_tag EAS_CONST * pDecoder; /* pointer to decoder interface */ | |
| EAS_STATE state; /* stream state */ | |
| EAS_I32 time; /* media time */ | |
| EAS_I32 startPos; /* start of PCM stream */ | |
| EAS_I32 loopLocation; /* file location where loop starts */ | |
| EAS_I32 byteCount; /* size of file */ | |
| EAS_U32 loopStart; /* loop start, offset in samples from startPos */ | |
| /* NOTE: For CMF, we use this to store total sample size */ | |
| EAS_U32 loopSamples; /* total loop length, in samples, 0 means no loop */ | |
| /* NOTE: For CMF, non-zero means looped */ | |
| EAS_U32 samplesInLoop; /* samples left in the loop to play back */ | |
| EAS_I32 samplesTilLoop; /* samples left to play until top of loop */ | |
| EAS_I32 bytesLeft; /* count of bytes left in stream */ | |
| EAS_I32 bytesLeftLoop; /* count of bytes left in stream, value at start of loop */ | |
| EAS_U32 phase; /* current phase for interpolator */ | |
| EAS_U32 basefreq; /* frequency multiplier */ | |
| EAS_U32 flags; /* stream flags */ | |
| EAS_U32 envData; /* envelope data (and LFO data) */ | |
| EAS_U32 envValue; /* current envelope value */ | |
| EAS_U32 envScale; /* current envelope scale */ | |
| EAS_U32 startOrder; /* start order index, first is 0, next is 1, etc. */ | |
| S_DECODER_STATE decoderL; /* left (mono) ADPCM state */ | |
| S_DECODER_STATE decoderR; /* right ADPCM state */ | |
| S_DECODER_STATE decoderLLoop; /* left (mono) ADPCM state, value at start of loop */ | |
| S_DECODER_STATE decoderRLoop; /* right ADPCM state, value at start of loop */ | |
| E_PCM_ENV_STATE envState; /* current envelope state */ | |
| EAS_I16 volume; /* volume for stream */ | |
| EAS_I16 pitch; /* relative pitch in cents - zero is unity playback */ | |
| EAS_I16 gainLeft; /* requested gain */ | |
| EAS_I16 gainRight; /* requested gain */ | |
| EAS_I16 currentGainLeft; /* current gain for anti-zipper filter */ | |
| EAS_I16 currentGainRight; /* current gain for anti-zipper filter */ | |
| EAS_U16 blockSize; /* block size for ADPCM decoder */ | |
| EAS_U16 blockCount; /* block counter for ADPCM decoder */ | |
| EAS_U16 sampleRate; /* input sample rate */ | |
| EAS_U8 srcByte; /* source byte */ | |
| EAS_U8 msBitCount; /* count keeps track of MS bits */ | |
| EAS_U8 msBitMask; /* mask keeps track of MS bits */ | |
| EAS_U8 msBitValue; /* value keeps track of MS bits */ | |
| EAS_U8 msBitCountLoop; /* count keeps track of MS bits, value at loop start */ | |
| EAS_U8 msBitMaskLoop; /* mask keeps track of MS bits, value at loop start */ | |
| EAS_U8 msBitValueLoop; /* value keeps track of MS bits, value at loop start */ | |
| EAS_BOOL8 hiNibble; /* indicates high/low nibble is next */ | |
| EAS_BOOL8 hiNibbleLoop; /* indicates high/low nibble is next, value loop start */ | |
| EAS_U8 rateShift; /* for playback rate greater than 1.0 */ | |
| } S_PCM_STATE; | |
| /*---------------------------------------------------------------------------- | |
| * S_DECODER_INTERFACE | |
| * | |
| * Generic interface for audio decoders | |
| *---------------------------------------------------------------------------- | |
| */ | |
| typedef struct s_decoder_interface_tag | |
| { | |
| EAS_RESULT (* EAS_CONST pfInit)(EAS_DATA_HANDLE pEASData, S_PCM_STATE *pState); | |
| EAS_RESULT (* EAS_CONST pfDecodeSample)(EAS_DATA_HANDLE pEASData, S_PCM_STATE *pState); | |
| EAS_RESULT (* EAS_CONST pfLocate)(EAS_DATA_HANDLE pEASData, S_PCM_STATE *pState, EAS_I32 time); | |
| } S_DECODER_INTERFACE; | |
| /* header chunk for SMAF ADPCM */ | |
| #define TAG_YAMAHA_ADPCM 0x4d776100 | |
| #define TAG_MASK 0xffffff00 | |
| #define TAG_RIFF_FILE 0x52494646 | |
| #define TAG_WAVE_CHUNK 0x57415645 | |
| #define TAG_FMT_CHUNK 0x666d7420 | |
| /*---------------------------------------------------------------------------- | |
| * EAS_PESeek | |
| *---------------------------------------------------------------------------- | |
| * Purpose: | |
| * Locate to a particular byte in a PCM stream | |
| *---------------------------------------------------------------------------- | |
| */ | |
| EAS_RESULT EAS_PESeek (EAS_DATA_HANDLE pEASData, S_PCM_STATE *pState, EAS_I32 *pLocation); | |
| #endif /* _EAS_PCMDATA_H */ | |