/*------------------------------------------------------------------------------ File : MPEGA_protos.h Author : Stéphane TAVENARD $VER: MPEGA_protos.h 1.0 (25/10/1997) (C) Copyright 1997-1997 Stéphane TAVENARD All Rights Reserved #Rev| Date | Comment ----|----------|-------------------------------------------------------- 0 |25/10/1997| Initial revision ST ------------------------------------------------------------------------ MPEGA decoder library functions prototypes ------------------------------------------------------------------------------*/ #ifndef CLIB_MPEGA_PROTOS_H #define CLIB_MPEGA_PROTOS_H #ifndef LIBRARIES_MPEGA_H #include #endif MPEGA_STREAM *MPEGA_open( char *stream_name, MPEGA_CTRL *ctrl ); /*-------------------------------------------------------------------------- Open an MPEG Audio stream Inputs: stream_name = name of stream to decode ctrl = decoding controls Return the mpeg audio stream ptr or NULL if failed to open stream */ void MPEGA_close( MPEGA_STREAM *mpds ); /*-------------------------------------------------------------------------- Close an MPEG Audio stream Input: mpds = mpeg audio stream ptr returned by MPEGA_open */ LONG MPEGA_decode_frame( MPEGA_STREAM *mpds, WORD *pcm[ MPEGA_MAX_CHANNELS ] ); /*-------------------------------------------------------------------------- Decode the current MPEG Audio frame Input: mpds = mpeg audio stream ptr returned by MPEGA_open Output: pcm[] = 16-bit samples pcm[ 0 ] is mono or left voice or channel 1 pcm[ 1 ] is right or channel 2 Return the number of samples or error code: MPEGA_ERR_EOF if end of stream MPEGA_ERR_BADFRAME if bad frame Note: pcm[]'s be at least arrays of MPEGA_PCM_SIZE number of samples can be 0 if current frame is skipped, in case of error in crc or not enough data for decoding (layer III) number of samples = 0 does not indicate end of stream ! */ LONG MPEGA_seek( MPEGA_STREAM *mpds, ULONG ms_time_position ); /*-------------------------------------------------------------------------- Seek into an MPEG Audio stream Inputs: mpds = mpeg audio stream ptr returned by MPEGA_open ms_time_position = absolute time position in ms Return 0 if Ok, MPEGA_ERR_EOF if outside of stream */ LONG MPEGA_time( MPEGA_STREAM *mpds, ULONG *ms_time_position ); /*-------------------------------------------------------------------------- Get the current time position of an MPEG Audio stream Input: mpds = mpeg audio stream ptr returned by MPEGA_open Output: ms_time_position = absolute time position in ms Return 0 if Ok */ LONG MPEGA_find_sync( BYTE *buffer, LONG buffer_size ); /*-------------------------------------------------------------------------- Find an mpeg synchronization pattern in a buffer This function can be use to check if a file contains MPEG audio stream Inputs: buffer = stream buffer to analyze buffer_size = need to know top of buffer (must be >= 4) Return the the sync position (>=0) or MPEGA_ERR_NO_SYNC if not found */ #endif /* CLIB_MPEGA_PROTOS_H */