Update doxygen for video formats
[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 #include "asterisk.h"
28
29 ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
30
31 #include <unistd.h>
32 #include <netinet/in.h>
33 #include <arpa/inet.h>
34 #include <stdlib.h>
35 #include <sys/time.h>
36 #include <stdio.h>
37 #include <errno.h>
38 #include <string.h>
39
40 #include "asterisk/lock.h"
41 #include "asterisk/channel.h"
42 #include "asterisk/file.h"
43 #include "asterisk/logger.h"
44 #include "asterisk/sched.h"
45 #include "asterisk/module.h"
46 #include "asterisk/endian.h"
47
48 /* Some Ideas for this code came from makeh263e.c by Jeffrey Chilton */
49
50 /* Portions of the conversion code are by guido@sienanet.it */
51
52 #define BUF_SIZE        4096    /* Two Real h263 Frames */
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         int res;
63
64         if ((res = fread(&ts, 1, sizeof(ts), s->f)) < sizeof(ts)) {
65                 ast_log(LOG_WARNING, "Empty file!\n");
66                 return -1;
67         }
68         return 0;
69 }
70
71 static struct ast_frame *h263_read(struct ast_filestream *s, int *whennext)
72 {
73         int res;
74         int mark;
75         unsigned short len;
76         unsigned int ts;
77         struct h263_desc *fs = (struct h263_desc *)s->private;
78
79         /* Send a frame from the file to the appropriate channel */
80         if ((res = fread(&len, 1, sizeof(len), s->f)) < 1)
81                 return NULL;
82         len = ntohs(len);
83         mark = (len & 0x8000) ? 1 : 0;
84         len &= 0x7fff;
85         if (len > BUF_SIZE) {
86                 ast_log(LOG_WARNING, "Length %d is too long\n", len);
87                 len = BUF_SIZE; /* XXX truncate ? */
88         }
89         s->fr.frametype = AST_FRAME_VIDEO;
90         s->fr.subclass = AST_FORMAT_H263;
91         s->fr.mallocd = 0;
92         AST_FRAME_SET_BUFFER(&s->fr, s->buf, AST_FRIENDLY_OFFSET, len);
93         if ((res = fread(s->fr.data, 1, s->fr.datalen, s->f)) != s->fr.datalen) {
94                 if (res)
95                         ast_log(LOG_WARNING, "Short read (%d) (%s)!\n", res, strerror(errno));
96                 return NULL;
97         }
98         s->fr.samples = fs->lastts;     /* XXX what ? */
99         s->fr.datalen = len;
100         s->fr.subclass |= mark;
101         s->fr.delivery.tv_sec = 0;
102         s->fr.delivery.tv_usec = 0;
103         if ((res = fread(&ts, 1, sizeof(ts), s->f)) == sizeof(ts)) {
104                 fs->lastts = ntohl(ts);
105                 *whennext = fs->lastts * 4/45;
106         } else
107                 *whennext = 0;
108         return &s->fr;
109 }
110
111 static int h263_write(struct ast_filestream *fs, struct ast_frame *f)
112 {
113         int res;
114         unsigned int ts;
115         unsigned short len;
116         int subclass;
117         int mark=0;
118         if (f->frametype != AST_FRAME_VIDEO) {
119                 ast_log(LOG_WARNING, "Asked to write non-video frame!\n");
120                 return -1;
121         }
122         subclass = f->subclass;
123         if (subclass & 0x1)
124                 mark=0x8000;
125         subclass &= ~0x1;
126         if (subclass != AST_FORMAT_H263) {
127                 ast_log(LOG_WARNING, "Asked to write non-h263 frame (%d)!\n", f->subclass);
128                 return -1;
129         }
130         ts = htonl(f->samples);
131         if ((res = fwrite(&ts, 1, sizeof(ts), fs->f)) != sizeof(ts)) {
132                         ast_log(LOG_WARNING, "Bad write (%d/4): %s\n", res, strerror(errno));
133                         return -1;
134         }
135         len = htons(f->datalen | mark);
136         if ((res = fwrite(&len, 1, sizeof(len), fs->f)) != sizeof(len)) {
137                         ast_log(LOG_WARNING, "Bad write (%d/2): %s\n", res, strerror(errno));
138                         return -1;
139         }
140         if ((res = fwrite(f->data, 1, f->datalen, fs->f)) != f->datalen) {
141                         ast_log(LOG_WARNING, "Bad write (%d/%d): %s\n", res, f->datalen, strerror(errno));
142                         return -1;
143         }
144         return 0;
145 }
146
147 static int h263_seek(struct ast_filestream *fs, off_t sample_offset, int whence)
148 {
149         /* No way Jose */
150         return -1;
151 }
152
153 static int h263_trunc(struct ast_filestream *fs)
154 {
155         /* Truncate file to current length */
156         if (ftruncate(fileno(fs->f), ftello(fs->f)) < 0)
157                 return -1;
158         return 0;
159 }
160
161 static off_t h263_tell(struct ast_filestream *fs)
162 {
163         off_t offset = ftello(fs->f);
164         return offset;  /* XXX totally bogus, needs fixing */
165 }
166
167 static const struct ast_format h263_f = {
168         .name = "h263",
169         .exts = "h263",
170         .format = AST_FORMAT_H263,
171         .open = h263_open,
172         .write = h263_write,
173         .seek = h263_seek,
174         .trunc = h263_trunc,
175         .tell = h263_tell,
176         .read = h263_read,
177         .buf_size = BUF_SIZE + AST_FRIENDLY_OFFSET,
178         .desc_size = sizeof(struct h263_desc),
179         .module = &mod_data,    /* XXX */
180 };
181
182 static int load_module(void *mod)
183 {
184         return ast_format_register(&h263_f);
185 }
186
187 static int unload_module(void *mod)
188 {
189         return ast_format_unregister(h263_f.name);
190 }       
191
192 static const char *description(void)
193 {
194         return "Raw h263 data";
195 }
196
197 static const char *key(void)
198 {
199         return ASTERISK_GPL_KEY;
200 }
201
202 STD_MOD1;