mirror of
https://github.com/FFmpeg/FFmpeg.git
synced 2024-12-23 12:43:46 +02:00
avfilter: add EIA-608 line extractor
Signed-off-by: Dave Rice <dave@dericed.com> Signed-off-by: Paul B Mahol <onemda@gmail.com>
This commit is contained in:
parent
1bb192ef6c
commit
08e5732318
@ -15,6 +15,7 @@ version <next>:
|
||||
- QDMC audio decoder
|
||||
- NewTek SpeedHQ decoder
|
||||
- MIDI Sample Dump Standard demuxer
|
||||
- readeia608 filter
|
||||
|
||||
version 3.2:
|
||||
- libopenmpt demuxer
|
||||
|
@ -11253,6 +11253,76 @@ less than @code{0}, the filter will try to use a good random seed on a
|
||||
best effort basis.
|
||||
@end table
|
||||
|
||||
@section readeia608
|
||||
|
||||
Read closed captioning (EIA-608) information from the top lines of a video frame.
|
||||
|
||||
This filter adds frame metadata for @code{lavfi.readeia608.X.cc} and
|
||||
@code{lavfi.readeia608.X.line}, where @code{X} is the number of the identified line
|
||||
with EIA-608 data (starting from 0). A description of each metadata value follows:
|
||||
|
||||
@table @option
|
||||
@item lavfi.readeia608.X.cc
|
||||
The two bytes stored as EIA-608 data (printed in hexadecimal).
|
||||
|
||||
@item lavfi.readeia608.X.line
|
||||
The number of the line on which the EIA-608 data was identified and read.
|
||||
@end table
|
||||
|
||||
This filter accepts the following options:
|
||||
|
||||
@table @option
|
||||
@item scan_min
|
||||
Set the line to start scanning for EIA-608 data. Default is @code{0}.
|
||||
|
||||
@item scan_max
|
||||
Set the line to end scanning for EIA-608 data. Default is @code{29}.
|
||||
|
||||
@item mac
|
||||
Set minimal acceptable amplitude change for sync codes detection.
|
||||
Default is @code{0.2}. Allowed range is @code{[0.001 - 1]}.
|
||||
|
||||
@item spw
|
||||
Set the ratio of width reserved for sync code detection.
|
||||
Default is @code{0.27}. Allowed range is @code{[0.01 - 0.7]}.
|
||||
|
||||
@item mhd
|
||||
Set the max peaks height difference for sync code detection.
|
||||
Default is @code{0.1}. Allowed range is @code{[0.0 - 0.5]}.
|
||||
|
||||
@item mpd
|
||||
Set max peaks period difference for sync code detection.
|
||||
Default is @code{0.1}. Allowed range is @code{[0.0 - 0.5]}.
|
||||
|
||||
@item msd
|
||||
Set the first two max start code bits differences.
|
||||
Default is @code{0.02}. Allowed range is @code{[0.0 - 0.5]}.
|
||||
|
||||
@item bhd
|
||||
Set the minimum ratio of bits height compared to 3rd start code bit.
|
||||
Default is @code{0.75}. Allowed range is @code{[0.01 - 1]}.
|
||||
|
||||
@item th_w
|
||||
Set the white color threshold. Default is @code{0.35}. Allowed range is @code{[0.1 - 1]}.
|
||||
|
||||
@item th_b
|
||||
Set the black color threshold. Default is @code{0.15}. Allowed range is @code{[0.0 - 0.5]}.
|
||||
|
||||
@item chp
|
||||
Enable checking the parity bit. In the event of a parity error, the filter will output
|
||||
@code{0x00} for that character. Default is false.
|
||||
@end table
|
||||
|
||||
@subsection Examples
|
||||
|
||||
@itemize
|
||||
@item
|
||||
Output a csv with presentation time and the first two lines of identified EIA-608 captioning data.
|
||||
@example
|
||||
ffprobe -f lavfi -i movie=captioned_video.mov,readeia608 -show_entries frame=pkt_pts_time:frame_tags=lavfi.readeia608.0.cc,lavfi.readeia608.1.cc -of csv
|
||||
@end example
|
||||
@end itemize
|
||||
|
||||
@section readvitc
|
||||
|
||||
Read vertical interval timecode (VITC) information from the top lines of a
|
||||
|
@ -247,6 +247,7 @@ OBJS-$(CONFIG_PSNR_FILTER) += vf_psnr.o dualinput.o framesync.
|
||||
OBJS-$(CONFIG_PULLUP_FILTER) += vf_pullup.o
|
||||
OBJS-$(CONFIG_QP_FILTER) += vf_qp.o
|
||||
OBJS-$(CONFIG_RANDOM_FILTER) += vf_random.o
|
||||
OBJS-$(CONFIG_READEIA608_FILTER) += vf_readeia608.o
|
||||
OBJS-$(CONFIG_READVITC_FILTER) += vf_readvitc.o
|
||||
OBJS-$(CONFIG_REALTIME_FILTER) += f_realtime.o
|
||||
OBJS-$(CONFIG_REMAP_FILTER) += vf_remap.o framesync.o
|
||||
|
@ -262,6 +262,7 @@ void avfilter_register_all(void)
|
||||
REGISTER_FILTER(PULLUP, pullup, vf);
|
||||
REGISTER_FILTER(QP, qp, vf);
|
||||
REGISTER_FILTER(RANDOM, random, vf);
|
||||
REGISTER_FILTER(READEIA608, readeia608, vf);
|
||||
REGISTER_FILTER(READVITC, readvitc, vf);
|
||||
REGISTER_FILTER(REALTIME, realtime, vf);
|
||||
REGISTER_FILTER(REMAP, remap, vf);
|
||||
|
@ -30,7 +30,7 @@
|
||||
#include "libavutil/version.h"
|
||||
|
||||
#define LIBAVFILTER_VERSION_MAJOR 6
|
||||
#define LIBAVFILTER_VERSION_MINOR 69
|
||||
#define LIBAVFILTER_VERSION_MINOR 70
|
||||
#define LIBAVFILTER_VERSION_MICRO 100
|
||||
|
||||
#define LIBAVFILTER_VERSION_INT AV_VERSION_INT(LIBAVFILTER_VERSION_MAJOR, \
|
||||
|
268
libavfilter/vf_readeia608.c
Normal file
268
libavfilter/vf_readeia608.c
Normal file
@ -0,0 +1,268 @@
|
||||
/*
|
||||
* Copyright (c) 2017 Paul B Mahol
|
||||
*
|
||||
* This file is part of FFmpeg.
|
||||
*
|
||||
* FFmpeg is free software; you can redistribute it and/or
|
||||
* modify it under the terms of the GNU Lesser General Public
|
||||
* License as published by the Free Software Foundation; either
|
||||
* version 2.1 of the License, or (at your option) any later version.
|
||||
*
|
||||
* FFmpeg is distributed in the hope that it will be useful,
|
||||
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
||||
* Lesser General Public License for more details.
|
||||
*
|
||||
* You should have received a copy of the GNU Lesser General Public
|
||||
* License along with FFmpeg; if not, write to the Free Software
|
||||
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
|
||||
*/
|
||||
|
||||
/**
|
||||
* @file
|
||||
* Filter for reading closed captioning data (EIA-608).
|
||||
* See also https://en.wikipedia.org/wiki/EIA-608
|
||||
*/
|
||||
|
||||
#include <string.h>
|
||||
|
||||
#include "libavutil/internal.h"
|
||||
#include "libavutil/opt.h"
|
||||
#include "libavutil/pixdesc.h"
|
||||
#include "libavutil/timestamp.h"
|
||||
|
||||
#include "avfilter.h"
|
||||
#include "formats.h"
|
||||
#include "internal.h"
|
||||
#include "video.h"
|
||||
|
||||
#define FALL 0
|
||||
#define RISE 1
|
||||
|
||||
typedef struct ReadEIA608Context {
|
||||
const AVClass *class;
|
||||
int start, end;
|
||||
int min_range;
|
||||
int max_peak_diff;
|
||||
int max_period_diff;
|
||||
int max_start_diff;
|
||||
int nb_found;
|
||||
int white;
|
||||
int black;
|
||||
float mpd, mhd, msd, mac, spw, bhd, wth, bth;
|
||||
int chp;
|
||||
} ReadEIA608Context;
|
||||
|
||||
#define OFFSET(x) offsetof(ReadEIA608Context, x)
|
||||
#define FLAGS AV_OPT_FLAG_VIDEO_PARAM|AV_OPT_FLAG_FILTERING_PARAM
|
||||
|
||||
static const AVOption readeia608_options[] = {
|
||||
{ "scan_min", "set from which line to scan for codes", OFFSET(start), AV_OPT_TYPE_INT, {.i64=0}, 0, INT_MAX, FLAGS },
|
||||
{ "scan_max", "set to which line to scan for codes", OFFSET(end), AV_OPT_TYPE_INT, {.i64=29}, 0, INT_MAX, FLAGS },
|
||||
{ "mac", "set minimal acceptable amplitude change for sync codes detection", OFFSET(mac), AV_OPT_TYPE_FLOAT, {.dbl=.2}, 0.001, 1, FLAGS },
|
||||
{ "spw", "set ratio of width reserved for sync code detection", OFFSET(spw), AV_OPT_TYPE_FLOAT, {.dbl=.27}, 0.1, 0.7, FLAGS },
|
||||
{ "mhd", "set max peaks height difference for sync code detection", OFFSET(mhd), AV_OPT_TYPE_FLOAT, {.dbl=.1}, 0, 0.5, FLAGS },
|
||||
{ "mpd", "set max peaks period difference for sync code detection", OFFSET(mpd), AV_OPT_TYPE_FLOAT, {.dbl=.1}, 0, 0.5, FLAGS },
|
||||
{ "msd", "set first two max start code bits differences", OFFSET(msd), AV_OPT_TYPE_FLOAT, {.dbl=.02}, 0, 0.5, FLAGS },
|
||||
{ "bhd", "set min ratio of bits height compared to 3rd start code bit", OFFSET(bhd), AV_OPT_TYPE_FLOAT, {.dbl=.75}, 0.01, 1, FLAGS },
|
||||
{ "th_w", "set white color threshold", OFFSET(wth), AV_OPT_TYPE_FLOAT, {.dbl=.35}, 0.1, 1, FLAGS },
|
||||
{ "th_b", "set black color threshold", OFFSET(bth), AV_OPT_TYPE_FLOAT, {.dbl=.15}, 0, 0.5, FLAGS },
|
||||
{ "chp", "check and apply parity bit", OFFSET(chp), AV_OPT_TYPE_BOOL, {.i64= 0}, 0, 1, FLAGS },
|
||||
{ NULL }
|
||||
};
|
||||
|
||||
AVFILTER_DEFINE_CLASS(readeia608);
|
||||
|
||||
static int query_formats(AVFilterContext *ctx)
|
||||
{
|
||||
static const enum AVPixelFormat pixel_fmts[] = {
|
||||
AV_PIX_FMT_GRAY8,
|
||||
AV_PIX_FMT_YUV410P, AV_PIX_FMT_YUV411P,
|
||||
AV_PIX_FMT_YUV420P, AV_PIX_FMT_YUV422P,
|
||||
AV_PIX_FMT_YUV440P, AV_PIX_FMT_YUV444P,
|
||||
AV_PIX_FMT_YUVJ420P, AV_PIX_FMT_YUVJ422P,
|
||||
AV_PIX_FMT_YUVJ440P, AV_PIX_FMT_YUVJ444P,
|
||||
AV_PIX_FMT_YUVJ411P,
|
||||
AV_PIX_FMT_NONE
|
||||
};
|
||||
AVFilterFormats *formats = ff_make_format_list(pixel_fmts);
|
||||
if (!formats)
|
||||
return AVERROR(ENOMEM);
|
||||
return ff_set_common_formats(ctx, formats);
|
||||
}
|
||||
|
||||
static int config_input(AVFilterLink *inlink)
|
||||
{
|
||||
const AVPixFmtDescriptor *desc = av_pix_fmt_desc_get(inlink->format);
|
||||
AVFilterContext *ctx = inlink->dst;
|
||||
ReadEIA608Context *s = ctx->priv;
|
||||
int depth = desc->comp[0].depth;
|
||||
|
||||
if (s->end >= inlink->h) {
|
||||
av_log(ctx, AV_LOG_WARNING, "Last line to scan too large, clipping.\n");
|
||||
s->end = inlink->h - 1;
|
||||
}
|
||||
|
||||
if (s->start > s->end) {
|
||||
av_log(ctx, AV_LOG_ERROR, "Invalid range.\n");
|
||||
return AVERROR(EINVAL);
|
||||
}
|
||||
|
||||
s->min_range = s->mac * ((1 << depth) - 1);
|
||||
s->max_peak_diff = s->mhd * ((1 << depth) - 1);
|
||||
s->max_period_diff = s->mpd * ((1 << depth) - 1);
|
||||
s->max_start_diff = s->msd * ((1 << depth) - 1);
|
||||
s->white = s->wth * ((1 << depth) - 1);
|
||||
s->black = s->bth * ((1 << depth) - 1);
|
||||
|
||||
return 0;
|
||||
}
|
||||
|
||||
static void extract_line(AVFilterContext *ctx, AVFilterLink *inlink, AVFrame *in, int line)
|
||||
{
|
||||
ReadEIA608Context *s = ctx->priv;
|
||||
int max = 0, min = INT_MAX;
|
||||
int i, ch, range = 0;
|
||||
const uint8_t *src;
|
||||
uint16_t clock[8][2] = { { 0 } };
|
||||
const int sync_width = s->spw * in->width;
|
||||
int last = 0, peaks = 0, max_peak_diff = 0, dir = RISE;
|
||||
const int width_per_bit = (in->width - sync_width) / 19;
|
||||
uint8_t byte[2] = { 0 };
|
||||
int s1, s2, s3, parity;
|
||||
|
||||
src = &in->data[0][line * in->linesize[0]];
|
||||
for (i = 0; i < sync_width; i++) {
|
||||
max = FFMAX(max, src[i]);
|
||||
min = FFMIN(min, src[i]);
|
||||
}
|
||||
|
||||
range = max - min;
|
||||
if (range < s->min_range)
|
||||
return;
|
||||
|
||||
for (i = 0; i < sync_width; i++) {
|
||||
int Y = src[i];
|
||||
|
||||
if (dir == RISE) {
|
||||
if (Y < last) {
|
||||
dir = FALL;
|
||||
if (last >= s->white) {
|
||||
clock[peaks][0] = last;
|
||||
clock[peaks][1] = i;
|
||||
peaks++;
|
||||
if (peaks > 7)
|
||||
break;
|
||||
}
|
||||
}
|
||||
} else if (dir == FALL) {
|
||||
if (Y > last && last <= s->black) {
|
||||
dir = RISE;
|
||||
}
|
||||
}
|
||||
last = Y;
|
||||
}
|
||||
|
||||
if (peaks != 7)
|
||||
return;
|
||||
|
||||
for (i = 1; i < 7; i++)
|
||||
max_peak_diff = FFMAX(max_peak_diff, FFABS(clock[i][0] - clock[i-1][0]));
|
||||
|
||||
if (max_peak_diff > s->max_peak_diff)
|
||||
return;
|
||||
|
||||
max = 0; min = INT_MAX;
|
||||
for (i = 1; i < 7; i++) {
|
||||
max = FFMAX(max, FFABS(clock[i][1] - clock[i-1][1]));
|
||||
min = FFMIN(min, FFABS(clock[i][1] - clock[i-1][1]));
|
||||
}
|
||||
|
||||
range = max - min;
|
||||
if (range > s->max_period_diff)
|
||||
return;
|
||||
|
||||
s1 = src[sync_width + width_per_bit * 0 + width_per_bit / 2];
|
||||
s2 = src[sync_width + width_per_bit * 1 + width_per_bit / 2];
|
||||
s3 = src[sync_width + width_per_bit * 2 + width_per_bit / 2];
|
||||
|
||||
if (FFABS(s1 - s2) > s->max_start_diff || s1 > s->black || s2 > s->black || s3 < s->white)
|
||||
return;
|
||||
|
||||
for (ch = 0; ch < 2; ch++) {
|
||||
for (parity = 0, i = 0; i < 8; i++) {
|
||||
int b = src[sync_width + width_per_bit * (i + 3 + 8 * ch) + width_per_bit / 2];
|
||||
|
||||
if (b - s1 > (s3 - s1) * s->bhd) {
|
||||
b = 1;
|
||||
parity++;
|
||||
} else {
|
||||
b = 0;
|
||||
}
|
||||
byte[ch] |= b << i;
|
||||
}
|
||||
|
||||
if (s->chp) {
|
||||
if (!(parity & 1)) {
|
||||
byte[ch] = 0;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
{
|
||||
uint8_t key[128], value[128];
|
||||
|
||||
snprintf(key, sizeof(key), "lavfi.readeia608.%d.cc", s->nb_found);
|
||||
snprintf(value, sizeof(value), "0x%02X%02X", byte[0], byte[1]);
|
||||
av_dict_set(avpriv_frame_get_metadatap(in), key, value, 0);
|
||||
|
||||
snprintf(key, sizeof(key), "lavfi.readeia608.%d.line", s->nb_found);
|
||||
snprintf(value, sizeof(value), "%d", line);
|
||||
av_dict_set(avpriv_frame_get_metadatap(in), key, value, 0);
|
||||
}
|
||||
|
||||
s->nb_found++;
|
||||
}
|
||||
|
||||
static int filter_frame(AVFilterLink *inlink, AVFrame *in)
|
||||
{
|
||||
AVFilterContext *ctx = inlink->dst;
|
||||
AVFilterLink *outlink = ctx->outputs[0];
|
||||
ReadEIA608Context *s = ctx->priv;
|
||||
int i;
|
||||
|
||||
s->nb_found = 0;
|
||||
for (i = s->start; i <= s->end; i++)
|
||||
extract_line(ctx, inlink, in, i);
|
||||
|
||||
return ff_filter_frame(outlink, in);
|
||||
}
|
||||
|
||||
static const AVFilterPad readeia608_inputs[] = {
|
||||
{
|
||||
.name = "default",
|
||||
.type = AVMEDIA_TYPE_VIDEO,
|
||||
.filter_frame = filter_frame,
|
||||
.config_props = config_input,
|
||||
},
|
||||
{ NULL }
|
||||
};
|
||||
|
||||
static const AVFilterPad readeia608_outputs[] = {
|
||||
{
|
||||
.name = "default",
|
||||
.type = AVMEDIA_TYPE_VIDEO,
|
||||
},
|
||||
{ NULL }
|
||||
};
|
||||
|
||||
AVFilter ff_vf_readeia608 = {
|
||||
.name = "readeia608",
|
||||
.description = NULL_IF_CONFIG_SMALL("Read EIA-608 Closed Caption codes from input video and write them to frame metadata."),
|
||||
.priv_size = sizeof(ReadEIA608Context),
|
||||
.priv_class = &readeia608_class,
|
||||
.query_formats = query_formats,
|
||||
.inputs = readeia608_inputs,
|
||||
.outputs = readeia608_outputs,
|
||||
.flags = AVFILTER_FLAG_SUPPORT_TIMELINE_GENERIC,
|
||||
};
|
Loading…
Reference in New Issue
Block a user