FFmpeg
decklink_dec_c.c
Go to the documentation of this file.
1 /*
2  * Blackmagic DeckLink input
3  * Copyright (c) 2014 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 #include "libavformat/avformat.h"
24 #include "libavutil/opt.h"
25 
26 #include "decklink_common_c.h"
27 #include "decklink_dec.h"
28 
29 #define OFFSET(x) offsetof(struct decklink_cctx, x)
30 #define DEC AV_OPT_FLAG_DECODING_PARAM
31 
32 static const AVOption options[] = {
33  { "list_devices", "use ffmpeg -sources decklink instead", OFFSET(list_devices), AV_OPT_TYPE_BOOL, { .i64 = 0 }, 0, 1, DEC | AV_OPT_FLAG_DEPRECATED},
34  { "list_formats", "list supported formats" , OFFSET(list_formats), AV_OPT_TYPE_INT , { .i64 = 0 }, 0, 1, DEC },
35  { "format_code", "set format by fourcc" , OFFSET(format_code), AV_OPT_TYPE_STRING, { .str = NULL}, 0, 0, DEC },
36  { "raw_format", "pixel format to be returned by the card when capturing" , OFFSET(raw_format), AV_OPT_TYPE_INT, { .i64 = 0}, 0, 5, DEC, "raw_format" },
37  { "auto", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = 0 }, 0, 0, DEC, "raw_format"},
38  { "uyvy422", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = 1 }, 0, 0, DEC, "raw_format"},
39  { "yuv422p10", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = 2 }, 0, 0, DEC, "raw_format"},
40  { "argb", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = 3 }, 0, 0, DEC, "raw_format"},
41  { "bgra", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = 4 }, 0, 0, DEC, "raw_format"},
42  { "rgb10", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = 5 }, 0, 0, DEC, "raw_format"},
43  { "enable_klv", "output klv if present in vanc", OFFSET(enable_klv), AV_OPT_TYPE_BOOL, { .i64 = 0 }, 0, 1, DEC },
44  { "teletext_lines", "teletext lines bitmask", OFFSET(teletext_lines), AV_OPT_TYPE_INT64, { .i64 = 0 }, 0, 0x7ffffffffLL, DEC, "teletext_lines"},
45  { "standard", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = 0x7fff9fffeLL}, 0, 0, DEC, "teletext_lines"},
46  { "all", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = 0x7ffffffffLL}, 0, 0, DEC, "teletext_lines"},
47  { "channels", "number of audio channels", OFFSET(audio_channels), AV_OPT_TYPE_INT , { .i64 = 2 }, 2, 16, DEC },
48 #if BLACKMAGIC_DECKLINK_API_VERSION >= 0x0b000000
49  { "duplex_mode", "duplex mode", OFFSET(duplex_mode), AV_OPT_TYPE_INT, { .i64 = 0}, 0, 5, DEC, "duplex_mode"},
50 #else
51  { "duplex_mode", "duplex mode", OFFSET(duplex_mode), AV_OPT_TYPE_INT, { .i64 = 0}, 0, 2, DEC, "duplex_mode"},
52 #endif
53  { "unset", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = 0}, 0, 0, DEC, "duplex_mode"},
54  { "half", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = 1}, 0, 0, DEC, "duplex_mode"},
55  { "full", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = 2}, 0, 0, DEC, "duplex_mode"},
56 #if BLACKMAGIC_DECKLINK_API_VERSION >= 0x0b000000
57  { "one_sub_device_full", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = 2}, 0, 0, DEC, "duplex_mode"},
58  { "one_sub_device_half", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = 3}, 0, 0, DEC, "duplex_mode"},
59  { "two_sub_device_full", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = 4}, 0, 0, DEC, "duplex_mode"},
60  { "four_sub_device_half", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = 5}, 0, 0, DEC, "duplex_mode"},
61 #endif
62  { "timecode_format", "timecode format", OFFSET(tc_format), AV_OPT_TYPE_INT, { .i64 = 0}, 0, 8, DEC, "tc_format"},
63  { "none", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = 0}, 0, 0, DEC, "tc_format"},
64  { "rp188vitc", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = 1}, 0, 0, DEC, "tc_format"},
65  { "rp188vitc2", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = 2}, 0, 0, DEC, "tc_format"},
66  { "rp188ltc", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = 3}, 0, 0, DEC, "tc_format"},
67  { "rp188any", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = 4}, 0, 0, DEC, "tc_format"},
68  { "vitc", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = 5}, 0, 0, DEC, "tc_format"},
69  { "vitc2", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = 6}, 0, 0, DEC, "tc_format"},
70  { "serial", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = 7}, 0, 0, DEC, "tc_format"},
71 #if BLACKMAGIC_DECKLINK_API_VERSION >= 0x0b000000
72  { "rp188hfr", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = 8}, 0, 0, DEC, "tc_format"},
73 #endif
74  { "video_input", "video input", OFFSET(video_input), AV_OPT_TYPE_INT, { .i64 = 0}, 0, 6, DEC, "video_input"},
75  { "unset", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = 0}, 0, 0, DEC, "video_input"},
76  { "sdi", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = 1}, 0, 0, DEC, "video_input"},
77  { "hdmi", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = 2}, 0, 0, DEC, "video_input"},
78  { "optical_sdi", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = 3}, 0, 0, DEC, "video_input"},
79  { "component", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = 4}, 0, 0, DEC, "video_input"},
80  { "composite", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = 5}, 0, 0, DEC, "video_input"},
81  { "s_video", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = 6}, 0, 0, DEC, "video_input"},
82  { "audio_input", "audio input", OFFSET(audio_input), AV_OPT_TYPE_INT, { .i64 = 0}, 0, 6, DEC, "audio_input"},
83  { "unset", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = 0}, 0, 0, DEC, "audio_input"},
84  { "embedded", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = 1}, 0, 0, DEC, "audio_input"},
85  { "aes_ebu", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = 2}, 0, 0, DEC, "audio_input"},
86  { "analog", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = 3}, 0, 0, DEC, "audio_input"},
87  { "analog_xlr", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = 4}, 0, 0, DEC, "audio_input"},
88  { "analog_rca", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = 5}, 0, 0, DEC, "audio_input"},
89  { "microphone", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = 6}, 0, 0, DEC, "audio_input"},
90  { "audio_pts", "audio pts source", OFFSET(audio_pts_source), AV_OPT_TYPE_INT, { .i64 = PTS_SRC_AUDIO }, 1, PTS_SRC_NB-1, DEC, "pts_source"},
91  { "video_pts", "video pts source", OFFSET(video_pts_source), AV_OPT_TYPE_INT, { .i64 = PTS_SRC_VIDEO }, 1, PTS_SRC_NB-1, DEC, "pts_source"},
92  { "audio", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = PTS_SRC_AUDIO }, 0, 0, DEC, "pts_source"},
93  { "video", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = PTS_SRC_VIDEO }, 0, 0, DEC, "pts_source"},
94  { "reference", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = PTS_SRC_REFERENCE}, 0, 0, DEC, "pts_source"},
95  { "wallclock", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = PTS_SRC_WALLCLOCK}, 0, 0, DEC, "pts_source"},
96  { "abs_wallclock", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = PTS_SRC_ABS_WALLCLOCK}, 0, 0, DEC, "pts_source"},
97  { "draw_bars", "draw bars on signal loss" , OFFSET(draw_bars), AV_OPT_TYPE_BOOL, { .i64 = 1}, 0, 1, DEC },
98  { "queue_size", "input queue buffer size", OFFSET(queue_size), AV_OPT_TYPE_INT64, { .i64 = (1024 * 1024 * 1024)}, 0, INT64_MAX, DEC },
99  { "audio_depth", "audio bitdepth (16 or 32)", OFFSET(audio_depth), AV_OPT_TYPE_INT, { .i64 = 16}, 16, 32, DEC },
100  { "decklink_copyts", "copy timestamps, do not remove the initial offset", OFFSET(copyts), AV_OPT_TYPE_BOOL, { .i64 = 0 }, 0, 1, DEC },
101  { "timestamp_align", "capture start time alignment (in seconds)", OFFSET(timestamp_align), AV_OPT_TYPE_DURATION, { .i64 = 0 }, 0, INT_MAX, DEC },
102  { "wait_for_tc", "drop frames till a frame with timecode is received. TC format must be set", OFFSET(wait_for_tc), AV_OPT_TYPE_BOOL, { .i64 = 0 }, 0, 1, DEC },
103  { NULL },
104 };
105 
106 static const AVClass decklink_demuxer_class = {
107  .class_name = "Blackmagic DeckLink indev",
108  .item_name = av_default_item_name,
109  .option = options,
110  .version = LIBAVUTIL_VERSION_INT,
111  .category = AV_CLASS_CATEGORY_DEVICE_VIDEO_INPUT,
112 };
113 
114 const AVInputFormat ff_decklink_demuxer = {
115  .name = "decklink",
116  .long_name = NULL_IF_CONFIG_SMALL("Blackmagic DeckLink input"),
117  .flags = AVFMT_NOFILE,
118  .priv_class = &decklink_demuxer_class,
119  .priv_data_size = sizeof(struct decklink_cctx),
120  .get_device_list = ff_decklink_list_input_devices,
121  .read_header = ff_decklink_read_header,
122  .read_packet = ff_decklink_read_packet,
123  .read_close = ff_decklink_read_close,
124 };
decklink_cctx::format_code
char * format_code
Definition: decklink_common_c.h:63
decklink_demuxer_class
static const AVClass decklink_demuxer_class
Definition: decklink_dec_c.c:106
opt.h
ff_decklink_demuxer
const AVInputFormat ff_decklink_demuxer
Definition: decklink_dec_c.c:114
PTS_SRC_AUDIO
@ PTS_SRC_AUDIO
Definition: decklink_common_c.h:32
decklink_cctx::video_pts_source
DecklinkPtsSource video_pts_source
Definition: decklink_common_c.h:58
audio_channels
int audio_channels
Definition: rtp.c:40
PTS_SRC_NB
@ PTS_SRC_NB
Definition: decklink_common_c.h:37
ff_decklink_read_close
av_cold int ff_decklink_read_close(AVFormatContext *avctx)
Definition: decklink_dec.cpp:1144
decklink_cctx::enable_klv
int enable_klv
Definition: decklink_common_c.h:48
AVOption
AVOption.
Definition: opt.h:251
AV_OPT_TYPE_DURATION
@ AV_OPT_TYPE_DURATION
Definition: opt.h:239
decklink_cctx::timestamp_align
int64_t timestamp_align
Definition: decklink_common_c.h:67
decklink_cctx::audio_pts_source
DecklinkPtsSource audio_pts_source
Definition: decklink_common_c.h:57
decklink_cctx
Definition: decklink_common_c.h:40
ff_decklink_read_packet
int ff_decklink_read_packet(AVFormatContext *avctx, AVPacket *pkt)
Definition: decklink_dec.cpp:1429
AVInputFormat
Definition: avformat.h:546
PTS_SRC_ABS_WALLCLOCK
@ PTS_SRC_ABS_WALLCLOCK
Definition: decklink_common_c.h:36
AVInputFormat::name
const char * name
A comma separated list of short names for the format.
Definition: avformat.h:551
AV_OPT_TYPE_INT64
@ AV_OPT_TYPE_INT64
Definition: opt.h:226
OFFSET
#define OFFSET(x)
Definition: decklink_dec_c.c:29
PTS_SRC_WALLCLOCK
@ PTS_SRC_WALLCLOCK
Definition: decklink_common_c.h:35
options
static const AVOption options[]
Definition: decklink_dec_c.c:32
decklink_cctx::draw_bars
int draw_bars
Definition: decklink_common_c.h:62
LIBAVUTIL_VERSION_INT
#define LIBAVUTIL_VERSION_INT
Definition: version.h:85
AVClass
Describe the class of an AVClass context structure.
Definition: log.h:66
NULL
#define NULL
Definition: coverity.c:32
decklink_cctx::queue_size
int64_t queue_size
Definition: decklink_common_c.h:65
av_default_item_name
const char * av_default_item_name(void *ptr)
Return the context name.
Definition: log.c:237
ff_decklink_read_header
av_cold int ff_decklink_read_header(AVFormatContext *avctx)
Definition: decklink_dec.cpp:1163
AV_CLASS_CATEGORY_DEVICE_VIDEO_INPUT
@ AV_CLASS_CATEGORY_DEVICE_VIDEO_INPUT
Definition: log.h:41
decklink_cctx::raw_format
int raw_format
Definition: decklink_common_c.h:64
list_formats
static void list_formats(AVFormatContext *ctx, int type)
Definition: v4l2.c:287
NULL_IF_CONFIG_SMALL
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification.
Definition: internal.h:115
decklink_cctx::copyts
int copyts
Definition: decklink_common_c.h:66
ff_decklink_list_input_devices
int ff_decklink_list_input_devices(AVFormatContext *avctx, struct AVDeviceInfoList *device_list)
Definition: decklink_dec.cpp:1448
AVFMT_NOFILE
#define AVFMT_NOFILE
Demuxer will use avio_open, no opened file should be provided by the caller.
Definition: avformat.h:468
decklink_dec.h
PTS_SRC_REFERENCE
@ PTS_SRC_REFERENCE
Definition: decklink_common_c.h:34
decklink_cctx::wait_for_tc
int wait_for_tc
Definition: decklink_common_c.h:69
decklink_cctx::list_devices
int list_devices
Definition: decklink_common_c.h:46
decklink_common_c.h
decklink_cctx::audio_input
int audio_input
Definition: decklink_common_c.h:59
AVClass::class_name
const char * class_name
The name of the class; usually it is the same name as the context structure type to which the AVClass...
Definition: log.h:71
avformat.h
AV_OPT_TYPE_INT
@ AV_OPT_TYPE_INT
Definition: opt.h:225
decklink_cctx::duplex_mode
int duplex_mode
Definition: decklink_common_c.h:53
decklink_cctx::audio_depth
int audio_depth
Definition: decklink_common_c.h:52
DEC
#define DEC
Definition: decklink_dec_c.c:30
PTS_SRC_VIDEO
@ PTS_SRC_VIDEO
Definition: decklink_common_c.h:33
decklink_cctx::tc_format
int tc_format
Definition: decklink_common_c.h:61
AV_OPT_TYPE_BOOL
@ AV_OPT_TYPE_BOOL
Definition: opt.h:244
decklink_cctx::video_input
int video_input
Definition: decklink_common_c.h:60
AV_OPT_TYPE_STRING
@ AV_OPT_TYPE_STRING
Definition: opt.h:229
AV_OPT_TYPE_CONST
@ AV_OPT_TYPE_CONST
Definition: opt.h:234
decklink_cctx::teletext_lines
int64_t teletext_lines
Definition: decklink_common_c.h:49
AV_OPT_FLAG_DEPRECATED
#define AV_OPT_FLAG_DEPRECATED
set if option is deprecated, users should refer to AVOption.help text for more information
Definition: opt.h:298
Generated on Tue Feb 28 2023 21:33:45 for FFmpeg by   doxygen 1.8.17