| /*---------------------------------------------------------------------------- |
| * |
| * 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 */ |
| |
