Merging the postbeta2 branch onto the mainline.
[platform/upstream/libvorbis.git] / examples / encoder_example.c
1 /********************************************************************
2  *                                                                  *
3  * THIS FILE IS PART OF THE Ogg Vorbis SOFTWARE CODEC SOURCE CODE.  *
4  * USE, DISTRIBUTION AND REPRODUCTION OF THIS SOURCE IS GOVERNED BY *
5  * THE GNU PUBLIC LICENSE 2, WHICH IS INCLUDED WITH THIS SOURCE.    *
6  * PLEASE READ THESE TERMS DISTRIBUTING.                            *
7  *                                                                  *
8  * THE OggSQUISH SOURCE CODE IS (C) COPYRIGHT 1994-2000             *
9  * by Monty <monty@xiph.org> and The XIPHOPHORUS Company            *
10  * http://www.xiph.org/                                             *
11  *                                                                  *
12  ********************************************************************
13
14  function: simple example encoder
15  last mod: $Id: encoder_example.c,v 1.14 2000/10/12 03:12:39 xiphmont Exp $
16
17  ********************************************************************/
18
19 /* takes a stereo 16bit 44.1kHz WAV file from stdin and encodes it into
20    a Vorbis bitstream */
21
22 /* Note that this is POSIX, not ANSI, code */
23
24 #include <stdio.h>
25 #include <stdlib.h>
26 #include <time.h>
27 #include <math.h>
28 #include <vorbis/mode_C.h>
29
30 #ifdef _WIN32 /* We need the following two to set stdin/stdout to binary */
31 #include <io.h>
32 #include <fcntl.h>
33 #endif
34
35 #if defined(macintosh) && defined(__MWERKS__)
36 #include <console.h>      /* CodeWarrior's Mac "command-line" support */
37 #endif
38
39 #define READ 1024
40 signed char readbuffer[READ*4+44]; /* out of the data segment, not the stack */
41
42 int main(){
43   ogg_stream_state os; /* take physical pages, weld into a logical
44                           stream of packets */
45   ogg_page         og; /* one Ogg bitstream page.  Vorbis packets are inside */
46   ogg_packet       op; /* one raw packet of data for decode */
47   
48   vorbis_info     *vi; /* struct that stores all the static vorbis bitstream
49                           settings */
50   vorbis_comment   vc; /* struct that stores all the user comments */
51
52   vorbis_dsp_state vd; /* central working state for the packet->PCM decoder */
53   vorbis_block     vb; /* local working space for packet->PCM decode */
54
55   int eos=0;
56
57 #if defined(macintosh) && defined(__MWERKS__)
58   int argc = 0;
59   char **argv = NULL;
60   argc = ccommand(&argv); /* get a "command line" from the Mac user */
61                           /* this also lets the user set stdin and stdout */
62 #endif
63
64   /* we cheat on the WAV header; we just bypass 44 bytes and never
65      verify that it matches 16bit/stereo/44.1kHz.  This is just an
66      example, after all. */
67
68 #ifdef _WIN32 /* We need to set stdin/stdout to binary mode. Damn windows. */
69   /* Beware the evil ifdef. We avoid these where we can, but this one we 
70      cannot. Don't add any more, you'll probably go to hell if you do. */
71   _setmode( _fileno( stdin ), _O_BINARY );
72   _setmode( _fileno( stdout ), _O_BINARY );
73 #endif
74
75
76   fread(readbuffer,1,44,stdin);
77
78   /********** Encode setup ************/
79
80   /* choose an encoding mode */
81   /* (mode 0: 44kHz stereo uncoupled, roughly 128kbps VBR) */
82   vi=&info_C;
83
84   /* add a comment */
85   vorbis_comment_init(&vc);
86   vorbis_comment_add(&vc,"Track encoded by encoder_example.c");
87
88   /* set up the analysis state and auxiliary encoding storage */
89   vorbis_analysis_init(&vd,vi);
90   vorbis_block_init(&vd,&vb);
91   
92   /* set up our packet->stream encoder */
93   /* pick a random serial number; that way we can more likely build
94      chained streams just by concatenation */
95   srand(time(NULL));
96   ogg_stream_init(&os,rand());
97
98   /* Vorbis streams begin with three headers; the initial header (with
99      most of the codec setup parameters) which is mandated by the Ogg
100      bitstream spec.  The second header holds any comment fields.  The
101      third header holds the bitstream codebook.  We merely need to
102      make the headers, then pass them to libvorbis one at a time;
103      libvorbis handles the additional Ogg bitstream constraints */
104
105   {
106     ogg_packet header;
107     ogg_packet header_comm;
108     ogg_packet header_code;
109
110     vorbis_analysis_headerout(&vd,&vc,&header,&header_comm,&header_code);
111     ogg_stream_packetin(&os,&header); /* automatically placed in its own
112                                          page */
113     ogg_stream_packetin(&os,&header_comm);
114     ogg_stream_packetin(&os,&header_code);
115
116         /* We don't have to write out here, but doing so makes streaming 
117          * much easier, so we do, flushing ALL pages. This ensures the actual
118          * audio data will start on a new page
119          */
120         while(!eos){
121                 int result=ogg_stream_flush(&os,&og);
122                 if(result==0)break;
123                 fwrite(og.header,1,og.header_len,stdout);
124                 fwrite(og.body,1,og.body_len,stdout);
125         }
126
127   }
128   
129   while(!eos){
130     long i;
131     long bytes=fread(readbuffer,1,READ*4,stdin); /* stereo hardwired here */
132
133     if(bytes==0){
134       /* end of file.  this can be done implicitly in the mainline,
135          but it's easier to see here in non-clever fashion.
136          Tell the library we're at end of stream so that it can handle
137          the last frame and mark end of stream in the output properly */
138       vorbis_analysis_wrote(&vd,0);
139
140     }else{
141       /* data to encode */
142
143       /* expose the buffer to submit data */
144       float **buffer=vorbis_analysis_buffer(&vd,READ);
145       
146       /* uninterleave samples */
147       for(i=0;i<bytes/4;i++){
148         buffer[0][i]=((readbuffer[i*4+1]<<8)|
149                       (0x00ff&(int)readbuffer[i*4]))/32768.;
150         buffer[1][i]=((readbuffer[i*4+3]<<8)|
151                       (0x00ff&(int)readbuffer[i*4+2]))/32768.;
152       }
153     
154       /* tell the library how much we actually submitted */
155       vorbis_analysis_wrote(&vd,i);
156     }
157
158     /* vorbis does some data preanalysis, then divvies up blocks for
159        more involved (potentially parallel) processing.  Get a single
160        block for encoding now */
161     while(vorbis_analysis_blockout(&vd,&vb)==1){
162
163       /* analysis */
164       vorbis_analysis(&vb,&op);
165       
166       /* weld the packet into the bitstream */
167       ogg_stream_packetin(&os,&op);
168
169       /* write out pages (if any) */
170       while(!eos){
171         int result=ogg_stream_pageout(&os,&og);
172         if(result==0)break;
173         fwrite(og.header,1,og.header_len,stdout);
174         fwrite(og.body,1,og.body_len,stdout);
175
176         /* this could be set above, but for illustrative purposes, I do
177            it here (to show that vorbis does know where the stream ends) */
178         
179         if(ogg_page_eos(&og))eos=1;
180
181       }
182     }
183   }
184
185   /* clean up and exit.  vorbis_info_clear() must be called last */
186   
187   ogg_stream_clear(&os);
188   vorbis_block_clear(&vb);
189   vorbis_dsp_clear(&vd);
190   
191   /* ogg_page and ogg_packet structs always point to storage in
192      libvorbis.  They're never freed or manipulated directly */
193   
194   fprintf(stderr,"Done.\n");
195   return(0);
196 }
197