vf_showinfo.c
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2011 Stefano Sabatini
3  * This file is part of FFmpeg.
4  *
5  * FFmpeg is free software; you can redistribute it and/or
6  * modify it under the terms of the GNU Lesser General Public
7  * License as published by the Free Software Foundation; either
8  * version 2.1 of the License, or (at your option) any later version.
9  *
10  * FFmpeg is distributed in the hope that it will be useful,
11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13  * Lesser General Public License for more details.
14  *
15  * You should have received a copy of the GNU Lesser General Public
16  * License along with FFmpeg; if not, write to the Free Software
17  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
18  */
19 
20 /**
21  * @file
22  * filter for showing textual video frame information
23  */
24 
25 #include "libavutil/adler32.h"
26 #include "libavutil/imgutils.h"
27 #include "libavutil/internal.h"
28 #include "libavutil/pixdesc.h"
29 #include "libavutil/timestamp.h"
30 #include "avfilter.h"
31 #include "internal.h"
32 #include "video.h"
33 
34 typedef struct {
35  unsigned int frame;
37 
38 static int filter_frame(AVFilterLink *inlink, AVFrame *frame)
39 {
40  AVFilterContext *ctx = inlink->dst;
41  ShowInfoContext *showinfo = ctx->priv;
42  const AVPixFmtDescriptor *desc = av_pix_fmt_desc_get(inlink->format);
43  uint32_t plane_checksum[4] = {0}, checksum = 0;
44  int i, plane, vsub = desc->log2_chroma_h;
45 
46  for (plane = 0; plane < 4 && frame->data[plane]; plane++) {
47  int64_t linesize = av_image_get_linesize(frame->format, frame->width, plane);
48  uint8_t *data = frame->data[plane];
49  int h = plane == 1 || plane == 2 ? inlink->h >> vsub : inlink->h;
50 
51  if (linesize < 0)
52  return linesize;
53 
54  for (i = 0; i < h; i++) {
55  plane_checksum[plane] = av_adler32_update(plane_checksum[plane], data, linesize);
56  checksum = av_adler32_update(checksum, data, linesize);
57  data += frame->linesize[plane];
58  }
59  }
60 
61  av_log(ctx, AV_LOG_INFO,
62  "n:%d pts:%s pts_time:%s pos:%"PRId64" "
63  "fmt:%s sar:%d/%d s:%dx%d i:%c iskey:%d type:%c "
64  "checksum:%08X plane_checksum:[%08X",
65  showinfo->frame,
66  av_ts2str(frame->pts), av_ts2timestr(frame->pts, &inlink->time_base), av_frame_get_pkt_pos(frame),
67  desc->name,
69  frame->width, frame->height,
70  !frame->interlaced_frame ? 'P' : /* Progressive */
71  frame->top_field_first ? 'T' : 'B', /* Top / Bottom */
72  frame->key_frame,
74  checksum, plane_checksum[0]);
75 
76  for (plane = 1; plane < 4 && frame->data[plane]; plane++)
77  av_log(ctx, AV_LOG_INFO, " %08X", plane_checksum[plane]);
78  av_log(ctx, AV_LOG_INFO, "]\n");
79 
80  showinfo->frame++;
81  return ff_filter_frame(inlink->dst->outputs[0], frame);
82 }
83 
85  {
86  .name = "default",
87  .type = AVMEDIA_TYPE_VIDEO,
88  .get_video_buffer = ff_null_get_video_buffer,
89  .filter_frame = filter_frame,
90  },
91  { NULL }
92 };
93 
95  {
96  .name = "default",
97  .type = AVMEDIA_TYPE_VIDEO
98  },
99  { NULL }
100 };
101 
103  .name = "showinfo",
104  .description = NULL_IF_CONFIG_SMALL("Show textual information for each video frame."),
105 
106  .priv_size = sizeof(ShowInfoContext),
107 
108  .inputs = avfilter_vf_showinfo_inputs,
109 
110  .outputs = avfilter_vf_showinfo_outputs,
111 };
int av_image_get_linesize(enum AVPixelFormat pix_fmt, int width, int plane)
Compute the size of an image line with format pix_fmt and width width for the plane plane...
Definition: imgutils.c:73
const AVPixFmtDescriptor * av_pix_fmt_desc_get(enum AVPixelFormat pix_fmt)
Definition: pixdesc.c:1778
This structure describes decoded (raw) audio or video data.
Definition: frame.h:76
misc image utilities
static const AVFilterPad outputs[]
Definition: af_ashowinfo.c:117
external API header
AVFilter avfilter_vf_showinfo
Definition: vf_showinfo.c:102
int num
numerator
Definition: rational.h:44
AVFrame * ff_null_get_video_buffer(AVFilterLink *link, int w, int h)
Definition: video.c:35
static const AVFilterPad avfilter_vf_showinfo_inputs[]
Definition: vf_showinfo.c:84
static int filter_frame(AVFilterLink *inlink, AVFrame *frame)
Definition: vf_showinfo.c:38
const char * name
Pad name.
uint8_t
it can be given away to ff_start_frame *A reference passed to ff_filter_frame(or the deprecated ff_start_frame) is given away and must no longer be used.*A reference created with avfilter_ref_buffer belongs to the code that created it.*A reference obtained with ff_get_video_buffer or ff_get_audio_buffer belongs to the code that requested it.*A reference given as return value by the get_video_buffer or get_audio_buffer method is given away and must no longer be used.Link reference fields---------------------The AVFilterLink structure has a few AVFilterBufferRef fields.The cur_buf and out_buf were used with the deprecated start_frame/draw_slice/end_frame API and should no longer be used.src_buf
timestamp utils, mostly useful for debugging/logging purposes
int64_t pts
Presentation timestamp in time_base units (time when frame should be shown to user).
Definition: frame.h:159
unsigned int frame
Definition: vf_showinfo.c:35
char av_get_picture_type_char(enum AVPictureType pict_type)
Return a single letter to describe the given picture type pict_type.
unsigned long av_adler32_update(unsigned long adler, const uint8_t *buf, unsigned int len)
Calculate the Adler32 checksum of a buffer.
Definition: adler32.c:35
int interlaced_frame
The content of the picture is interlaced.
Definition: frame.h:270
const char * name
Definition: pixdesc.h:56
frame
Definition: stft.m:14
A filter pad used for either input or output.
int width
width and height of the video frame
Definition: frame.h:122
uint8_t log2_chroma_h
Amount to shift the luma height right to find the chroma height.
Definition: pixdesc.h:75
#define av_ts2timestr(ts, tb)
Convenience macro, the return value should be used only directly in function arguments but never stan...
Definition: timestamp.h:72
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification. ...
Spectrum Plot time data
void * priv
private data for use by the filter
Definition: avfilter.h:545
void av_log(void *avcl, int level, const char *fmt,...)
Definition: log.c:246
common internal API header
enum AVPictureType pict_type
Picture type of the frame.
Definition: frame.h:144
int format
format of the frame, -1 if unknown or unset Values correspond to enum AVPixelFormat for video frames...
Definition: frame.h:134
NULL
Definition: eval.c:55
int linesize[AV_NUM_DATA_POINTERS]
For video, size in bytes of each picture line.
Definition: frame.h:101
Descriptor that unambiguously describes how the bits of a pixel are stored in the up to 4 data planes...
Definition: pixdesc.h:55
AVRational sample_aspect_ratio
Sample aspect ratio for the video frame, 0/1 if unknown/unspecified.
Definition: frame.h:154
static const AVFilterPad avfilter_vf_showinfo_outputs[]
Definition: vf_showinfo.c:94
Filter definition.
Definition: avfilter.h:436
synthesis window for stochastic i
const char * name
filter name
Definition: avfilter.h:437
AVFilterLink ** outputs
array of pointers to output links
Definition: avfilter.h:539
uint8_t * data[AV_NUM_DATA_POINTERS]
pointer to the picture/channel planes.
Definition: frame.h:87
int den
denominator
Definition: rational.h:45
int top_field_first
If the content is interlaced, is top field displayed first.
Definition: frame.h:275
#define av_ts2str(ts)
Convenience macro, the return value should be used only directly in function arguments but never stan...
Definition: timestamp.h:50
int key_frame
1 -> keyframe, 0-> not
Definition: frame.h:139
int64_t av_frame_get_pkt_pos(const AVFrame *frame)
An instance of a filter.
Definition: avfilter.h:524
int height
Definition: frame.h:122
#define AV_LOG_INFO
Definition: log.h:156
internal API functions
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