Vorbisfile documentation |
cannam@86: vorbisfile version 1.3.2 - 20101101 |
cannam@86:
cannam@86: The following is a run-through of the decoding example program supplied cannam@86: with libvorbisfile, vorbisfile_example.c. cannam@86: This program takes a vorbis bitstream from stdin and writes raw pcm to stdout. cannam@86: cannam@86:
cannam@86: First, relevant headers, including vorbis-specific "vorbis/codec.h" and "vorbisfile.h" have to be included.
cannam@86:
cannam@86:
cannam@86:
cannam@86: cannam@86: #include <stdio.h> cannam@86: #include <stdlib.h> cannam@86: #include <math.h> cannam@86: #include "vorbis/codec.h" cannam@86: #include "vorbisfile.h" cannam@86:cannam@86: |
cannam@86:
cannam@86: We also have to make a concession to Windows users here. If we are using windows for decoding, we must declare these libraries so that we can set stdin/stdout to binary.
cannam@86:
cannam@86:
cannam@86: cannam@86: #ifdef _WIN32 cannam@86: #include <io.h> cannam@86: #include <fcntl.h> cannam@86: #endif cannam@86:cannam@86: |
cannam@86:
cannam@86: Next, a buffer for the pcm audio output is declared.
cannam@86:
cannam@86:
cannam@86:
cannam@86: cannam@86: char pcmout[4096]; cannam@86:cannam@86: |
cannam@86:
Inside main(), we declare our primary OggVorbis_File structure. We also declare a few other helpful variables to track out progress within the file.
cannam@86: Also, we make our final concession to Windows users by setting the stdin and stdout to binary mode.
cannam@86:
cannam@86:
cannam@86:
cannam@86: int main(int argc, char **argv){
cannam@86: OggVorbis_File vf;
cannam@86: int eof=0;
cannam@86: int current_section;
cannam@86:
cannam@86: #ifdef _WIN32
cannam@86: _setmode( _fileno( stdin ), _O_BINARY );
cannam@86: _setmode( _fileno( stdout ), _O_BINARY );
cannam@86: #endif
cannam@86:
cannam@86: |
cannam@86:
We call ov_open_callbacks() to
cannam@86: initialize the OggVorbis_File structure with default values.
cannam@86: ov_open_callbacks() also checks
cannam@86: to ensure that we're reading Vorbis format and not something else. The
cannam@86: OV_CALLBACKS_NOCLOSE callbacks instruct libvorbisfile not to close
cannam@86: stdin later during cleanup.
cannam@86:
cannam@86:
cannam@86:
cannam@86:
cannam@86: if(ov_open_callbacks(stdin, &vf, NULL, 0, OV_CALLBACKS_NOCLOSE) < 0) {
cannam@86: fprintf(stderr,"Input does not appear to be an Ogg bitstream.\n");
cannam@86: exit(1);
cannam@86: }
cannam@86:
cannam@86:
cannam@86: |
cannam@86:
cannam@86: We're going to pull the channel and bitrate info from the file using ov_info() and show them to the user.
cannam@86: We also want to pull out and show the user a comment attached to the file using ov_comment().
cannam@86:
cannam@86:
cannam@86:
cannam@86:
cannam@86: {
cannam@86: char **ptr=ov_comment(&vf,-1)->user_comments;
cannam@86: vorbis_info *vi=ov_info(&vf,-1);
cannam@86: while(*ptr){
cannam@86: fprintf(stderr,"%s\n",*ptr);
cannam@86: ++ptr;
cannam@86: }
cannam@86: fprintf(stderr,"\nBitstream is %d channel, %ldHz\n",vi->channels,vi->rate);
cannam@86: fprintf(stderr,"\nDecoded length: %ld samples\n",
cannam@86: (long)ov_pcm_total(&vf,-1));
cannam@86: fprintf(stderr,"Encoded by: %s\n\n",ov_comment(&vf,-1)->vendor);
cannam@86: }
cannam@86:
cannam@86:
cannam@86: |
cannam@86:
cannam@86: Here's the read loop:
cannam@86:
cannam@86:
cannam@86:
cannam@86:
cannam@86:
cannam@86: while(!eof){
cannam@86: long ret=ov_read(&vf,pcmout,sizeof(pcmout),0,2,1,¤t_section);
cannam@86: if (ret == 0) {
cannam@86: /* EOF */
cannam@86: eof=1;
cannam@86: } else if (ret < 0) {
cannam@86: /* error in the stream. Not a problem, just reporting it in
cannam@86: case we (the app) cares. In this case, we don't. */
cannam@86: } else {
cannam@86: /* we don't bother dealing with sample rate changes, etc, but
cannam@86: you'll have to*/
cannam@86: fwrite(pcmout,1,ret,stdout);
cannam@86: }
cannam@86: }
cannam@86:
cannam@86:
cannam@86:
cannam@86: |
cannam@86:
cannam@86: The code is reading blocks of data using ov_read(). cannam@86: Based on the value returned, we know if we're at the end of the file or have invalid data. If we have valid data, we write it to the pcm output. cannam@86: cannam@86:
cannam@86: Now that we've finished playing, we can pack up and go home. It's important to call ov_clear() when we're finished.
cannam@86:
cannam@86:
cannam@86:
cannam@86: cannam@86: cannam@86: ov_clear(&vf); cannam@86: cannam@86: fprintf(stderr,"Done.\n"); cannam@86: return(0); cannam@86: } cannam@86:cannam@86: |
cannam@86:
cannam@86:
cannam@86:
cannam@86:
copyright © 2000-2010 Xiph.Org |
cannam@86: cannam@86: |
Vorbisfile documentation |
cannam@86: vorbisfile version 1.3.2 - 20101101 |
cannam@86: