lib/mpg123
1
0
Fork 0
mirror of http://mpg123.de/trunk/.git synced 2025-07-28 15:02:00 +03:00
Code Activity

Include the examples in API doc.

Browse Source 
git-svn-id: svn://scm.orgis.org/mpg123/trunk@1196 35dc7657-300d-0410-a2e5-dc2837fedb53
This commit is contained in:
thor
2007-11-30 23:20:04 +00:00
parent bcbc89aa56
commit 49204b005f
3 changed files with 37 additions and 15 deletions
Download Patch File Download Diff File Expand all files Collapse all files

17
doc/doxy_examples.c Normal file
View File

@ -0,0 +1,17 @@
/** \defgroup mpg123_examples example programs using libmpg123
@{ */
/** \file mpg123_to_wav.c A simple MPEG audio to WAV converter using libmpg123 (read) and libsndfile (write).
...an excersize on two simple APIs.
*/
/** \file mpglib.c Example program mimicking the old mpglib test program.
It takes an MPEG bitstream from standard input and writes raw audio to standard output.
This is an use case of the mpg123_decode() in and out function in the feeder mode.
*/
/** \file scan.c Example program that examines the exact length of an MPEG file.
It opens a list of files and does mpg123_scan() on each and reporting the mpg123_length() before and after that.
*/
/* @} */

3
doc/doxygen.conf
View File

@ -9,12 +9,13 @@ CREATE_SUBDIRS = NO
OUTPUT_LANGUAGE = English OUTPUT_LANGUAGE = English
FULL_PATH_NAMES = NO FULL_PATH_NAMES = NO
INPUT = ../src/libmpg123/mpg123.h INPUT = doxy_examples.c examples/mpg123_to_wav.c examples/mpglib.c examples/scan.c ../src/libmpg123/mpg123.h
OPTIMIZE_OUTPUT_FOR_C = YES OPTIMIZE_OUTPUT_FOR_C = YES
EXTRACT_ALL = NO EXTRACT_ALL = NO
HIDE_UNDOC_MEMBERS = NO HIDE_UNDOC_MEMBERS = NO
QUIET = YES QUIET = YES
WARNINGS = YES WARNINGS = YES
SOURCE_BROWSER = YES
GENERATE_HTML = YES GENERATE_HTML = YES
HTML_OUTPUT = html HTML_OUTPUT = html

32
doc/examples/mpglib.c
View File

@ -10,14 +10,14 @@
#include <unistd.h> #include <unistd.h>
#include <stdio.h> #include <stdio.h>
#define INBUFF 16384 #define INBUFF 16384
#define OUTBUFF 32768
unsigned char buf[INBUFF];
int main(int argc, char **argv) int main(int argc, char **argv)
{ {
size_t size; size_t size;
unsigned char out[8192]; unsigned char buf[INBUFF]; /* input buffer */
unsigned char out[OUTBUFF]; /* output buffer */
ssize_t len; ssize_t len;
int ret; int ret;
size_t in = 0, outc = 0; size_t in = 0, outc = 0;
@ -30,13 +30,16 @@ int main(int argc, char **argv)
fprintf(stderr,"Unable to create mpg123 handle: %s\n", mpg123_plain_strerror(ret)); fprintf(stderr,"Unable to create mpg123 handle: %s\n", mpg123_plain_strerror(ret));
return -1; return -1;
} }
mpg123_param(m, MPG123_VERBOSE, 2, 0); mpg123_param(m, MPG123_VERBOSE, 2, 0); /* Brabble a bit about the parsing/decoding. */
/* mpg123_param(m, MPG123_ADD_FLAGS, MPG123_GAPLESS, 0); */
/* mpg123_param(m, MPG123_START_FRAME, 2300, 0); */ /* Now mpg123 is being prepared for feeding. The main loop will read chunks from stdin and feed them to mpg123;
then take decoded data as available to write to stdout. */
mpg123_open_feed(m); mpg123_open_feed(m);
if(m == NULL) return -1; if(m == NULL) return -1;
fprintf(stderr, "Feed me some MPEG audio to stdin, I will decode to stdout.\n"); fprintf(stderr, "Feed me some MPEG audio to stdin, I will decode to stdout.\n");
while(1) { while(1) /* Read and write until everything is through. */
{
len = read(0,buf,INBUFF); len = read(0,buf,INBUFF);
if(len <= 0) if(len <= 0)
{ {
@ -44,8 +47,8 @@ int main(int argc, char **argv)
break; break;
} }
in += len; in += len;
/*fprintf(stderr, ">> %lu KiB in\n", (unsigned long)in>>10);*/ /* Feed input chunk and get first chunk of decoded audio. */
ret = mpg123_decode(m,buf,len,out,8192,&size); ret = mpg123_decode(m,buf,len,out,OUTBUFF,&size);
if(ret == MPG123_NEW_FORMAT) if(ret == MPG123_NEW_FORMAT)
{ {
long rate; long rate;
@ -55,16 +58,17 @@ int main(int argc, char **argv)
} }
write(1,out,size); write(1,out,size);
outc += size; outc += size;
/*fprintf(stderr, "<< %lu KiB out, ret=%i\n", (unsigned long)outc>>10, ret);*/ while(ret != MPG123_ERR && ret != MPG123_NEED_MORE)
while(ret != MPG123_ERR && ret != MPG123_NEED_MORE) { { /* Get all decoded audio that is available now before feeding more input. */
ret = mpg123_decode(m,NULL,0,out,8192,&size); ret = mpg123_decode(m,NULL,0,out,OUTBUFF,&size);
write(1,out,size); write(1,out,size);
outc += size; outc += size;
/*fprintf(stderr, "<< %lu KiB out, ret=%i\n", (unsigned long)outc>>10, ret);*/
} }
if(ret == MPG123_ERR){ fprintf(stderr, "some error: %s", mpg123_strerror(m)); break; } if(ret == MPG123_ERR){ fprintf(stderr, "some error: %s", mpg123_strerror(m)); break; }
} }
fprintf(stderr, "%lu bytes in, %lu bytes out\n", (unsigned long)in, (unsigned long)outc); fprintf(stderr, "%lu bytes in, %lu bytes out\n", (unsigned long)in, (unsigned long)outc);
/* Done decoding, now just clean up and leave. */
mpg123_delete(m); mpg123_delete(m);
mpg123_exit(); mpg123_exit();
return 0; return 0;