install_prereq: Add SUSE.
[asterisk/asterisk.git] / res / res_format_attr_vp8.c
1 /*
2  * Asterisk -- An open source telephony toolkit.
3  *
4  * Copyright (C) 2015, Alexander Traud
5  *
6  * Alexander Traud <pabstraud@compuserve.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 /*!
20  * \file
21  * \brief VP8 format attribute interface
22  *
23  * \author Alexander Traud <pabstraud@compuserve.com>
24  *
25  * \note http://tools.ietf.org/html/draft-ietf-payload-vp8
26  */
27
28 /*** MODULEINFO
29         <support_level>core</support_level>
30  ***/
31
32 #include "asterisk.h"
33
34 #include "asterisk/module.h"
35 #include "asterisk/format.h"
36 #include "asterisk/logger.h"            /* for ast_log, LOG_WARNING */
37 #include "asterisk/strings.h"           /* for ast_str_append */
38 #include "asterisk/utils.h"             /* for MIN, ast_malloc, ast_free */
39
40 struct vp8_attr {
41         unsigned int maximum_frame_rate;
42         unsigned int maximum_frame_size;
43 };
44
45 static struct vp8_attr default_vp8_attr = {
46         .maximum_frame_rate = UINT_MAX,
47         .maximum_frame_size = UINT_MAX,
48 };
49
50 static void vp8_destroy(struct ast_format *format)
51 {
52         struct vp8_attr *attr = ast_format_get_attribute_data(format);
53
54         ast_free(attr);
55 }
56
57 static int vp8_clone(const struct ast_format *src, struct ast_format *dst)
58 {
59         struct vp8_attr *original = ast_format_get_attribute_data(src);
60         struct vp8_attr *attr = ast_malloc(sizeof(*attr));
61
62         if (!attr) {
63                 return -1;
64         }
65
66         if (original) {
67                 *attr = *original;
68         } else {
69                 *attr = default_vp8_attr;
70         }
71
72         ast_format_set_attribute_data(dst, attr);
73
74         return 0;
75 }
76
77 static struct ast_format *vp8_parse_sdp_fmtp(const struct ast_format *format, const char *attributes)
78 {
79         struct ast_format *cloned;
80         struct vp8_attr *attr;
81         const char *kvp;
82         unsigned int val;
83
84         cloned = ast_format_clone(format);
85         if (!cloned) {
86                 return NULL;
87         }
88         attr = ast_format_get_attribute_data(cloned);
89
90         if ((kvp = strstr(attributes, "max-fr")) && sscanf(kvp, "max-fr=%30u", &val) == 1) {
91                 attr->maximum_frame_rate = val;
92         } else {
93                 attr->maximum_frame_rate = UINT_MAX;
94         }
95
96         if ((kvp = strstr(attributes, "max-fs")) && sscanf(kvp, "max-fs=%30u", &val) == 1) {
97                 attr->maximum_frame_size = val;
98         } else {
99                 attr->maximum_frame_size = UINT_MAX;
100         }
101
102         return cloned;
103 }
104
105 static void vp8_generate_sdp_fmtp(const struct ast_format *format, unsigned int payload, struct ast_str **str)
106 {
107         struct vp8_attr *attr = ast_format_get_attribute_data(format);
108         int added = 0;
109
110         if (!attr) {
111                 /*
112                  * (Only) cached formats do not have attribute data assigned because
113                  * they were created before this attribute module was registered.
114                  * Therefore, we assume the default attribute values here.
115                  */
116                 attr = &default_vp8_attr;
117         }
118
119         if (UINT_MAX != attr->maximum_frame_rate) {
120                 if (added) {
121                         ast_str_append(str, 0, ";");
122                 } else if (0 < ast_str_append(str, 0, "a=fmtp:%u ", payload)) {
123                         added = 1;
124                 }
125                 ast_str_append(str, 0, "max-fr=%u", attr->maximum_frame_rate);
126         }
127
128         if (UINT_MAX != attr->maximum_frame_size) {
129                 if (added) {
130                         ast_str_append(str, 0, ";");
131                 } else if (0 < ast_str_append(str, 0, "a=fmtp:%u ", payload)) {
132                         added = 1;
133                 }
134                 ast_str_append(str, 0, "max-fs=%u", attr->maximum_frame_size);
135         }
136
137         if (added) {
138                 ast_str_append(str, 0, "\r\n");
139         }
140 }
141
142 static struct ast_format *vp8_getjoint(const struct ast_format *format1, const struct ast_format *format2)
143 {
144         struct vp8_attr *attr1 = ast_format_get_attribute_data(format1);
145         struct vp8_attr *attr2 = ast_format_get_attribute_data(format2);
146         struct ast_format *jointformat;
147         struct vp8_attr *attr_res;
148
149         if (!attr1) {
150                 attr1 = &default_vp8_attr;
151         }
152
153         if (!attr2) {
154                 attr2 = &default_vp8_attr;
155         }
156
157         jointformat = ast_format_clone(format1);
158         if (!jointformat) {
159                 return NULL;
160         }
161         attr_res = ast_format_get_attribute_data(jointformat);
162
163         attr_res->maximum_frame_rate = MIN(attr1->maximum_frame_rate, attr2->maximum_frame_rate);
164         attr_res->maximum_frame_size = MIN(attr1->maximum_frame_size, attr2->maximum_frame_size);
165
166         return jointformat;
167 }
168
169 static struct ast_format *vp8_set(const struct ast_format *format, const char *name, const char *value)
170 {
171         struct ast_format *cloned;
172         struct vp8_attr *attr;
173         unsigned int val;
174
175         if (sscanf(value, "%30u", &val) != 1) {
176                 ast_log(LOG_WARNING, "Unknown value '%s' for attribute type '%s'\n",
177                         value, name);
178                 return NULL;
179         }
180
181         cloned = ast_format_clone(format);
182         if (!cloned) {
183                 return NULL;
184         }
185         attr = ast_format_get_attribute_data(cloned);
186
187         if (!strcasecmp(name, "maximum_frame_rate")) {
188                 attr->maximum_frame_rate = val;
189         } else if (!strcasecmp(name, "maximum_frame_size")) {
190                 attr->maximum_frame_size = val;
191         } else {
192                 ast_log(LOG_WARNING, "unknown attribute type %s\n", name);
193         }
194
195         return cloned;
196 }
197
198 static struct ast_format_interface vp8_interface = {
199         .format_destroy = vp8_destroy,
200         .format_clone = vp8_clone,
201         .format_get_joint = vp8_getjoint,
202         .format_attribute_set = vp8_set,
203         .format_parse_sdp_fmtp = vp8_parse_sdp_fmtp,
204         .format_generate_sdp_fmtp = vp8_generate_sdp_fmtp,
205 };
206
207 static int load_module(void)
208 {
209         if (ast_format_interface_register("vp8", &vp8_interface)) {
210                 return AST_MODULE_LOAD_DECLINE;
211         }
212
213         return AST_MODULE_LOAD_SUCCESS;
214 }
215
216 static int unload_module(void)
217 {
218         return 0;
219 }
220
221 AST_MODULE_INFO(ASTERISK_GPL_KEY, AST_MODFLAG_LOAD_ORDER, "VP8 Format Attribute Module",
222         .support_level = AST_MODULE_SUPPORT_CORE,
223         .load = load_module,
224         .unload = unload_module,
225         .load_pri = AST_MODPRI_CHANNEL_DEPEND,
226 );