diff --git a/mpg123/include/mpg123.h b/mpg123/include/mpg123.h index 6253b82f..37b3129b 100644 --- a/mpg123/include/mpg123.h +++ b/mpg123/include/mpg123.h @@ -1,5 +1,5 @@ /* - libmpg123: MPEG Audio Decoder library (version 1.24.0) + libmpg123: MPEG Audio Decoder library (version 1.25.6) copyright 1995-2015 by the mpg123 project free software under the terms of the LGPL 2.1 @@ -17,7 +17,7 @@ * This should be incremented at least each time a new symbol is added * to the header. */ -#define MPG123_API_VERSION 43 +#define MPG123_API_VERSION 44 #ifndef MPG123_EXPORT /** Defines needed for MS Visual Studio(tm) DLL builds. @@ -493,6 +493,10 @@ MPG123_EXPORT int mpg123_format_support( mpg123_handle *mh , long rate, int encoding ); /** Get the current output format written to the addresses given. + * If the stream is freshly loaded, this will try to parse enough + * of it to give you the format to come. This clears the flag that + * would otherwise make the first decoding call return + * MPG123_NEW_FORMAT. * \param mh handle * \param rate sampling rate return address * \param channels channel count return address @@ -502,6 +506,20 @@ MPG123_EXPORT int mpg123_format_support( mpg123_handle *mh MPG123_EXPORT int mpg123_getformat( mpg123_handle *mh , long *rate, int *channels, int *encoding ); +/** Get the current output format written to the addresses given. + * This differs from plain mpg123_getformat() in that you can choose + * _not_ to clear the flag that would trigger the next decoding call + * to return MPG123_NEW_FORMAT in case of a new format arriving. + * \param mh handle + * \param rate sampling rate return address + * \param channels channel count return address + * \param encoding encoding return address + * \param clear_flag if true, clear internal format flag + * \return MPG123_OK on success + */ +MPG123_EXPORT int mpg123_getformat2( mpg123_handle *mh +, long *rate, int *channels, int *encoding, int clear_flag ); + /*@}*/ diff --git a/mpg123/lib/libmpg123.a b/mpg123/lib/libmpg123.a index b5634245..19b7834f 100644 Binary files a/mpg123/lib/libmpg123.a and b/mpg123/lib/libmpg123.a differ