2 * Blackmagic DeckLink common code
3 * Copyright (c) 2013-2014 Ramiro Polla, Luca Barbato, Deti Fliegl
4 * Copyright (c) 2017 Akamai Technologies, Inc.
6 * This file is part of FFmpeg.
8 * FFmpeg is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU Lesser General Public
10 * License as published by the Free Software Foundation; either
11 * version 2.1 of the License, or (at your option) any later version.
13 * FFmpeg is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 * Lesser General Public License for more details.
18 * You should have received a copy of the GNU Lesser General Public
19 * License along with FFmpeg; if not, write to the Free Software
20 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
23 #ifndef AVDEVICE_DECKLINK_COMMON_H
24 #define AVDEVICE_DECKLINK_COMMON_H
26 #include <DeckLinkAPIVersion.h>
27 #if BLACKMAGIC_DECKLINK_API_VERSION < 0x0b000000
28 #define IID_IDeckLinkProfileAttributes IID_IDeckLinkAttributes
29 #define IDeckLinkProfileAttributes IDeckLinkAttributes
32 #include "libavutil/thread.h"
33 #include "decklink_common_c.h"
35 #include "libklvanc/vanc.h"
39 #define DECKLINK_BOOL BOOL
41 #define DECKLINK_BOOL bool
45 static char *dup_wchar_to_utf8(wchar_t *w)
48 int l = WideCharToMultiByte(CP_UTF8, 0, w, -1, 0, 0, 0, 0);
49 s = (char *) av_malloc(l);
51 WideCharToMultiByte(CP_UTF8, 0, w, -1, s, l, 0, 0);
54 #define DECKLINK_STR OLECHAR *
55 #define DECKLINK_STRDUP dup_wchar_to_utf8
56 #define DECKLINK_FREE(s) SysFreeString(s)
57 #elif defined(__APPLE__)
58 static char *dup_cfstring_to_utf8(CFStringRef w)
61 CFStringGetCString(w, s, 255, kCFStringEncodingUTF8);
64 #define DECKLINK_STR const __CFString *
65 #define DECKLINK_STRDUP dup_cfstring_to_utf8
66 #define DECKLINK_FREE(s) CFRelease(s)
68 #define DECKLINK_STR const char *
69 #define DECKLINK_STRDUP av_strdup
70 /* free() is needed for a string returned by the DeckLink SDL. */
71 #define DECKLINK_FREE(s) free((void *) s)
74 class decklink_output_callback;
75 class decklink_input_callback;
77 typedef struct AVPacketQueue {
78 PacketList *first_pkt, *last_pkt;
80 unsigned long long size;
82 pthread_mutex_t mutex;
84 AVFormatContext *avctx;
89 /* DeckLink SDK interfaces */
93 IDeckLinkConfiguration *cfg;
94 IDeckLinkProfileAttributes *attr;
95 decklink_output_callback *output_callback;
97 /* DeckLink mode information */
98 BMDTimeValue bmd_tb_den;
99 BMDTimeValue bmd_tb_num;
100 BMDDisplayMode bmd_mode;
101 BMDVideoConnection video_input;
102 BMDAudioConnection audio_input;
103 BMDTimecodeFormat tc_format;
106 int bmd_field_dominance;
109 /* Capture buffer queue */
112 /* Streams present */
117 int playback_started;
119 unsigned long frameCount;
120 unsigned int dropped;
124 AVStream *teletext_st;
125 uint16_t cdp_sequence_num;
131 int64_t teletext_lines;
134 DecklinkPtsSource audio_pts_source;
135 DecklinkPtsSource video_pts_source;
137 BMDPixelFormat raw_format;
142 pthread_mutex_t mutex;
144 int frames_buffer_available_spots;
148 struct klvanc_context_s *vanc_ctx;
153 unsigned long tc_seen; // used with option wait_for_tc
156 typedef enum { DIRECTION_IN, DIRECTION_OUT} decklink_direction_t;
158 static const BMDPixelFormat decklink_raw_format_map[] = {
167 static const BMDAudioConnection decklink_audio_connection_map[] = {
168 (BMDAudioConnection)0,
169 bmdAudioConnectionEmbedded,
170 bmdAudioConnectionAESEBU,
171 bmdAudioConnectionAnalog,
172 bmdAudioConnectionAnalogXLR,
173 bmdAudioConnectionAnalogRCA,
174 bmdAudioConnectionMicrophone,
177 static const BMDVideoConnection decklink_video_connection_map[] = {
178 (BMDVideoConnection)0,
179 bmdVideoConnectionSDI,
180 bmdVideoConnectionHDMI,
181 bmdVideoConnectionOpticalSDI,
182 bmdVideoConnectionComponent,
183 bmdVideoConnectionComposite,
184 bmdVideoConnectionSVideo,
187 static const BMDTimecodeFormat decklink_timecode_format_map[] = {
188 (BMDTimecodeFormat)0,
189 bmdTimecodeRP188VITC1,
190 bmdTimecodeRP188VITC2,
194 bmdTimecodeVITCField2,
196 #if BLACKMAGIC_DECKLINK_API_VERSION >= 0x0b000000
197 bmdTimecodeRP188HighFrameRate,
199 (BMDTimecodeFormat)0,
203 int ff_decklink_set_configs(AVFormatContext *avctx, decklink_direction_t direction);
204 int ff_decklink_set_format(AVFormatContext *avctx, int width, int height, int tb_num, int tb_den, enum AVFieldOrder field_order, decklink_direction_t direction = DIRECTION_OUT);
205 int ff_decklink_set_format(AVFormatContext *avctx, decklink_direction_t direction);
206 int ff_decklink_list_devices(AVFormatContext *avctx, struct AVDeviceInfoList *device_list, int show_inputs, int show_outputs);
207 void ff_decklink_list_devices_legacy(AVFormatContext *avctx, int show_inputs, int show_outputs);
208 int ff_decklink_list_formats(AVFormatContext *avctx, decklink_direction_t direction = DIRECTION_OUT);
209 void ff_decklink_cleanup(AVFormatContext *avctx);
210 int ff_decklink_init_device(AVFormatContext *avctx, const char* name);
212 #endif /* AVDEVICE_DECKLINK_COMMON_H */