Typo pointed out on #asterisk-dev (by atis_work)
[asterisk/asterisk.git] / addons / format_mp3.c
1 /*
2  * Asterisk -- An open source telephony toolkit.
3  *
4  * Anthony Minessale <anthmct@yahoo.com>
5  *
6  * Derived from other asterisk sound formats by
7  * Mark Spencer <markster@linux-support.net>
8  *
9  * Thanks to mpglib from http://www.mpg123.org/
10  * and Chris Stenton [jacs@gnome.co.uk]
11  * for coding the ability to play stereo and non-8khz files
12  
13  * See http://www.asterisk.org for more information about
14  * the Asterisk project. Please do not directly contact
15  * any of the maintainers of this project for assistance;
16  * the project provides a web site, mailing lists and IRC
17  * channels for your use.
18  *
19  * This program is free software, distributed under the terms of
20  * the GNU General Public License Version 2. See the LICENSE file
21  * at the top of the source tree.
22  */
23
24 /*!
25  * \file
26  * \brief MP3 Format Handler
27  * \ingroup formats
28  */
29
30 /*** MODULEINFO
31         <defaultenabled>no</defaultenabled>
32  ***/
33
34 #include "asterisk.h"
35
36 ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
37
38 #include "mp3/mpg123.h"
39 #include "mp3/mpglib.h"
40
41 #include "asterisk/module.h"
42 #include "asterisk/mod_format.h"
43 #include "asterisk/logger.h"
44
45 #define MP3_BUFLEN 320
46 #define MP3_SCACHE 16384
47 #define MP3_DCACHE 8192
48
49 struct mp3_private {
50         char waste[AST_FRIENDLY_OFFSET];        /* Buffer for sending frames, etc */
51         char empty;                             /* Empty character */
52         int lasttimeout;
53         int maxlen;
54         struct timeval last;
55         struct mpstr mp;
56         char sbuf[MP3_SCACHE];
57         char dbuf[MP3_DCACHE];
58         int buflen;
59         int sbuflen;
60         int dbuflen;
61         int dbufoffset;
62         int sbufoffset;
63         int lastseek;
64         int offset;
65         long seek;
66 };
67
68 static const char name[] = "mp3";
69
70 #define BLOCKSIZE 160
71 #define OUTSCALE 4096
72
73 #define GAIN -4         /* 2^GAIN is the multiple to increase the volume by */
74
75 #if __BYTE_ORDER == __LITTLE_ENDIAN
76 #define htoll(b) (b)
77 #define htols(b) (b)
78 #define ltohl(b) (b)
79 #define ltohs(b) (b)
80 #else
81 #if __BYTE_ORDER == __BIG_ENDIAN
82 #define htoll(b)  \
83           (((((b)      ) & 0xFF) << 24) | \
84                ((((b) >>  8) & 0xFF) << 16) | \
85                    ((((b) >> 16) & 0xFF) <<  8) | \
86                    ((((b) >> 24) & 0xFF)      ))
87 #define htols(b) \
88           (((((b)      ) & 0xFF) << 8) | \
89                    ((((b) >> 8) & 0xFF)      ))
90 #define ltohl(b) htoll(b)
91 #define ltohs(b) htols(b)
92 #else
93 #error "Endianess not defined"
94 #endif
95 #endif
96
97
98 static int mp3_open(struct ast_filestream *s)
99 {
100         struct mp3_private *p = s->_private;
101         InitMP3(&p->mp, OUTSCALE);
102         return 0;
103 }
104
105
106 static void mp3_close(struct ast_filestream *s)
107 {
108         struct mp3_private *p = s->_private;
109         
110         ExitMP3(&p->mp);
111         return;
112 }
113
114 static int mp3_squeue(struct ast_filestream *s) 
115 {
116         struct mp3_private *p = s->_private;
117         int res=0;
118         
119         p->lastseek = ftell(s->f);
120         p->sbuflen = fread(p->sbuf, 1, MP3_SCACHE, s->f);
121         if(p->sbuflen < 0) {
122                 ast_log(LOG_WARNING, "Short read (%d) (%s)!\n", p->sbuflen, strerror(errno));
123                 return -1;
124         }
125         res = decodeMP3(&p->mp,p->sbuf,p->sbuflen,p->dbuf,MP3_DCACHE,&p->dbuflen);
126         if(res != MP3_OK)
127                 return -1;
128         p->sbuflen -= p->dbuflen;
129         p->dbufoffset = 0;
130         return 0;
131 }
132
133 static int mp3_dqueue(struct ast_filestream *s) 
134 {
135         struct mp3_private *p = s->_private;
136         int res=0;
137         
138         if((res = decodeMP3(&p->mp,NULL,0,p->dbuf,MP3_DCACHE,&p->dbuflen)) == MP3_OK) {
139                 p->sbuflen -= p->dbuflen;
140                 p->dbufoffset = 0;
141         }
142         return res;
143 }
144
145 static int mp3_queue(struct ast_filestream *s)
146 {
147         struct mp3_private *p = s->_private;
148         int res = 0, bytes = 0;
149         
150         if(p->seek) {
151                 ExitMP3(&p->mp);
152                 InitMP3(&p->mp, OUTSCALE);
153                 fseek(s->f, 0, SEEK_SET);
154                 p->sbuflen = p->dbuflen = p->offset = 0;
155                 while(p->offset < p->seek) {
156                         if(mp3_squeue(s))
157                                 return -1;
158                         while(p->offset < p->seek && ((res = mp3_dqueue(s))) == MP3_OK) {
159                                 for(bytes = 0 ; bytes < p->dbuflen ; bytes++) {
160                                         p->dbufoffset++;
161                                         p->offset++;
162                                         if(p->offset >= p->seek)
163                                                 break;
164                                 }
165                         }
166                         if(res == MP3_ERR)
167                                 return -1;
168                 }
169                 
170                 p->seek = 0;
171                 return 0;
172         }
173         if(p->dbuflen == 0) {
174                 if(p->sbuflen) {
175                         res = mp3_dqueue(s);
176                         if(res == MP3_ERR)
177                                 return -1;
178                 }
179                 if(! p->sbuflen || res != MP3_OK) {
180                         if(mp3_squeue(s))
181                                 return -1;
182                 }
183                 
184         }
185
186         return 0;
187 }
188
189 static struct ast_frame *mp3_read(struct ast_filestream *s, int *whennext)
190 {
191
192         struct mp3_private *p = s->_private;
193         int delay =0;
194         int save=0;
195
196         /* Send a frame from the file to the appropriate channel */
197
198         if(mp3_queue(s))
199                 return NULL;
200
201         if(p->dbuflen) {
202                 for(p->buflen=0; p->buflen < MP3_BUFLEN && p->buflen < p->dbuflen; p->buflen++) {
203                         s->buf[p->buflen + AST_FRIENDLY_OFFSET] = p->dbuf[p->buflen+p->dbufoffset];
204                         p->sbufoffset++;
205                 }
206                 p->dbufoffset += p->buflen;
207                 p->dbuflen -= p->buflen;
208
209                 if(p->buflen < MP3_BUFLEN) {
210                         if(mp3_queue(s))
211                                 return NULL;
212
213                         for(save = p->buflen; p->buflen < MP3_BUFLEN; p->buflen++) {
214                                 s->buf[p->buflen + AST_FRIENDLY_OFFSET] = p->dbuf[(p->buflen-save)+p->dbufoffset];
215                                 p->sbufoffset++;
216                         }
217                         p->dbufoffset += (MP3_BUFLEN - save);
218                         p->dbuflen -= (MP3_BUFLEN - save);
219
220                 } 
221
222         }
223         
224         p->offset += p->buflen;
225         delay = p->buflen/2;
226         s->fr.frametype = AST_FRAME_VOICE;
227         s->fr.subclass.codec = AST_FORMAT_SLINEAR;
228         AST_FRAME_SET_BUFFER(&s->fr, s->buf, AST_FRIENDLY_OFFSET, p->buflen);
229         s->fr.mallocd = 0;
230         s->fr.samples = delay;
231         *whennext = delay;
232         return &s->fr;
233 }
234
235
236 static int mp3_write(struct ast_filestream *fs, struct ast_frame *f)
237 {
238         ast_log(LOG_ERROR,"I Can't write MP3 only read them.\n");
239         return -1;
240
241 }
242
243
244 static int mp3_seek(struct ast_filestream *s, off_t sample_offset, int whence)
245 {
246         struct mp3_private *p = s->_private;
247         off_t min,max,cur;
248         long offset=0,samples;
249         samples = sample_offset * 2;
250
251         min = 0;
252         fseek(s->f, 0, SEEK_END);
253         max = ftell(s->f) * 100;
254         cur = p->offset;
255
256         if (whence == SEEK_SET)
257                 offset = samples + min;
258         else if (whence == SEEK_CUR || whence == SEEK_FORCECUR)
259                 offset = samples + cur;
260         else if (whence == SEEK_END)
261                 offset = max - samples;
262         if (whence != SEEK_FORCECUR) {
263                 offset = (offset > max)?max:offset;
264         }
265
266         p->seek = offset;
267         return p->seek;
268         
269 }
270
271 static int mp3_rewrite(struct ast_filestream *s, const char *comment) 
272 {
273         ast_log(LOG_ERROR,"I Can't write MP3 only read them.\n");
274         return -1;
275 }
276
277 static int mp3_trunc(struct ast_filestream *s) 
278 {
279
280         ast_log(LOG_ERROR,"I Can't write MP3 only read them.\n");
281         return -1;
282 }
283
284 static off_t mp3_tell(struct ast_filestream *s)
285 {
286         struct mp3_private *p = s->_private;
287         
288         return p->offset/2;
289 }
290
291 static char *mp3_getcomment(struct ast_filestream *s)
292 {
293         return NULL;
294 }
295
296 static const struct ast_format mp3_f = {
297         .name = "mp3",
298         .exts = "mp3",
299         .format = AST_FORMAT_SLINEAR,
300         .open = mp3_open,
301         .write = mp3_write,
302         .rewrite = mp3_rewrite,
303         .seek = mp3_seek,
304         .trunc = mp3_trunc,
305         .tell = mp3_tell,
306         .read = mp3_read,
307         .close = mp3_close,
308         .getcomment = mp3_getcomment,
309         .buf_size = MP3_BUFLEN + AST_FRIENDLY_OFFSET,
310         .desc_size = sizeof(struct mp3_private),
311 };
312
313
314 static int load_module(void)
315 {
316         InitMP3Constants();
317         return ast_format_register(&mp3_f);
318 }
319
320 static int unload_module(void)
321 {
322         return ast_format_unregister(name);
323 }       
324
325 AST_MODULE_INFO_STANDARD(ASTERISK_GPL_KEY, "MP3 format [Any rate but 8000hz mono is optimal]");