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"
Include dependency graph for vf_thumbnail.c:

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 avfilter_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

Definition at line 50 of file vf_thumbnail.c.

#define HIST_SIZE   (3*256)

Definition at line 34 of file vf_thumbnail.c.

Referenced by frame_sum_square_err(), and get_best_frame().

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

Definition at line 49 of file vf_thumbnail.c.

Function Documentation

AVFILTER_DEFINE_CLASS ( thumbnail  )
static int config_props ( AVFilterLink inlink)
static

Definition at line 191 of file vf_thumbnail.c.

static int filter_frame ( AVFilterLink inlink,
AVFrame frame 
)
static

Definition at line 131 of file vf_thumbnail.c.

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().

static AVFrame* get_best_frame ( AVFilterContext ctx)
static

Definition at line 91 of file vf_thumbnail.c.

Referenced by filter_frame(), and request_frame().

static av_cold int init ( AVFilterContext ctx)
static

Definition at line 59 of file vf_thumbnail.c.

static int query_formats ( AVFilterContext ctx)
static

Definition at line 200 of file vf_thumbnail.c.

static int request_frame ( AVFilterLink link)
static

Definition at line 170 of file vf_thumbnail.c.

static av_cold void uninit ( AVFilterContext ctx)
static

Definition at line 161 of file vf_thumbnail.c.

Variable Documentation

AVFilter avfilter_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 const AVFilterPad outputs[]
Definition: af_ashowinfo.c:117
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. ...
static const AVFilterPad thumbnail_outputs[]
Definition: vf_thumbnail.c:221
static int query_formats(AVFilterContext *ctx)
Definition: vf_thumbnail.c:200
static av_cold void uninit(AVFilterContext *ctx)
Definition: vf_thumbnail.c:161
these buffered frames must be flushed immediately if a new input produces new the filter must not call request_frame to get more It must just process the frame or queue it The task of requesting more frames is left to the filter s request_frame method or the application If a filter has several inputs
static const AVFilterPad thumbnail_inputs[]
Definition: vf_thumbnail.c:210

Definition at line 230 of file vf_thumbnail.c.

const AVFilterPad thumbnail_inputs[]
static
Initial value:
= {
{
.name = "default",
.config_props = config_props,
.get_video_buffer = ff_null_get_video_buffer,
.filter_frame = filter_frame,
},
{ NULL }
}
AVFrame * ff_null_get_video_buffer(AVFilterLink *link, int w, int h)
Definition: video.c:35
NULL
Definition: eval.c:55
static int config_props(AVFilterLink *inlink)
Definition: vf_thumbnail.c:191
static int filter_frame(AVFilterLink *inlink, AVFrame *frame)
Definition: vf_thumbnail.c:131

Definition at line 210 of file vf_thumbnail.c.

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 OFFSET(x)
Definition: vf_thumbnail.c:49
#define FLAGS
Definition: vf_thumbnail.c:50
NULL
Definition: eval.c:55

Definition at line 52 of file vf_thumbnail.c.

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

Definition at line 221 of file vf_thumbnail.c.