Merge commit 'e581e88cbdb3323ca0026a54b39a9716a3686e9f'
[ffmpeg.git] / libavdevice / avdevice.c
1 /*
2  * This file is part of FFmpeg.
3  *
4  * FFmpeg is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU Lesser General Public
6  * License as published by the Free Software Foundation; either
7  * version 2.1 of the License, or (at your option) any later version.
8  *
9  * FFmpeg is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
12  * Lesser General Public License for more details.
13  *
14  * You should have received a copy of the GNU Lesser General Public
15  * License along with FFmpeg; if not, write to the Free Software
16  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
17  */
18
19 #include "libavutil/avassert.h"
20 #include "libavutil/samplefmt.h"
21 #include "libavutil/pixfmt.h"
22 #include "libavcodec/avcodec.h"
23 #include "avdevice.h"
24 #include "config.h"
25
26 #include "libavutil/ffversion.h"
27 const char av_device_ffversion[] = "FFmpeg version " FFMPEG_VERSION;
28
29 #define E AV_OPT_FLAG_ENCODING_PARAM
30 #define D AV_OPT_FLAG_DECODING_PARAM
31 #define A AV_OPT_FLAG_AUDIO_PARAM
32 #define V AV_OPT_FLAG_VIDEO_PARAM
33 #define OFFSET(x) offsetof(AVDeviceCapabilitiesQuery, x)
34
35 const AVOption av_device_capabilities[] = {
36     { "codec", "codec", OFFSET(codec), AV_OPT_TYPE_INT,
37         {.i64 = AV_CODEC_ID_NONE}, AV_CODEC_ID_NONE, INT_MAX, E|D|A|V },
38     { "sample_format", "sample format", OFFSET(sample_format), AV_OPT_TYPE_SAMPLE_FMT,
39         {.i64 = AV_SAMPLE_FMT_NONE}, AV_SAMPLE_FMT_NONE, INT_MAX, E|D|A },
40     { "sample_rate", "sample rate", OFFSET(sample_rate), AV_OPT_TYPE_INT,
41         {.i64 = -1}, -1, INT_MAX, E|D|A },
42     { "channels", "channels", OFFSET(channels), AV_OPT_TYPE_INT,
43         {.i64 = -1}, -1, INT_MAX, E|D|A },
44     { "channel_layout", "channel layout", OFFSET(channel_layout), AV_OPT_TYPE_CHANNEL_LAYOUT,
45         {.i64 = -1}, -1, INT_MAX, E|D|A },
46     { "pixel_format", "pixel format", OFFSET(pixel_format), AV_OPT_TYPE_PIXEL_FMT,
47         {.i64 = AV_PIX_FMT_NONE}, AV_PIX_FMT_NONE, INT_MAX, E|D|V },
48     { "window_size", "window size", OFFSET(window_width), AV_OPT_TYPE_IMAGE_SIZE,
49         {.str = NULL}, -1, INT_MAX, E|D|V },
50     { "frame_size", "frame size", OFFSET(frame_width), AV_OPT_TYPE_IMAGE_SIZE,
51         {.str = NULL}, -1, INT_MAX, E|D|V },
52     { "fps", "fps", OFFSET(fps), AV_OPT_TYPE_RATIONAL,
53         {.dbl = -1}, -1, INT_MAX, E|D|V },
54     { NULL }
55 };
56
57 #undef E
58 #undef D
59 #undef A
60 #undef V
61 #undef OFFSET
62
63 unsigned avdevice_version(void)
64 {
65     av_assert0(LIBAVDEVICE_VERSION_MICRO >= 100);
66     return LIBAVDEVICE_VERSION_INT;
67 }
68
69 const char * avdevice_configuration(void)
70 {
71     return FFMPEG_CONFIGURATION;
72 }
73
74 const char * avdevice_license(void)
75 {
76 #define LICENSE_PREFIX "libavdevice license: "
77     return LICENSE_PREFIX FFMPEG_LICENSE + sizeof(LICENSE_PREFIX) - 1;
78 }
79
80 static void *av_device_next(void *prev, int output,
81                             AVClassCategory c1, AVClassCategory c2)
82 {
83     const AVClass *pc;
84     AVClassCategory category = AV_CLASS_CATEGORY_NA;
85     do {
86         if (output) {
87             if (!(prev = av_oformat_next(prev)))
88                 break;
89             pc = ((AVOutputFormat *)prev)->priv_class;
90         } else {
91             if (!(prev = av_iformat_next(prev)))
92                 break;
93             pc = ((AVInputFormat *)prev)->priv_class;
94         }
95         if (!pc)
96             continue;
97         category = pc->category;
98     } while (category != c1 && category != c2);
99     return prev;
100 }
101
102 AVInputFormat *av_input_audio_device_next(AVInputFormat  *d)
103 {
104     return av_device_next(d, 0, AV_CLASS_CATEGORY_DEVICE_AUDIO_INPUT,
105                           AV_CLASS_CATEGORY_DEVICE_INPUT);
106 }
107
108 AVInputFormat *av_input_video_device_next(AVInputFormat  *d)
109 {
110     return av_device_next(d, 0, AV_CLASS_CATEGORY_DEVICE_VIDEO_INPUT,
111                           AV_CLASS_CATEGORY_DEVICE_INPUT);
112 }
113
114 AVOutputFormat *av_output_audio_device_next(AVOutputFormat *d)
115 {
116     return av_device_next(d, 1, AV_CLASS_CATEGORY_DEVICE_AUDIO_OUTPUT,
117                           AV_CLASS_CATEGORY_DEVICE_OUTPUT);
118 }
119
120 AVOutputFormat *av_output_video_device_next(AVOutputFormat *d)
121 {
122     return av_device_next(d, 1, AV_CLASS_CATEGORY_DEVICE_VIDEO_OUTPUT,
123                           AV_CLASS_CATEGORY_DEVICE_OUTPUT);
124 }
125
126 int avdevice_app_to_dev_control_message(struct AVFormatContext *s, enum AVAppToDevMessageType type,
127                                         void *data, size_t data_size)
128 {
129     if (!s->oformat || !s->oformat->control_message)
130         return AVERROR(ENOSYS);
131     return s->oformat->control_message(s, type, data, data_size);
132 }
133
134 int avdevice_dev_to_app_control_message(struct AVFormatContext *s, enum AVDevToAppMessageType type,
135                                         void *data, size_t data_size)
136 {
137     if (!s->control_message_cb)
138         return AVERROR(ENOSYS);
139     return s->control_message_cb(s, type, data, data_size);
140 }
141
142 int avdevice_capabilities_create(AVDeviceCapabilitiesQuery **caps, AVFormatContext *s,
143                                  AVDictionary **device_options)
144 {
145     int ret;
146     av_assert0(s && caps);
147     av_assert0(s->iformat || s->oformat);
148     if ((s->oformat && !s->oformat->create_device_capabilities) ||
149         (s->iformat && !s->iformat->create_device_capabilities))
150         return AVERROR(ENOSYS);
151     *caps = av_mallocz(sizeof(**caps));
152     if (!(*caps))
153         return AVERROR(ENOMEM);
154     (*caps)->device_context = s;
155     if (((ret = av_opt_set_dict(s->priv_data, device_options)) < 0))
156         goto fail;
157     if (s->iformat) {
158         if ((ret = s->iformat->create_device_capabilities(s, *caps)) < 0)
159             goto fail;
160     } else {
161         if ((ret = s->oformat->create_device_capabilities(s, *caps)) < 0)
162             goto fail;
163     }
164     av_opt_set_defaults(*caps);
165     return 0;
166   fail:
167     av_freep(caps);
168     return ret;
169 }
170
171 void avdevice_capabilities_free(AVDeviceCapabilitiesQuery **caps, AVFormatContext *s)
172 {
173     if (!s || !caps || !(*caps))
174         return;
175     av_assert0(s->iformat || s->oformat);
176     if (s->iformat) {
177         if (s->iformat->free_device_capabilities)
178             s->iformat->free_device_capabilities(s, *caps);
179     } else {
180         if (s->oformat->free_device_capabilities)
181             s->oformat->free_device_capabilities(s, *caps);
182     }
183     av_freep(caps);
184 }
185
186 int avdevice_list_devices(AVFormatContext *s, AVDeviceInfoList **device_list)
187 {
188     int ret;
189     av_assert0(s);
190     av_assert0(device_list);
191     av_assert0(s->oformat || s->iformat);
192     if ((s->oformat && !s->oformat->get_device_list) ||
193         (s->iformat && !s->iformat->get_device_list)) {
194         *device_list = NULL;
195         return AVERROR(ENOSYS);
196     }
197     *device_list = av_mallocz(sizeof(AVDeviceInfoList));
198     if (!(*device_list))
199         return AVERROR(ENOMEM);
200     /* no default device by default */
201     (*device_list)->default_device = -1;
202     if (s->oformat)
203         ret = s->oformat->get_device_list(s, *device_list);
204     else
205         ret = s->iformat->get_device_list(s, *device_list);
206     if (ret < 0)
207         avdevice_free_list_devices(device_list);
208     return ret;
209 }
210
211 void avdevice_free_list_devices(AVDeviceInfoList **device_list)
212 {
213     AVDeviceInfoList *list;
214     AVDeviceInfo *dev;
215     int i;
216
217     av_assert0(device_list);
218     list = *device_list;
219     if (!list)
220         return;
221
222     for (i = 0; i < list->nb_devices; i++) {
223         dev = list->devices[i];
224         if (dev) {
225             av_freep(&dev->device_name);
226             av_freep(&dev->device_description);
227             av_free(dev);
228         }
229     }
230     av_freep(&list->devices);
231     av_freep(device_list);
232 }