FFmpeg  4.0
Data Structures | Macros | Functions | Variables
vf_thumbnail.c File Reference

Potential thumbnail lookup filter to reduce the risk of an inappropriate selection (such as a black frame) we could get with an absolute seek. More...

#include "libavutil/opt.h"
#include "avfilter.h"
#include "internal.h"

Go to the source code of this file.

Data Structures

struct  thumb_frame
 
struct  ThumbContext
 

Macros

#define HIST_SIZE   (3*256)
 
#define OFFSET(x)   offsetof(ThumbContext, x)
 
#define FLAGS   AV_OPT_FLAG_VIDEO_PARAM|AV_OPT_FLAG_FILTERING_PARAM
 

Functions

 AVFILTER_DEFINE_CLASS (thumbnail)
 
static av_cold int init (AVFilterContext *ctx)
 
static double frame_sum_square_err (const int *hist, const double *median)
 Compute Sum-square deviation to estimate "closeness". More...
 
static AVFrameget_best_frame (AVFilterContext *ctx)
 
static int filter_frame (AVFilterLink *inlink, AVFrame *frame)
 
static av_cold void uninit (AVFilterContext *ctx)
 
static int request_frame (AVFilterLink *link)
 
static int config_props (AVFilterLink *inlink)
 
static int query_formats (AVFilterContext *ctx)
 

Variables

static const AVOption thumbnail_options []
 
static const AVFilterPad thumbnail_inputs []
 
static const AVFilterPad thumbnail_outputs []
 
AVFilter ff_vf_thumbnail
 

Detailed Description

Potential thumbnail lookup filter to reduce the risk of an inappropriate selection (such as a black frame) we could get with an absolute seek.

Simplified version of algorithm by Vadim Zaliva lord@.nosp@m.croc.nosp@m.odile.nosp@m..org.

See also
http://notbrainsurgery.livejournal.com/29773.html

Definition in file vf_thumbnail.c.

Macro Definition Documentation

◆ HIST_SIZE

#define HIST_SIZE   (3*256)

Definition at line 34 of file vf_thumbnail.c.

Referenced by frame_sum_square_err(), and get_best_frame().

◆ OFFSET

#define OFFSET (   x)    offsetof(ThumbContext, x)

Definition at line 49 of file vf_thumbnail.c.

◆ FLAGS

Definition at line 50 of file vf_thumbnail.c.

Function Documentation

◆ AVFILTER_DEFINE_CLASS()

AVFILTER_DEFINE_CLASS ( thumbnail  )

◆ init()

static av_cold int init ( AVFilterContext ctx)
static

Definition at line 59 of file vf_thumbnail.c.

◆ frame_sum_square_err()

static double frame_sum_square_err ( const int hist,
const double *  median 
)
static

Compute Sum-square deviation to estimate "closeness".

Parameters
histcolor distribution histogram
medianaverage color distribution histogram
Returns
sum of squared errors

Definition at line 79 of file vf_thumbnail.c.

Referenced by get_best_frame().

◆ get_best_frame()

static AVFrame* get_best_frame ( AVFilterContext ctx)
static

Definition at line 91 of file vf_thumbnail.c.

Referenced by filter_frame(), and request_frame().

◆ filter_frame()

static int filter_frame ( AVFilterLink inlink,
AVFrame frame 
)
static

Definition at line 131 of file vf_thumbnail.c.

◆ uninit()

static av_cold void uninit ( AVFilterContext ctx)
static

Definition at line 161 of file vf_thumbnail.c.

◆ request_frame()

static int request_frame ( AVFilterLink link)
static

Definition at line 170 of file vf_thumbnail.c.

◆ config_props()

static int config_props ( AVFilterLink inlink)
static

Definition at line 187 of file vf_thumbnail.c.

◆ query_formats()

static int query_formats ( AVFilterContext ctx)
static

Definition at line 196 of file vf_thumbnail.c.

Variable Documentation

◆ thumbnail_options

const AVOption thumbnail_options[]
static
Initial value:
= {
{ "n", "set the frames batch size", OFFSET(n_frames), AV_OPT_TYPE_INT, {.i64=100}, 2, INT_MAX, FLAGS },
{ NULL }
}
#define NULL
Definition: coverity.c:32
#define OFFSET(x)
Definition: vf_thumbnail.c:49
#define FLAGS
Definition: vf_thumbnail.c:50

Definition at line 52 of file vf_thumbnail.c.

◆ thumbnail_inputs

const AVFilterPad thumbnail_inputs[]
static
Initial value:
= {
{
.name = "default",
.config_props = config_props,
.filter_frame = filter_frame,
},
{ NULL }
}
#define NULL
Definition: coverity.c:32
static int config_props(AVFilterLink *inlink)
Definition: vf_thumbnail.c:187
static int filter_frame(AVFilterLink *inlink, AVFrame *frame)
Definition: vf_thumbnail.c:131

Definition at line 208 of file vf_thumbnail.c.

◆ thumbnail_outputs

const AVFilterPad thumbnail_outputs[]
static
Initial value:
= {
{
.name = "default",
.request_frame = request_frame,
},
{ NULL }
}
#define NULL
Definition: coverity.c:32
static int request_frame(AVFilterLink *link)
Definition: vf_thumbnail.c:170

Definition at line 218 of file vf_thumbnail.c.

◆ ff_vf_thumbnail

AVFilter ff_vf_thumbnail
Initial value:
= {
.name = "thumbnail",
.description = NULL_IF_CONFIG_SMALL("Select the most representative frame in a given sequence of consecutive frames."),
.priv_size = sizeof(ThumbContext),
.init = init,
.priv_class = &thumbnail_class,
}
static av_cold int init(AVFilterContext *ctx)
Definition: vf_thumbnail.c:59
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification. ...
Definition: internal.h:186
static const AVFilterPad thumbnail_outputs[]
Definition: vf_thumbnail.c:218
static int query_formats(AVFilterContext *ctx)
Definition: vf_thumbnail.c:196
static const AVFilterPad inputs[]
Definition: af_acontrast.c:193
static const AVFilterPad outputs[]
Definition: af_acontrast.c:203
static av_cold void uninit(AVFilterContext *ctx)
Definition: vf_thumbnail.c:161
static const AVFilterPad thumbnail_inputs[]
Definition: vf_thumbnail.c:208

Definition at line 227 of file vf_thumbnail.c.