FFmpeg
Data Structures | Macros | Functions | Variables
vf_codecview.c File Reference
#include "libavutil/imgutils.h"
#include "libavutil/motion_vector.h"
#include "libavutil/opt.h"
#include "libavutil/video_enc_params.h"
#include "avfilter.h"
#include "qp_table.h"
#include "internal.h"
#include "video.h"

Go to the source code of this file.

Data Structures

struct  CodecViewContext
 

Macros

#define MV_P_FOR   (1<<0)
 
#define MV_B_FOR   (1<<1)
 
#define MV_B_BACK   (1<<2)
 
#define MV_TYPE_FOR   (1<<0)
 
#define MV_TYPE_BACK   (1<<1)
 
#define FRAME_TYPE_I   (1<<0)
 
#define FRAME_TYPE_P   (1<<1)
 
#define FRAME_TYPE_B   (1<<2)
 
#define OFFSET(x)   offsetof(CodecViewContext, x)
 
#define FLAGS   AV_OPT_FLAG_FILTERING_PARAM|AV_OPT_FLAG_VIDEO_PARAM
 
#define CONST(name, help, val, u)   { name, help, 0, AV_OPT_TYPE_CONST, {.i64=val}, 0, 0, FLAGS, .unit = u }
 

Functions

 AVFILTER_DEFINE_CLASS (codecview)
 
static int clip_line (int *sx, int *sy, int *ex, int *ey, int maxx)
 
static void draw_line (uint8_t *buf, int sx, int sy, int ex, int ey, int w, int h, ptrdiff_t stride, int color)
 Draw a line from (ex, ey) -> (sx, sy). More...
 
static void draw_arrow (uint8_t *buf, int sx, int sy, int ex, int ey, int w, int h, ptrdiff_t stride, int color, int tail, int direction)
 Draw an arrow from (ex, ey) -> (sx, sy). More...
 
static void draw_block_rectangle (uint8_t *buf, int sx, int sy, int w, int h, ptrdiff_t stride, int color)
 
static int filter_frame (AVFilterLink *inlink, AVFrame *frame)
 
static int config_input (AVFilterLink *inlink)
 

Variables

static const AVOption codecview_options []
 
static const AVFilterPad codecview_inputs []
 
const AVFilter ff_vf_codecview
 

Detailed Description

Codec debug viewer filter.

All the MV drawing code from Michael Niedermayer is extracted from libavcodec/mpegvideo.c.

TODO: segmentation

Definition in file vf_codecview.c.

Macro Definition Documentation

◆ MV_P_FOR

#define MV_P_FOR   (1<<0)

Definition at line 41 of file vf_codecview.c.

◆ MV_B_FOR

#define MV_B_FOR   (1<<1)

Definition at line 42 of file vf_codecview.c.

◆ MV_B_BACK

#define MV_B_BACK   (1<<2)

Definition at line 43 of file vf_codecview.c.

◆ MV_TYPE_FOR

#define MV_TYPE_FOR   (1<<0)

Definition at line 44 of file vf_codecview.c.

◆ MV_TYPE_BACK

#define MV_TYPE_BACK   (1<<1)

Definition at line 45 of file vf_codecview.c.

◆ FRAME_TYPE_I

#define FRAME_TYPE_I   (1<<0)

Definition at line 46 of file vf_codecview.c.

◆ FRAME_TYPE_P

#define FRAME_TYPE_P   (1<<1)

Definition at line 47 of file vf_codecview.c.

◆ FRAME_TYPE_B

#define FRAME_TYPE_B   (1<<2)

Definition at line 48 of file vf_codecview.c.

◆ OFFSET

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

Definition at line 60 of file vf_codecview.c.

◆ FLAGS

Definition at line 61 of file vf_codecview.c.

◆ CONST

#define CONST (   name,
  help,
  val,
  u 
)    { name, help, 0, AV_OPT_TYPE_CONST, {.i64=val}, 0, 0, FLAGS, .unit = u }

Definition at line 62 of file vf_codecview.c.

Function Documentation

◆ AVFILTER_DEFINE_CLASS()

AVFILTER_DEFINE_CLASS ( codecview  )

◆ clip_line()

static int clip_line ( int sx,
int sy,
int ex,
int ey,
int  maxx 
)
static

Definition at line 85 of file vf_codecview.c.

Referenced by draw_line().

◆ draw_line()

static void draw_line ( uint8_t *  buf,
int  sx,
int  sy,
int  ex,
int  ey,
int  w,
int  h,
ptrdiff_t  stride,
int  color 
)
static

Draw a line from (ex, ey) -> (sx, sy).

Parameters
wwidth of the image
hheight of the image
stridestride/linesize of the image
colorcolor of the arrow

Definition at line 113 of file vf_codecview.c.

Referenced by draw_arrow().

◆ draw_arrow()

static void draw_arrow ( uint8_t *  buf,
int  sx,
int  sy,
int  ex,
int  ey,
int  w,
int  h,
ptrdiff_t  stride,
int  color,
int  tail,
int  direction 
)
static

Draw an arrow from (ex, ey) -> (sx, sy).

Parameters
wwidth of the image
hheight of the image
stridestride/linesize of the image
colorcolor of the arrow

Definition at line 171 of file vf_codecview.c.

Referenced by filter_frame().

◆ draw_block_rectangle()

static void draw_block_rectangle ( uint8_t *  buf,
int  sx,
int  sy,
int  w,
int  h,
ptrdiff_t  stride,
int  color 
)
static

Definition at line 209 of file vf_codecview.c.

Referenced by filter_frame().

◆ filter_frame()

static int filter_frame ( AVFilterLink inlink,
AVFrame frame 
)
static

Definition at line 221 of file vf_codecview.c.

◆ config_input()

static int config_input ( AVFilterLink inlink)
static

Definition at line 314 of file vf_codecview.c.

Variable Documentation

◆ codecview_options

const AVOption codecview_options[]
static
Initial value:
= {
{ "mv", "set motion vectors to visualize", OFFSET(mv), AV_OPT_TYPE_FLAGS, {.i64=0}, 0, INT_MAX, FLAGS, .unit = "mv" },
CONST("pf", "forward predicted MVs of P-frames", MV_P_FOR, "mv"),
CONST("bf", "forward predicted MVs of B-frames", MV_B_FOR, "mv"),
CONST("bb", "backward predicted MVs of B-frames", MV_B_BACK, "mv"),
{ "qp", NULL, OFFSET(qp), AV_OPT_TYPE_BOOL, {.i64=0}, 0, 1, .flags = FLAGS },
{ "mv_type", "set motion vectors type", OFFSET(mv_type), AV_OPT_TYPE_FLAGS, {.i64=0}, 0, INT_MAX, FLAGS, .unit = "mv_type" },
{ "mvt", "set motion vectors type", OFFSET(mv_type), AV_OPT_TYPE_FLAGS, {.i64=0}, 0, INT_MAX, FLAGS, .unit = "mv_type" },
CONST("fp", "forward predicted MVs", MV_TYPE_FOR, "mv_type"),
CONST("bp", "backward predicted MVs", MV_TYPE_BACK, "mv_type"),
{ "frame_type", "set frame types to visualize motion vectors of", OFFSET(frame_type), AV_OPT_TYPE_FLAGS, {.i64=0}, 0, INT_MAX, FLAGS, .unit = "frame_type" },
{ "ft", "set frame types to visualize motion vectors of", OFFSET(frame_type), AV_OPT_TYPE_FLAGS, {.i64=0}, 0, INT_MAX, FLAGS, .unit = "frame_type" },
CONST("if", "I-frames", FRAME_TYPE_I, "frame_type"),
CONST("pf", "P-frames", FRAME_TYPE_P, "frame_type"),
CONST("bf", "B-frames", FRAME_TYPE_B, "frame_type"),
{ "block", "set block partitioning structure to visualize", OFFSET(block), AV_OPT_TYPE_BOOL, {.i64=0}, 0, 1, FLAGS },
{ NULL }
}

Definition at line 64 of file vf_codecview.c.

◆ codecview_inputs

const AVFilterPad codecview_inputs[]
static
Initial value:
= {
{
.name = "default",
.filter_frame = filter_frame,
.config_props = config_input,
},
}

Definition at line 325 of file vf_codecview.c.

◆ ff_vf_codecview

const AVFilter ff_vf_codecview
Initial value:
= {
.name = "codecview",
.description = NULL_IF_CONFIG_SMALL("Visualize information about some codecs."),
.priv_size = sizeof(CodecViewContext),
.priv_class = &codecview_class,
}

Definition at line 335 of file vf_codecview.c.

MV_B_FOR
#define MV_B_FOR
Definition: vf_codecview.c:42
mv
static const int8_t mv[256][2]
Definition: 4xm.c:80
MV_P_FOR
#define MV_P_FOR
Definition: vf_codecview.c:41
OFFSET
#define OFFSET(x)
Definition: vf_codecview.c:60
CONST
#define CONST(name, help, val, u)
Definition: vf_codecview.c:62
ff_video_default_filterpad
const AVFilterPad ff_video_default_filterpad[1]
An AVFilterPad array whose only entry has name "default" and is of type AVMEDIA_TYPE_VIDEO.
Definition: video.c:37
AV_PIX_FMT_YUV420P
@ AV_PIX_FMT_YUV420P
planar YUV 4:2:0, 12bpp, (1 Cr & Cb sample per 2x2 Y samples)
Definition: pixfmt.h:73
FILTER_INPUTS
#define FILTER_INPUTS(array)
Definition: internal.h:182
codecview_inputs
static const AVFilterPad codecview_inputs[]
Definition: vf_codecview.c:325
NULL
#define NULL
Definition: coverity.c:32
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:106
MV_B_BACK
#define MV_B_BACK
Definition: vf_codecview.c:43
CodecViewContext
Definition: vf_codecview.c:50
FRAME_TYPE_I
#define FRAME_TYPE_I
Definition: vf_codecview.c:46
AVFILTER_FLAG_SUPPORT_TIMELINE_GENERIC
#define AVFILTER_FLAG_SUPPORT_TIMELINE_GENERIC
Some filters support a generic "enable" expression option that can be used to enable or disable a fil...
Definition: avfilter.h:147
FILTER_SINGLE_PIXFMT
#define FILTER_SINGLE_PIXFMT(pix_fmt_)
Definition: internal.h:172
frame_type
frame_type
Definition: jpeg2000_parser.c:31
FRAME_TYPE_B
#define FRAME_TYPE_B
Definition: vf_codecview.c:48
filter_frame
static int filter_frame(AVFilterLink *inlink, AVFrame *frame)
Definition: vf_codecview.c:221
FLAGS
#define FLAGS
Definition: vf_codecview.c:61
AVMEDIA_TYPE_VIDEO
@ AVMEDIA_TYPE_VIDEO
Definition: avutil.h:201
MV_TYPE_FOR
#define MV_TYPE_FOR
Definition: vf_codecview.c:44
MV_TYPE_BACK
#define MV_TYPE_BACK
Definition: vf_codecview.c:45
AV_OPT_TYPE_BOOL
@ AV_OPT_TYPE_BOOL
Definition: opt.h:251
FILTER_OUTPUTS
#define FILTER_OUTPUTS(array)
Definition: internal.h:183
AV_OPT_TYPE_FLAGS
@ AV_OPT_TYPE_FLAGS
Definition: opt.h:234
block
The exact code depends on how similar the blocks are and how related they are to the block
Definition: filter_design.txt:207
config_input
static int config_input(AVFilterLink *inlink)
Definition: vf_codecview.c:314
FRAME_TYPE_P
#define FRAME_TYPE_P
Definition: vf_codecview.c:47
AVFILTERPAD_FLAG_NEEDS_WRITABLE
#define AVFILTERPAD_FLAG_NEEDS_WRITABLE
The filter expects writable frames from its input link, duplicating data buffers if needed.
Definition: internal.h:52