2 * Blackmagic DeckLink output
3 * Copyright (c) 2013-2014 Ramiro Polla, Luca Barbato, Deti Fliegl
5 * This file is part of FFmpeg.
7 * FFmpeg is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2.1 of the License, or (at your option) any later version.
12 * FFmpeg is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with FFmpeg; if not, write to the Free Software
19 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
22 /* Include internal.h first to avoid conflict between winsock.h (used by
23 * DeckLink headers) and winsock2.h (used by libavformat) in MSVC++ builds */
25 #include "libavformat/internal.h"
28 #include <DeckLinkAPI.h>
30 #include <DeckLinkAPI_i.c>
32 #include <DeckLinkAPIDispatch.cpp>
36 #include "libavformat/avformat.h"
37 #include "libavutil/imgutils.h"
38 #include "libavutil/intreadwrite.h"
39 #include "libavutil/bswap.h"
43 #include "decklink_common.h"
46 IDeckLinkIterator *CreateDeckLinkIteratorInstance(void)
48 IDeckLinkIterator *iter;
50 if (CoInitialize(NULL) < 0) {
51 av_log(NULL, AV_LOG_ERROR, "COM initialization failed.\n");
55 if (CoCreateInstance(CLSID_CDeckLinkIterator, NULL, CLSCTX_ALL,
56 IID_IDeckLinkIterator, (void**) &iter) != S_OK) {
57 av_log(NULL, AV_LOG_ERROR, "DeckLink drivers not installed.\n");
66 static char *dup_wchar_to_utf8(wchar_t *w)
69 int l = WideCharToMultiByte(CP_UTF8, 0, w, -1, 0, 0, 0, 0);
70 s = (char *) av_malloc(l);
72 WideCharToMultiByte(CP_UTF8, 0, w, -1, s, l, 0, 0);
75 #define DECKLINK_STR OLECHAR *
76 #define DECKLINK_STRDUP dup_wchar_to_utf8
77 #define DECKLINK_FREE(s) SysFreeString(s)
78 #define DECKLINK_BOOL BOOL
79 #elif defined(__APPLE__)
80 static char *dup_cfstring_to_utf8(CFStringRef w)
83 CFStringGetCString(w, s, 255, kCFStringEncodingUTF8);
86 #define DECKLINK_STR const __CFString *
87 #define DECKLINK_STRDUP dup_cfstring_to_utf8
88 #define DECKLINK_FREE(s) CFRelease(s)
89 #define DECKLINK_BOOL bool
91 #define DECKLINK_STR const char *
92 #define DECKLINK_STRDUP av_strdup
93 /* free() is needed for a string returned by the DeckLink SDL. */
94 #define DECKLINK_FREE(s) free((void *) s)
95 #define DECKLINK_BOOL bool
98 HRESULT ff_decklink_get_display_name(IDeckLink *This, const char **displayName)
100 DECKLINK_STR tmpDisplayName;
101 HRESULT hr = This->GetDisplayName(&tmpDisplayName);
104 *displayName = DECKLINK_STRDUP(tmpDisplayName);
105 DECKLINK_FREE(tmpDisplayName);
109 static int decklink_select_input(AVFormatContext *avctx, BMDDeckLinkConfigurationID cfg_id)
111 struct decklink_cctx *cctx = (struct decklink_cctx *)avctx->priv_data;
112 struct decklink_ctx *ctx = (struct decklink_ctx *)cctx->ctx;
113 BMDDeckLinkAttributeID attr_id = (cfg_id == bmdDeckLinkConfigAudioInputConnection) ? BMDDeckLinkAudioInputConnections : BMDDeckLinkVideoInputConnections;
114 int64_t bmd_input = (cfg_id == bmdDeckLinkConfigAudioInputConnection) ? (int64_t)ctx->audio_input : (int64_t)ctx->video_input;
115 const char *type_name = (cfg_id == bmdDeckLinkConfigAudioInputConnection) ? "audio" : "video";
116 int64_t supported_connections = 0;
120 res = ctx->attr->GetInt(attr_id, &supported_connections);
122 av_log(avctx, AV_LOG_ERROR, "Failed to query supported %s inputs.\n", type_name);
123 return AVERROR_EXTERNAL;
125 if ((supported_connections & bmd_input) != bmd_input) {
126 av_log(avctx, AV_LOG_ERROR, "Device does not support selected %s input.\n", type_name);
127 return AVERROR(ENOSYS);
129 res = ctx->cfg->SetInt(cfg_id, bmd_input);
131 av_log(avctx, AV_LOG_ERROR, "Failed to select %s input.\n", type_name);
132 return AVERROR_EXTERNAL;
138 static DECKLINK_BOOL field_order_eq(enum AVFieldOrder field_order, BMDFieldDominance bmd_field_order)
140 if (field_order == AV_FIELD_UNKNOWN)
142 if ((field_order == AV_FIELD_TT || field_order == AV_FIELD_TB) && bmd_field_order == bmdUpperFieldFirst)
144 if ((field_order == AV_FIELD_BB || field_order == AV_FIELD_BT) && bmd_field_order == bmdLowerFieldFirst)
146 if (field_order == AV_FIELD_PROGRESSIVE && (bmd_field_order == bmdProgressiveFrame || bmd_field_order == bmdProgressiveSegmentedFrame))
151 int ff_decklink_set_format(AVFormatContext *avctx,
152 int width, int height,
153 int tb_num, int tb_den,
154 enum AVFieldOrder field_order,
155 decklink_direction_t direction, int num)
157 struct decklink_cctx *cctx = (struct decklink_cctx *)avctx->priv_data;
158 struct decklink_ctx *ctx = (struct decklink_ctx *)cctx->ctx;
159 BMDDisplayModeSupport support;
160 IDeckLinkDisplayModeIterator *itermode;
161 IDeckLinkDisplayMode *mode;
165 av_log(avctx, AV_LOG_DEBUG, "Trying to find mode for frame size %dx%d, frame timing %d/%d, field order %d, direction %d, mode number %d, format code %s\n",
166 width, height, tb_num, tb_den, field_order, direction, num, (cctx->format_code) ? cctx->format_code : "(unset)");
168 if (ctx->duplex_mode) {
169 DECKLINK_BOOL duplex_supported = false;
171 if (ctx->attr->GetFlag(BMDDeckLinkSupportsDuplexModeConfiguration, &duplex_supported) != S_OK)
172 duplex_supported = false;
174 if (duplex_supported) {
175 res = ctx->cfg->SetInt(bmdDeckLinkConfigDuplexMode, ctx->duplex_mode == 2 ? bmdDuplexModeFull : bmdDuplexModeHalf);
177 av_log(avctx, AV_LOG_WARNING, "Setting duplex mode failed.\n");
179 av_log(avctx, AV_LOG_VERBOSE, "Successfully set duplex mode to %s duplex.\n", ctx->duplex_mode == 2 ? "full" : "half");
181 av_log(avctx, AV_LOG_WARNING, "Unable to set duplex mode, because it is not supported.\n");
185 if (direction == DIRECTION_IN) {
187 ret = decklink_select_input(avctx, bmdDeckLinkConfigAudioInputConnection);
190 ret = decklink_select_input(avctx, bmdDeckLinkConfigVideoInputConnection);
193 res = ctx->dli->GetDisplayModeIterator (&itermode);
195 res = ctx->dlo->GetDisplayModeIterator (&itermode);
199 av_log(avctx, AV_LOG_ERROR, "Could not get Display Mode Iterator\n");
203 char format_buf[] = " ";
204 if (cctx->format_code)
205 memcpy(format_buf, cctx->format_code, FFMIN(strlen(cctx->format_code), sizeof(format_buf)));
206 BMDDisplayMode target_mode = (BMDDisplayMode)AV_RB32(format_buf);
207 AVRational target_tb = av_make_q(tb_num, tb_den);
208 ctx->bmd_mode = bmdModeUnknown;
209 while ((ctx->bmd_mode == bmdModeUnknown) && itermode->Next(&mode) == S_OK) {
210 BMDTimeValue bmd_tb_num, bmd_tb_den;
211 int bmd_width = mode->GetWidth();
212 int bmd_height = mode->GetHeight();
213 BMDDisplayMode bmd_mode = mode->GetDisplayMode();
214 BMDFieldDominance bmd_field_dominance = mode->GetFieldDominance();
216 mode->GetFrameRate(&bmd_tb_num, &bmd_tb_den);
217 AVRational mode_tb = av_make_q(bmd_tb_num, bmd_tb_den);
219 if ((bmd_width == width &&
220 bmd_height == height &&
221 !av_cmp_q(mode_tb, target_tb) &&
222 field_order_eq(field_order, bmd_field_dominance))
224 || target_mode == bmd_mode) {
225 ctx->bmd_mode = bmd_mode;
226 ctx->bmd_width = bmd_width;
227 ctx->bmd_height = bmd_height;
228 ctx->bmd_tb_den = bmd_tb_den;
229 ctx->bmd_tb_num = bmd_tb_num;
230 ctx->bmd_field_dominance = bmd_field_dominance;
231 av_log(avctx, AV_LOG_INFO, "Found Decklink mode %d x %d with rate %.2f%s\n",
232 bmd_width, bmd_height, 1/av_q2d(mode_tb),
233 (ctx->bmd_field_dominance==bmdLowerFieldFirst || ctx->bmd_field_dominance==bmdUpperFieldFirst)?"(i)":"");
242 if (ctx->bmd_mode == bmdModeUnknown)
244 if (direction == DIRECTION_IN) {
245 if (ctx->dli->DoesSupportVideoMode(ctx->bmd_mode, (BMDPixelFormat) cctx->raw_format,
246 bmdVideoOutputFlagDefault,
247 &support, NULL) != S_OK)
250 if (ctx->dlo->DoesSupportVideoMode(ctx->bmd_mode, bmdFormat8BitYUV,
251 bmdVideoOutputFlagDefault,
252 &support, NULL) != S_OK)
255 if (support == bmdDisplayModeSupported)
261 int ff_decklink_set_format(AVFormatContext *avctx, decklink_direction_t direction, int num) {
262 return ff_decklink_set_format(avctx, 0, 0, 0, 0, AV_FIELD_UNKNOWN, direction, num);
265 int ff_decklink_list_devices(AVFormatContext *avctx,
266 struct AVDeviceInfoList *device_list,
267 int show_inputs, int show_outputs)
269 IDeckLink *dl = NULL;
270 IDeckLinkIterator *iter = CreateDeckLinkIteratorInstance();
274 av_log(avctx, AV_LOG_ERROR, "Could not create DeckLink iterator\n");
278 while (ret == 0 && iter->Next(&dl) == S_OK) {
279 IDeckLinkOutput *output_config;
280 IDeckLinkInput *input_config;
281 const char *displayName;
282 AVDeviceInfo *new_device = NULL;
285 ff_decklink_get_display_name(dl, &displayName);
288 if (dl->QueryInterface(IID_IDeckLinkOutput, (void **)&output_config) == S_OK) {
289 output_config->Release();
295 if (dl->QueryInterface(IID_IDeckLinkInput, (void **)&input_config) == S_OK) {
296 input_config->Release();
302 new_device = (AVDeviceInfo *) av_mallocz(sizeof(AVDeviceInfo));
304 ret = AVERROR(ENOMEM);
307 new_device->device_name = av_strdup(displayName);
308 if (!new_device->device_name) {
309 ret = AVERROR(ENOMEM);
313 new_device->device_description = av_strdup(displayName);
314 if (!new_device->device_description) {
315 av_freep(&new_device->device_name);
316 ret = AVERROR(ENOMEM);
320 if ((ret = av_dynarray_add_nofree(&device_list->devices,
321 &device_list->nb_devices, new_device)) < 0) {
322 av_freep(&new_device->device_name);
323 av_freep(&new_device->device_description);
324 av_freep(&new_device);
330 av_freep(&displayName);
337 /* This is a wrapper around the ff_decklink_list_devices() which dumps the
338 output to av_log() and exits (for backward compatibility with the
339 "-list_devices" argument). */
340 void ff_decklink_list_devices_legacy(AVFormatContext *avctx,
341 int show_inputs, int show_outputs)
343 struct AVDeviceInfoList *device_list = NULL;
346 device_list = (struct AVDeviceInfoList *) av_mallocz(sizeof(AVDeviceInfoList));
350 ret = ff_decklink_list_devices(avctx, device_list, show_inputs, show_outputs);
352 av_log(avctx, AV_LOG_INFO, "Blackmagic DeckLink %s devices:\n",
353 show_inputs ? "input" : "output");
354 for (int i = 0; i < device_list->nb_devices; i++) {
355 av_log(avctx, AV_LOG_INFO, "\t'%s'\n", device_list->devices[i]->device_name);
358 avdevice_free_list_devices(&device_list);
361 int ff_decklink_list_formats(AVFormatContext *avctx, decklink_direction_t direction)
363 struct decklink_cctx *cctx = (struct decklink_cctx *)avctx->priv_data;
364 struct decklink_ctx *ctx = (struct decklink_ctx *)cctx->ctx;
365 IDeckLinkDisplayModeIterator *itermode;
366 IDeckLinkDisplayMode *mode;
367 uint32_t format_code;
370 if (direction == DIRECTION_IN) {
372 ret = decklink_select_input(avctx, bmdDeckLinkConfigAudioInputConnection);
375 ret = decklink_select_input(avctx, bmdDeckLinkConfigVideoInputConnection);
378 res = ctx->dli->GetDisplayModeIterator (&itermode);
380 res = ctx->dlo->GetDisplayModeIterator (&itermode);
384 av_log(avctx, AV_LOG_ERROR, "Could not get Display Mode Iterator\n");
388 av_log(avctx, AV_LOG_INFO, "Supported formats for '%s':\n\tformat_code\tdescription",
390 while (itermode->Next(&mode) == S_OK) {
391 BMDTimeValue tb_num, tb_den;
392 mode->GetFrameRate(&tb_num, &tb_den);
393 format_code = av_bswap32(mode->GetDisplayMode());
394 av_log(avctx, AV_LOG_INFO, "\n\t%.4s\t\t%ldx%ld at %d/%d fps",
395 (char*) &format_code, mode->GetWidth(), mode->GetHeight(),
396 (int) tb_den, (int) tb_num);
397 switch (mode->GetFieldDominance()) {
398 case bmdLowerFieldFirst:
399 av_log(avctx, AV_LOG_INFO, " (interlaced, lower field first)"); break;
400 case bmdUpperFieldFirst:
401 av_log(avctx, AV_LOG_INFO, " (interlaced, upper field first)"); break;
405 av_log(avctx, AV_LOG_INFO, "\n");
412 void ff_decklink_cleanup(AVFormatContext *avctx)
414 struct decklink_cctx *cctx = (struct decklink_cctx *)avctx->priv_data;
415 struct decklink_ctx *ctx = (struct decklink_ctx *)cctx->ctx;
422 ctx->attr->Release();
429 int ff_decklink_init_device(AVFormatContext *avctx, const char* name)
431 struct decklink_cctx *cctx = (struct decklink_cctx *)avctx->priv_data;
432 struct decklink_ctx *ctx = (struct decklink_ctx *)cctx->ctx;
433 IDeckLink *dl = NULL;
434 IDeckLinkIterator *iter = CreateDeckLinkIteratorInstance();
436 av_log(avctx, AV_LOG_ERROR, "Could not create DeckLink iterator\n");
437 return AVERROR_EXTERNAL;
440 while (iter->Next(&dl) == S_OK) {
441 const char *displayName;
442 ff_decklink_get_display_name(dl, &displayName);
443 if (!strcmp(name, displayName)) {
444 av_free((void *)displayName);
448 av_free((void *)displayName);
453 return AVERROR(ENXIO);
455 if (ctx->dl->QueryInterface(IID_IDeckLinkConfiguration, (void **)&ctx->cfg) != S_OK) {
456 av_log(avctx, AV_LOG_ERROR, "Could not get configuration interface for '%s'\n", name);
457 ff_decklink_cleanup(avctx);
458 return AVERROR_EXTERNAL;
461 if (ctx->dl->QueryInterface(IID_IDeckLinkAttributes, (void **)&ctx->attr) != S_OK) {
462 av_log(avctx, AV_LOG_ERROR, "Could not get attributes interface for '%s'\n", name);
463 ff_decklink_cleanup(avctx);
464 return AVERROR_EXTERNAL;