FFmpeg
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
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 <inttypes.h>
26 
27 #include "libavutil/adler32.h"
28 #include "libavutil/display.h"
29 #include "libavutil/imgutils.h"
30 #include "libavutil/internal.h"
31 #include "libavutil/pixdesc.h"
32 #include "libavutil/stereo3d.h"
33 #include "libavutil/timestamp.h"
34 
35 #include "avfilter.h"
36 #include "internal.h"
37 #include "video.h"
38 
40 {
41  AVStereo3D *stereo;
42 
43  av_log(ctx, AV_LOG_INFO, "stereoscopic information: ");
44  if (sd->size < sizeof(*stereo)) {
45  av_log(ctx, AV_LOG_INFO, "invalid data");
46  return;
47  }
48 
49  stereo = (AVStereo3D *)sd->data;
50 
51  av_log(ctx, AV_LOG_INFO, "type - ");
52  switch (stereo->type) {
53  case AV_STEREO3D_2D: av_log(ctx, AV_LOG_INFO, "2D"); break;
54  case AV_STEREO3D_SIDEBYSIDE: av_log(ctx, AV_LOG_INFO, "side by side"); break;
55  case AV_STEREO3D_TOPBOTTOM: av_log(ctx, AV_LOG_INFO, "top and bottom"); break;
56  case AV_STEREO3D_FRAMESEQUENCE: av_log(ctx, AV_LOG_INFO, "frame alternate"); break;
57  case AV_STEREO3D_CHECKERBOARD: av_log(ctx, AV_LOG_INFO, "checkerboard"); break;
58  case AV_STEREO3D_LINES: av_log(ctx, AV_LOG_INFO, "interleaved lines"); break;
59  case AV_STEREO3D_COLUMNS: av_log(ctx, AV_LOG_INFO, "interleaved columns"); break;
60  case AV_STEREO3D_SIDEBYSIDE_QUINCUNX: av_log(ctx, AV_LOG_INFO, "side by side "
61  "(quincunx subsampling)"); break;
62  default: av_log(ctx, AV_LOG_WARNING, "unknown"); break;
63  }
64 
65  if (stereo->flags & AV_STEREO3D_FLAG_INVERT)
66  av_log(ctx, AV_LOG_INFO, " (inverted)");
67 }
68 
69 static void update_sample_stats(const uint8_t *src, int len, int64_t *sum, int64_t *sum2)
70 {
71  int i;
72 
73  for (i = 0; i < len; i++) {
74  *sum += src[i];
75  *sum2 += src[i] * src[i];
76  }
77 }
78 
79 static int filter_frame(AVFilterLink *inlink, AVFrame *frame)
80 {
81  AVFilterContext *ctx = inlink->dst;
82  const AVPixFmtDescriptor *desc = av_pix_fmt_desc_get(inlink->format);
83  uint32_t plane_checksum[4] = {0}, checksum = 0;
84  int64_t sum[4] = {0}, sum2[4] = {0};
85  int32_t pixelcount[4] = {0};
86  int i, plane, vsub = desc->log2_chroma_h;
87 
88  for (plane = 0; plane < 4 && frame->data[plane] && frame->linesize[plane]; plane++) {
89  uint8_t *data = frame->data[plane];
90  int h = plane == 1 || plane == 2 ? FF_CEIL_RSHIFT(inlink->h, vsub) : inlink->h;
91  int linesize = av_image_get_linesize(frame->format, frame->width, plane);
92 
93  if (linesize < 0)
94  return linesize;
95 
96  for (i = 0; i < h; i++) {
97  plane_checksum[plane] = av_adler32_update(plane_checksum[plane], data, linesize);
98  checksum = av_adler32_update(checksum, data, linesize);
99 
100  update_sample_stats(data, linesize, sum+plane, sum2+plane);
101  pixelcount[plane] += linesize;
102  data += frame->linesize[plane];
103  }
104  }
105 
106  av_log(ctx, AV_LOG_INFO,
107  "n:%4"PRId64" pts:%7s pts_time:%-7s pos:%9"PRId64" "
108  "fmt:%s sar:%d/%d s:%dx%d i:%c iskey:%d type:%c "
109  "checksum:%08"PRIX32" plane_checksum:[%08"PRIX32,
110  inlink->frame_count,
111  av_ts2str(frame->pts), av_ts2timestr(frame->pts, &inlink->time_base), av_frame_get_pkt_pos(frame),
112  desc->name,
114  frame->width, frame->height,
115  !frame->interlaced_frame ? 'P' : /* Progressive */
116  frame->top_field_first ? 'T' : 'B', /* Top / Bottom */
117  frame->key_frame,
119  checksum, plane_checksum[0]);
120 
121  for (plane = 1; plane < 4 && frame->data[plane] && frame->linesize[plane]; plane++)
122  av_log(ctx, AV_LOG_INFO, " %08"PRIX32, plane_checksum[plane]);
123  av_log(ctx, AV_LOG_INFO, "] mean:[");
124  for (plane = 0; plane < 4 && frame->data[plane] && frame->linesize[plane]; plane++)
125  av_log(ctx, AV_LOG_INFO, "%"PRId64" ", (sum[plane] + pixelcount[plane]/2) / pixelcount[plane]);
126  av_log(ctx, AV_LOG_INFO, "\b] stdev:[");
127  for (plane = 0; plane < 4 && frame->data[plane] && frame->linesize[plane]; plane++)
128  av_log(ctx, AV_LOG_INFO, "%3.1f ",
129  sqrt((sum2[plane] - sum[plane]*(double)sum[plane]/pixelcount[plane])/pixelcount[plane]));
130  av_log(ctx, AV_LOG_INFO, "\b]\n");
131 
132  for (i = 0; i < frame->nb_side_data; i++) {
133  AVFrameSideData *sd = frame->side_data[i];
134 
135  av_log(ctx, AV_LOG_INFO, " side data - ");
136  switch (sd->type) {
138  av_log(ctx, AV_LOG_INFO, "pan/scan");
139  break;
141  av_log(ctx, AV_LOG_INFO, "A/53 closed captions (%d bytes)", sd->size);
142  break;
144  dump_stereo3d(ctx, sd);
145  break;
147  av_log(ctx, AV_LOG_INFO, "displaymatrix: rotation of %.2f degrees",
149  break;
150  case AV_FRAME_DATA_AFD:
151  av_log(ctx, AV_LOG_INFO, "afd: value of %"PRIu8, sd->data[0]);
152  break;
153  default:
154  av_log(ctx, AV_LOG_WARNING, "unknown side data type %d (%d bytes)",
155  sd->type, sd->size);
156  break;
157  }
158 
159  av_log(ctx, AV_LOG_INFO, "\n");
160  }
161 
162  return ff_filter_frame(inlink->dst->outputs[0], frame);
163 }
164 
165 static int config_props(AVFilterContext *ctx, AVFilterLink *link, int is_out)
166 {
167 
168  av_log(ctx, AV_LOG_INFO, "config %s time_base: %d/%d, frame_rate: %d/%d\n",
169  is_out ? "out" :"in",
170  link->time_base.num, link->time_base.den,
171  link->frame_rate.num, link->frame_rate.den
172  );
173 
174  return 0;
175 }
176 
177 static int config_props_in(AVFilterLink *link)
178 {
179  AVFilterContext *ctx = link->dst;
180  return config_props(ctx, link, 0);
181 }
182 
184 {
185  AVFilterContext *ctx = link->src;
186  return config_props(ctx, link, 1);
187 }
188 
190  {
191  .name = "default",
192  .type = AVMEDIA_TYPE_VIDEO,
193  .filter_frame = filter_frame,
194  .config_props = config_props_in,
195  },
196  { NULL }
197 };
198 
200  {
201  .name = "default",
202  .type = AVMEDIA_TYPE_VIDEO,
203  .config_props = config_props_out,
204  },
205  { NULL }
206 };
207 
209  .name = "showinfo",
210  .description = NULL_IF_CONFIG_SMALL("Show textual information for each video frame."),
211  .inputs = avfilter_vf_showinfo_inputs,
212  .outputs = avfilter_vf_showinfo_outputs,
213 };
int plane
Definition: avisynth_c.h:291
#define NULL
Definition: coverity.c:32
static int config_props_out(AVFilterLink *link)
Definition: vf_showinfo.c:183
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:75
Views are packed per line, as if interlaced.
Definition: stereo3d.h:97
const AVPixFmtDescriptor * av_pix_fmt_desc_get(enum AVPixelFormat pix_fmt)
Definition: pixdesc.c:2129
This structure describes decoded (raw) audio or video data.
Definition: frame.h:171
ptrdiff_t const GLvoid * data
Definition: opengl_enc.c:101
Views are alternated temporally.
Definition: stereo3d.h:66
misc image utilities
Views are next to each other, but when upscaling apply a checkerboard pattern.
Definition: stereo3d.h:87
#define AV_LOG_WARNING
Something somehow does not look correct.
Definition: log.h:182
Main libavfilter public API header.
int num
numerator
Definition: rational.h:44
static const AVFilterPad avfilter_vf_showinfo_inputs[]
Definition: vf_showinfo.c:189
static int filter_frame(AVFilterLink *inlink, AVFrame *frame)
Definition: vf_showinfo.c:79
const char * name
Pad name.
Definition: internal.h:69
int ff_filter_frame(AVFilterLink *link, AVFrame *frame)
Send a frame of data to the next filter.
Definition: avfilter.c:1158
uint8_t
timestamp utils, mostly useful for debugging/logging purposes
Stereo 3D type: this structure describes how two videos are packed within a single video surface...
Definition: stereo3d.h:123
static int config_props_in(AVFilterLink *link)
Definition: vf_showinfo.c:177
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:44
int64_t pts
Presentation timestamp in time_base units (time when frame should be shown to user).
Definition: frame.h:257
The data is the AVPanScan struct defined in libavcodec.
Definition: frame.h:52
static AVFrame * frame
Structure to hold side data for an AVFrame.
Definition: frame.h:134
char av_get_picture_type_char(enum AVPictureType pict_type)
Return a single letter to describe the given picture type pict_type.
Definition: utils.c:91
int interlaced_frame
The content of the picture is interlaced.
Definition: frame.h:367
Active Format Description data consisting of a single byte as specified in ETSI TS 101 154 using AVAc...
Definition: frame.h:89
int nb_side_data
Definition: frame.h:462
AVFrameSideData ** side_data
Definition: frame.h:461
#define av_log(a,...)
const char * name
Definition: pixdesc.h:70
A filter pad used for either input or output.
Definition: internal.h:63
int width
width and height of the video frame
Definition: frame.h:220
int flags
Additional information about the frame packing.
Definition: stereo3d.h:132
uint8_t log2_chroma_h
Amount to shift the luma height right to find the chroma height.
Definition: pixdesc.h:89
#define av_ts2timestr(ts, tb)
Convenience macro, the return value should be used only directly in function arguments but never stan...
Definition: timestamp.h:76
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification. ...
Definition: internal.h:175
ATSC A53 Part 4 Closed Captions.
Definition: frame.h:58
static void update_sample_stats(const uint8_t *src, int len, int64_t *sum, int64_t *sum2)
Definition: vf_showinfo.c:69
Video is not stereoscopic (and metadata has to be there).
Definition: stereo3d.h:35
common internal API header
enum AVPictureType pict_type
Picture type of the frame.
Definition: frame.h:242
static int config_props(AVFilterContext *ctx, AVFilterLink *link, int is_out)
Definition: vf_showinfo.c:165
static void dump_stereo3d(AVFilterContext *ctx, AVFrameSideData *sd)
Definition: vf_showinfo.c:39
#define FF_CEIL_RSHIFT(a, b)
Definition: common.h:57
int32_t
#define AV_STEREO3D_FLAG_INVERT
Inverted views, Right/Bottom represents the left view.
Definition: stereo3d.h:114
Public header for libavutil Adler32 hasher.
int format
format of the frame, -1 if unknown or unset Values correspond to enum AVPixelFormat for video frames...
Definition: frame.h:232
enum AVStereo3DType type
How views are packed within the video.
Definition: stereo3d.h:127
#define AV_LOG_INFO
Standard information.
Definition: log.h:187
AVS_Value src
Definition: avisynth_c.h:482
This side data contains a 3x3 transformation matrix describing an affine transformation that needs to...
Definition: frame.h:84
int linesize[AV_NUM_DATA_POINTERS]
For video, size in bytes of each picture line.
Definition: frame.h:199
Descriptor that unambiguously describes how the bits of a pixel are stored in the up to 4 data planes...
Definition: pixdesc.h:69
AVRational sample_aspect_ratio
Sample aspect ratio for the video frame, 0/1 if unknown/unspecified.
Definition: frame.h:252
uint8_t * data
Definition: frame.h:136
static const AVFilterPad avfilter_vf_showinfo_outputs[]
Definition: vf_showinfo.c:199
Filter definition.
Definition: avfilter.h:470
const char * name
Filter name.
Definition: avfilter.h:474
AVFilterLink ** outputs
array of pointers to output links
Definition: avfilter.h:648
Views are on top of each other.
Definition: stereo3d.h:55
enum AVFrameSideDataType type
Definition: frame.h:135
uint8_t * data[AV_NUM_DATA_POINTERS]
pointer to the picture/channel planes.
Definition: frame.h:182
Views are next to each other.
Definition: stereo3d.h:45
int den
denominator
Definition: rational.h:45
double av_display_rotation_get(const int32_t matrix[9])
The display transformation matrix specifies an affine transformation that should be applied to video ...
Definition: display.c:34
int top_field_first
If the content is interlaced, is top field displayed first.
Definition: frame.h:372
#define av_ts2str(ts)
Convenience macro, the return value should be used only directly in function arguments but never stan...
Definition: timestamp.h:54
int len
int64_t av_frame_get_pkt_pos(const AVFrame *frame)
Views are packed in a checkerboard-like structure per pixel.
Definition: stereo3d.h:76
int key_frame
1 -> keyframe, 0-> not
Definition: frame.h:237
Views are packed per column.
Definition: stereo3d.h:107
An instance of a filter.
Definition: avfilter.h:633
int height
Definition: frame.h:220
internal API functions
Stereoscopic 3d metadata.
Definition: frame.h:63
AVFilter ff_vf_showinfo
Definition: vf_showinfo.c:208