git.sesse.net Git - ffmpeg/blob - libavdevice/decklink_common.h

   1 /*
   2  * Blackmagic DeckLink common code
   3  * Copyright (c) 2013-2014 Ramiro Polla, Luca Barbato, Deti Fliegl
   4  * Copyright (c) 2017 Akamai Technologies, Inc.
   5  *
   6  * This file is part of FFmpeg.
   7  *
   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.
  12  *
  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.
  17  *
  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
  21  */
  22
  23 #ifndef AVDEVICE_DECKLINK_COMMON_H
  24 #define AVDEVICE_DECKLINK_COMMON_H
  25
  26 #include <DeckLinkAPIVersion.h>
  27 #if BLACKMAGIC_DECKLINK_API_VERSION < 0x0b000000
  28 #define IID_IDeckLinkProfileAttributes IID_IDeckLinkAttributes
  29 #define IDeckLinkProfileAttributes IDeckLinkAttributes
  30 #endif
  31
  32 #include "libavutil/thread.h"
  33 #include "decklink_common_c.h"
  34 #if CONFIG_LIBKLVANC
  35 #include "libklvanc/vanc.h"
  36 #endif
  37
  38 #ifdef _WIN32
  39 #define DECKLINK_BOOL BOOL
  40 #else
  41 #define DECKLINK_BOOL bool
  42 #endif
  43
  44 #ifdef _WIN32
  45 static char *dup_wchar_to_utf8(wchar_t *w)
  46 {
  47     char *s = NULL;
  48     int l = WideCharToMultiByte(CP_UTF8, 0, w, -1, 0, 0, 0, 0);
  49     s = (char *) av_malloc(l);
  50     if (s)
  51         WideCharToMultiByte(CP_UTF8, 0, w, -1, s, l, 0, 0);
  52     return s;
  53 }
  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)
  59 {
  60     char s[256];
  61     CFStringGetCString(w, s, 255, kCFStringEncodingUTF8);
  62     return av_strdup(s);
  63 }
  64 #define DECKLINK_STR    const __CFString *
  65 #define DECKLINK_STRDUP dup_cfstring_to_utf8
  66 #define DECKLINK_FREE(s) CFRelease(s)
  67 #else
  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)
  72 #endif
  73
  74 class decklink_output_callback;
  75 class decklink_input_callback;
  76
  77 typedef struct AVPacketQueue {
  78     AVPacketList *first_pkt, *last_pkt;
  79     int nb_packets;
  80     unsigned long long size;
  81     int abort_request;
  82     pthread_mutex_t mutex;
  83     pthread_cond_t cond;
  84     AVFormatContext *avctx;
  85     int64_t max_q_size;
  86 } AVPacketQueue;
  87
  88 struct decklink_ctx {
  89     /* DeckLink SDK interfaces */
  90     IDeckLink *dl;
  91     IDeckLinkOutput *dlo;
  92     IDeckLinkInput *dli;
  93     IDeckLinkConfiguration *cfg;
  94     IDeckLinkProfileAttributes *attr;
  95     decklink_output_callback *output_callback;
  96
  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;
 104     int bmd_width;
 105     int bmd_height;
 106     int bmd_field_dominance;
 107     int supports_vanc;
 108
 109     /* Capture buffer queue */
 110     AVPacketQueue queue;
 111
 112     /* Streams present */
 113     int audio;
 114     int video;
 115
 116     /* Status */
 117     int playback_started;
 118     int64_t last_pts;
 119     unsigned long frameCount;
 120     unsigned int dropped;
 121     AVStream *audio_st;
 122     AVStream *video_st;
 123     AVStream *klv_st;
 124     AVStream *teletext_st;
 125     uint16_t cdp_sequence_num;
 126
 127     /* Options */
 128     int list_devices;
 129     int list_formats;
 130     int enable_klv;
 131     int64_t teletext_lines;
 132     double preroll;
 133     int duplex_mode;
 134     DecklinkPtsSource audio_pts_source;
 135     DecklinkPtsSource video_pts_source;
 136     int draw_bars;
 137     BMDPixelFormat raw_format;
 138
 139     int frames_preroll;
 140     int frames_buffer;
 141
 142     pthread_mutex_t mutex;
 143     pthread_cond_t cond;
 144     int frames_buffer_available_spots;
 145     int autodetect;
 146
 147 #if CONFIG_LIBKLVANC
 148     struct klvanc_context_s *vanc_ctx;
 149 #endif
 150
 151     int channels;
 152     int audio_depth;
 153     unsigned long tc_seen;    // used with option wait_for_tc
 154 };
 155
 156 typedef enum { DIRECTION_IN, DIRECTION_OUT} decklink_direction_t;
 157
 158 #ifdef _WIN32
 159 typedef unsigned int buffercount_type;
 160 IDeckLinkIterator *CreateDeckLinkIteratorInstance(void);
 161 #else
 162 typedef uint32_t buffercount_type;
 163 #endif
 164
 165 static const BMDPixelFormat decklink_raw_format_map[] = {
 166     (BMDPixelFormat)0,
 167     bmdFormat8BitYUV,
 168     bmdFormat10BitYUV,
 169     bmdFormat8BitARGB,
 170     bmdFormat8BitBGRA,
 171     bmdFormat10BitRGB,
 172 };
 173
 174 static const BMDAudioConnection decklink_audio_connection_map[] = {
 175     (BMDAudioConnection)0,
 176     bmdAudioConnectionEmbedded,
 177     bmdAudioConnectionAESEBU,
 178     bmdAudioConnectionAnalog,
 179     bmdAudioConnectionAnalogXLR,
 180     bmdAudioConnectionAnalogRCA,
 181     bmdAudioConnectionMicrophone,
 182 };
 183
 184 static const BMDVideoConnection decklink_video_connection_map[] = {
 185     (BMDVideoConnection)0,
 186     bmdVideoConnectionSDI,
 187     bmdVideoConnectionHDMI,
 188     bmdVideoConnectionOpticalSDI,
 189     bmdVideoConnectionComponent,
 190     bmdVideoConnectionComposite,
 191     bmdVideoConnectionSVideo,
 192 };
 193
 194 static const BMDTimecodeFormat decklink_timecode_format_map[] = {
 195     (BMDTimecodeFormat)0,
 196     bmdTimecodeRP188VITC1,
 197     bmdTimecodeRP188VITC2,
 198     bmdTimecodeRP188LTC,
 199     bmdTimecodeRP188Any,
 200     bmdTimecodeVITC,
 201     bmdTimecodeVITCField2,
 202     bmdTimecodeSerial,
 203 #if BLACKMAGIC_DECKLINK_API_VERSION >= 0x0b000000
 204     bmdTimecodeRP188HighFrameRate,
 205 #else
 206     (BMDTimecodeFormat)0,
 207 #endif
 208 };
 209
 210 int ff_decklink_set_configs(AVFormatContext *avctx, decklink_direction_t direction);
 211 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);
 212 int ff_decklink_set_format(AVFormatContext *avctx, decklink_direction_t direction);
 213 int ff_decklink_list_devices(AVFormatContext *avctx, struct AVDeviceInfoList *device_list, int show_inputs, int show_outputs);
 214 void ff_decklink_list_devices_legacy(AVFormatContext *avctx, int show_inputs, int show_outputs);
 215 int ff_decklink_list_formats(AVFormatContext *avctx, decklink_direction_t direction = DIRECTION_OUT);
 216 void ff_decklink_cleanup(AVFormatContext *avctx);
 217 int ff_decklink_init_device(AVFormatContext *avctx, const char* name);
 218
 219 #endif /* AVDEVICE_DECKLINK_COMMON_H */