media formats: re-architect handling of media for performance improvements
[asterisk/asterisk.git] / formats / format_h263.c
1 /*
2  * Asterisk -- An open source telephony toolkit.
3  *
4  * Copyright (C) 1999 - 2006, Digium, Inc.
5  *
6  * Mark Spencer <markster@digium.com>
7  *
8  * See http://www.asterisk.org for more information about
9  * the Asterisk project. Please do not directly contact
10  * any of the maintainers of this project for assistance;
11  * the project provides a web site, mailing lists and IRC
12  * channels for your use.
13  *
14  * This program is free software, distributed under the terms of
15  * the GNU General Public License Version 2. See the LICENSE file
16  * at the top of the source tree.
17  */
18
19 /*! \file
20  *
21  * \brief Save to raw, headerless h263 data.
22  * \arg File name extension: h263
23  * \ingroup formats
24  * \arg See \ref AstVideo
25  */
26
27 /*** MODULEINFO
28         <support_level>core</support_level>
29  ***/
30  
31 #include "asterisk.h"
32
33 ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
34
35 #include "asterisk/mod_format.h"
36 #include "asterisk/module.h"
37 #include "asterisk/endian.h"
38 #include "asterisk/format_cache.h"
39
40 /* Some Ideas for this code came from makeh263e.c by Jeffrey Chilton */
41
42 /* Portions of the conversion code are by guido@sienanet.it */
43
44 /* According to:
45  * http://lists.mpegif.org/pipermail/mp4-tech/2005-July/005741.html
46  * the maximum actual frame size is not 2048, but 8192.  Since the maximum
47  * theoretical limit is not much larger (32k = 15bits), we'll go for that
48  * size to ensure we don't corrupt frames sent to us (unless they're
49  * ridiculously large). */
50 #define BUF_SIZE        32768   /* Four real h.263 Frames */
51
52 #define FRAME_ENDED 0x8000
53
54 struct h263_desc {
55         unsigned int lastts;
56 };
57
58
59 static int h263_open(struct ast_filestream *s)
60 {
61         unsigned int ts;
62
63         if (fread(&ts, 1, sizeof(ts), s->f) < sizeof(ts)) {
64                 ast_log(LOG_WARNING, "Empty file!\n");
65                 return -1;
66         }
67         return 0;
68 }
69
70 static struct ast_frame *h263_read(struct ast_filestream *s, int *whennext)
71 {
72         int res;
73         uint32_t mark;
74         unsigned short len;
75         unsigned int ts;
76         struct h263_desc *fs = (struct h263_desc *)s->_private;
77
78         /* Send a frame from the file to the appropriate channel */
79         if ((res = fread(&len, 1, sizeof(len), s->f)) < 1)
80                 return NULL;
81         len = ntohs(len);
82         mark = (len & FRAME_ENDED) ? 1 : 0;
83         len &= 0x7fff;
84         if (len > BUF_SIZE) {
85                 ast_log(LOG_WARNING, "Length %d is too long\n", len);
86                 return NULL;
87         }
88         AST_FRAME_SET_BUFFER(&s->fr, s->buf, AST_FRIENDLY_OFFSET, len);
89         if ((res = fread(s->fr.data.ptr, 1, s->fr.datalen, s->f)) != s->fr.datalen) {
90                 if (res)
91                         ast_log(LOG_WARNING, "Short read (%d) (%s)!\n", res, strerror(errno));
92                 return NULL;
93         }
94         s->fr.samples = fs->lastts;     /* XXX what ? */
95         s->fr.datalen = len;
96         s->fr.subclass.frame_ending = mark;
97         if ((res = fread(&ts, 1, sizeof(ts), s->f)) == sizeof(ts)) {
98                 fs->lastts = ntohl(ts);
99                 *whennext = fs->lastts * 4/45;
100         } else
101                 *whennext = 0;
102         return &s->fr;
103 }
104
105 static int h263_write(struct ast_filestream *fs, struct ast_frame *f)
106 {
107         int res;
108         unsigned int ts;
109         unsigned short len;
110         uint32_t mark = 0;
111         mark = f->subclass.frame_ending ? FRAME_ENDED : 0;
112         ts = htonl(f->samples);
113         if ((res = fwrite(&ts, 1, sizeof(ts), fs->f)) != sizeof(ts)) {
114                         ast_log(LOG_WARNING, "Bad write (%d/4): %s\n", res, strerror(errno));
115                         return -1;
116         }
117         len = htons(f->datalen | mark);
118         if ((res = fwrite(&len, 1, sizeof(len), fs->f)) != sizeof(len)) {
119                         ast_log(LOG_WARNING, "Bad write (%d/2): %s\n", res, strerror(errno));
120                         return -1;
121         }
122         if ((res = fwrite(f->data.ptr, 1, f->datalen, fs->f)) != f->datalen) {
123                         ast_log(LOG_WARNING, "Bad write (%d/%d): %s\n", res, f->datalen, strerror(errno));
124                         return -1;
125         }
126         return 0;
127 }
128
129 static int h263_seek(struct ast_filestream *fs, off_t sample_offset, int whence)
130 {
131         /* No way Jose */
132         return -1;
133 }
134
135 static int h263_trunc(struct ast_filestream *fs)
136 {
137         int fd;
138         off_t cur;
139
140         if ((fd = fileno(fs->f)) < 0) {
141                 ast_log(AST_LOG_WARNING, "Unable to determine file descriptor for h263 filestream %p: %s\n", fs, strerror(errno));
142                 return -1;
143         }
144         if ((cur = ftello(fs->f)) < 0) {
145                 ast_log(AST_LOG_WARNING, "Unable to determine current position in h263 filestream %p: %s\n", fs, strerror(errno));
146                 return -1;
147         }
148         /* Truncate file to current length */
149         return ftruncate(fd, cur);
150 }
151
152 static off_t h263_tell(struct ast_filestream *fs)
153 {
154         off_t offset = ftello(fs->f);
155         return offset;  /* XXX totally bogus, needs fixing */
156 }
157
158 static struct ast_format_def h263_f = {
159         .name = "h263",
160         .exts = "h263",
161         .open = h263_open,
162         .write = h263_write,
163         .seek = h263_seek,
164         .trunc = h263_trunc,
165         .tell = h263_tell,
166         .read = h263_read,
167         .buf_size = BUF_SIZE + AST_FRIENDLY_OFFSET,
168         .desc_size = sizeof(struct h263_desc),
169 };
170
171 static int load_module(void)
172 {
173         h263_f.format = ast_format_h263;
174         if (ast_format_def_register(&h263_f))
175                 return AST_MODULE_LOAD_FAILURE;
176         return AST_MODULE_LOAD_SUCCESS;
177 }
178
179 static int unload_module(void)
180 {
181         return ast_format_def_unregister(h263_f.name);
182 }
183
184 AST_MODULE_INFO(ASTERISK_GPL_KEY, AST_MODFLAG_LOAD_ORDER, "Raw H.263 data",
185         .load = load_module,
186         .unload = unload_module,
187         .load_pri = AST_MODPRI_APP_DEPEND
188 );