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/spherical.h"
33 #include "libavutil/stereo3d.h"
34 #include "libavutil/timestamp.h"
35 #include "libavutil/timecode.h"
36 
37 #include "avfilter.h"
38 #include "internal.h"
39 #include "video.h"
40 
42 {
43  AVSphericalMapping *spherical = (AVSphericalMapping *)sd->data;
44  double yaw, pitch, roll;
45 
46  av_log(ctx, AV_LOG_INFO, "spherical information: ");
47  if (sd->size < sizeof(*spherical)) {
48  av_log(ctx, AV_LOG_INFO, "invalid data");
49  return;
50  }
51 
52  if (spherical->projection == AV_SPHERICAL_EQUIRECTANGULAR)
53  av_log(ctx, AV_LOG_INFO, "equirectangular ");
54  else if (spherical->projection == AV_SPHERICAL_CUBEMAP)
55  av_log(ctx, AV_LOG_INFO, "cubemap ");
56  else if (spherical->projection == AV_SPHERICAL_EQUIRECTANGULAR_TILE)
57  av_log(ctx, AV_LOG_INFO, "tiled equirectangular ");
58  else {
59  av_log(ctx, AV_LOG_WARNING, "unknown");
60  return;
61  }
62 
63  yaw = ((double)spherical->yaw) / (1 << 16);
64  pitch = ((double)spherical->pitch) / (1 << 16);
65  roll = ((double)spherical->roll) / (1 << 16);
66  av_log(ctx, AV_LOG_INFO, "(%f/%f/%f) ", yaw, pitch, roll);
67 
69  size_t l, t, r, b;
70  av_spherical_tile_bounds(spherical, frame->width, frame->height,
71  &l, &t, &r, &b);
72  av_log(ctx, AV_LOG_INFO,
74  l, t, r, b);
75  } else if (spherical->projection == AV_SPHERICAL_CUBEMAP) {
76  av_log(ctx, AV_LOG_INFO, "[pad %"PRIu32"] ", spherical->padding);
77  }
78 }
79 
81 {
82  AVStereo3D *stereo;
83 
84  av_log(ctx, AV_LOG_INFO, "stereoscopic information: ");
85  if (sd->size < sizeof(*stereo)) {
86  av_log(ctx, AV_LOG_INFO, "invalid data");
87  return;
88  }
89 
90  stereo = (AVStereo3D *)sd->data;
91 
92  av_log(ctx, AV_LOG_INFO, "type - %s", av_stereo3d_type_name(stereo->type));
93 
94  if (stereo->flags & AV_STEREO3D_FLAG_INVERT)
95  av_log(ctx, AV_LOG_INFO, " (inverted)");
96 }
97 
99 {
100  const char *color_range_str = av_color_range_name(frame->color_range);
101  const char *colorspace_str = av_color_space_name(frame->colorspace);
102  const char *color_primaries_str = av_color_primaries_name(frame->color_primaries);
103  const char *color_trc_str = av_color_transfer_name(frame->color_trc);
104 
105  if (!color_range_str || frame->color_range == AVCOL_RANGE_UNSPECIFIED) {
106  av_log(ctx, AV_LOG_INFO, "color_range:unknown");
107  } else {
108  av_log(ctx, AV_LOG_INFO, "color_range:%s", color_range_str);
109  }
110 
111  if (!colorspace_str || frame->colorspace == AVCOL_SPC_UNSPECIFIED) {
112  av_log(ctx, AV_LOG_INFO, " color_space:unknown");
113  } else {
114  av_log(ctx, AV_LOG_INFO, " color_space:%s", colorspace_str);
115  }
116 
117  if (!color_primaries_str || frame->color_primaries == AVCOL_PRI_UNSPECIFIED) {
118  av_log(ctx, AV_LOG_INFO, " color_primaries:unknown");
119  } else {
120  av_log(ctx, AV_LOG_INFO, " color_primaries:%s", color_primaries_str);
121  }
122 
123  if (!color_trc_str || frame->color_trc == AVCOL_TRC_UNSPECIFIED) {
124  av_log(ctx, AV_LOG_INFO, " color_trc:unknown");
125  } else {
126  av_log(ctx, AV_LOG_INFO, " color_trc:%s", color_trc_str);
127  }
128  av_log(ctx, AV_LOG_INFO, "\n");
129 }
130 
131 static void update_sample_stats(const uint8_t *src, int len, int64_t *sum, int64_t *sum2)
132 {
133  int i;
134 
135  for (i = 0; i < len; i++) {
136  *sum += src[i];
137  *sum2 += src[i] * src[i];
138  }
139 }
140 
141 static int filter_frame(AVFilterLink *inlink, AVFrame *frame)
142 {
143  AVFilterContext *ctx = inlink->dst;
145  uint32_t plane_checksum[4] = {0}, checksum = 0;
146  int64_t sum[4] = {0}, sum2[4] = {0};
147  int32_t pixelcount[4] = {0};
148  int i, plane, vsub = desc->log2_chroma_h;
149 
150  for (plane = 0; plane < 4 && frame->data[plane] && frame->linesize[plane]; plane++) {
151  uint8_t *data = frame->data[plane];
152  int h = plane == 1 || plane == 2 ? AV_CEIL_RSHIFT(inlink->h, vsub) : inlink->h;
153  int linesize = av_image_get_linesize(frame->format, frame->width, plane);
154 
155  if (linesize < 0)
156  return linesize;
157 
158  for (i = 0; i < h; i++) {
159  plane_checksum[plane] = av_adler32_update(plane_checksum[plane], data, linesize);
160  checksum = av_adler32_update(checksum, data, linesize);
161 
162  update_sample_stats(data, linesize, sum+plane, sum2+plane);
163  pixelcount[plane] += linesize;
164  data += frame->linesize[plane];
165  }
166  }
167 
168  av_log(ctx, AV_LOG_INFO,
169  "n:%4"PRId64" pts:%7s pts_time:%-7s pos:%9"PRId64" "
170  "fmt:%s sar:%d/%d s:%dx%d i:%c iskey:%d type:%c "
171  "checksum:%08"PRIX32" plane_checksum:[%08"PRIX32,
172  inlink->frame_count_out,
173  av_ts2str(frame->pts), av_ts2timestr(frame->pts, &inlink->time_base), frame->pkt_pos,
174  desc->name,
176  frame->width, frame->height,
177  !frame->interlaced_frame ? 'P' : /* Progressive */
178  frame->top_field_first ? 'T' : 'B', /* Top / Bottom */
179  frame->key_frame,
181  checksum, plane_checksum[0]);
182 
183  for (plane = 1; plane < 4 && frame->data[plane] && frame->linesize[plane]; plane++)
184  av_log(ctx, AV_LOG_INFO, " %08"PRIX32, plane_checksum[plane]);
185  av_log(ctx, AV_LOG_INFO, "] mean:[");
186  for (plane = 0; plane < 4 && frame->data[plane] && frame->linesize[plane]; plane++)
187  av_log(ctx, AV_LOG_INFO, "%"PRId64" ", (sum[plane] + pixelcount[plane]/2) / pixelcount[plane]);
188  av_log(ctx, AV_LOG_INFO, "\b] stdev:[");
189  for (plane = 0; plane < 4 && frame->data[plane] && frame->linesize[plane]; plane++)
190  av_log(ctx, AV_LOG_INFO, "%3.1f ",
191  sqrt((sum2[plane] - sum[plane]*(double)sum[plane]/pixelcount[plane])/pixelcount[plane]));
192  av_log(ctx, AV_LOG_INFO, "\b]\n");
193 
194  for (i = 0; i < frame->nb_side_data; i++) {
195  AVFrameSideData *sd = frame->side_data[i];
196 
197  av_log(ctx, AV_LOG_INFO, " side data - ");
198  switch (sd->type) {
200  av_log(ctx, AV_LOG_INFO, "pan/scan");
201  break;
203  av_log(ctx, AV_LOG_INFO, "A/53 closed captions (%d bytes)", sd->size);
204  break;
206  dump_spherical(ctx, frame, sd);
207  break;
209  dump_stereo3d(ctx, sd);
210  break;
212  uint32_t *tc = (uint32_t*)sd->data;
213  for (int j = 1; j < tc[0]; j++) {
214  char tcbuf[AV_TIMECODE_STR_SIZE];
215  av_timecode_make_smpte_tc_string(tcbuf, tc[j], 0);
216  av_log(ctx, AV_LOG_INFO, "timecode - %s%s", tcbuf, j != tc[0] - 1 ? ", " : "");
217  }
218  break;
219  }
221  av_log(ctx, AV_LOG_INFO, "displaymatrix: rotation of %.2f degrees",
223  break;
224  case AV_FRAME_DATA_AFD:
225  av_log(ctx, AV_LOG_INFO, "afd: value of %"PRIu8, sd->data[0]);
226  break;
227  default:
228  av_log(ctx, AV_LOG_WARNING, "unknown side data type %d (%d bytes)",
229  sd->type, sd->size);
230  break;
231  }
232 
233  av_log(ctx, AV_LOG_INFO, "\n");
234  }
235 
236  dump_color_property(ctx, frame);
237 
238  return ff_filter_frame(inlink->dst->outputs[0], frame);
239 }
240 
241 static int config_props(AVFilterContext *ctx, AVFilterLink *link, int is_out)
242 {
243 
244  av_log(ctx, AV_LOG_INFO, "config %s time_base: %d/%d, frame_rate: %d/%d\n",
245  is_out ? "out" : "in",
246  link->time_base.num, link->time_base.den,
247  link->frame_rate.num, link->frame_rate.den);
248 
249  return 0;
250 }
251 
252 static int config_props_in(AVFilterLink *link)
253 {
254  AVFilterContext *ctx = link->dst;
255  return config_props(ctx, link, 0);
256 }
257 
259 {
260  AVFilterContext *ctx = link->src;
261  return config_props(ctx, link, 1);
262 }
263 
265  {
266  .name = "default",
267  .type = AVMEDIA_TYPE_VIDEO,
268  .filter_frame = filter_frame,
269  .config_props = config_props_in,
270  },
271  { NULL }
272 };
273 
275  {
276  .name = "default",
277  .type = AVMEDIA_TYPE_VIDEO,
278  .config_props = config_props_out,
279  },
280  { NULL }
281 };
282 
284  .name = "showinfo",
285  .description = NULL_IF_CONFIG_SMALL("Show textual information for each video frame."),
286  .inputs = avfilter_vf_showinfo_inputs,
287  .outputs = avfilter_vf_showinfo_outputs,
288 };
int32_t pitch
Rotation around the right vector [-90, 90].
Definition: spherical.h:127
int plane
Definition: avisynth_c.h:422
#define AV_STEREO3D_FLAG_INVERT
Inverted views, Right/Bottom represents the left view.
Definition: stereo3d.h:167
#define NULL
Definition: coverity.c:32
static int config_props_out(AVFilterLink *link)
Definition: vf_showinfo.c:258
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:76
const AVPixFmtDescriptor * av_pix_fmt_desc_get(enum AVPixelFormat pix_fmt)
Definition: pixdesc.c:2446
This structure describes decoded (raw) audio or video data.
Definition: frame.h:226
static void dump_spherical(AVFilterContext *ctx, AVFrame *frame, AVFrameSideData *sd)
Definition: vf_showinfo.c:41
ptrdiff_t const GLvoid * data
Definition: opengl_enc.c:101
int64_t pkt_pos
reordered pos from the last AVPacket that has been input into the decoder
Definition: frame.h:498
misc image utilities
#define AV_LOG_WARNING
Something somehow does not look correct.
Definition: log.h:182
Main libavfilter public API header.
const char * desc
Definition: nvenc.c:65
Video represents a portion of a sphere mapped on a flat surface using equirectangular projection...
Definition: spherical.h:72
int num
Numerator.
Definition: rational.h:59
Timecode which conforms to SMPTE ST 12-1.
Definition: frame.h:168
const char * b
Definition: vf_curves.c:116
#define tc
Definition: regdef.h:69
Video represents a sphere mapped on a flat surface using equirectangular projection.
Definition: spherical.h:56
#define src
Definition: vp8dsp.c:254
static const AVFilterPad avfilter_vf_showinfo_inputs[]
Definition: vf_showinfo.c:264
static int filter_frame(AVFilterLink *inlink, AVFrame *frame)
Definition: vf_showinfo.c:141
const char * av_color_space_name(enum AVColorSpace space)
Definition: pixdesc.c:2839
const char * name
Pad name.
Definition: internal.h:60
int ff_filter_frame(AVFilterLink *link, AVFrame *frame)
Send a frame of data to the next filter.
Definition: avfilter.c:1080
uint8_t
static void dump_color_property(AVFilterContext *ctx, AVFrame *frame)
Definition: vf_showinfo.c:98
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:176
static int config_props_in(AVFilterLink *link)
Definition: vf_showinfo.c:252
const char * av_color_range_name(enum AVColorRange range)
Definition: pixdesc.c:2772
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
void av_spherical_tile_bounds(const AVSphericalMapping *map, size_t width, size_t height, size_t *left, size_t *top, size_t *right, size_t *bottom)
Convert the bounding fields from an AVSphericalVideo from 0.32 fixed point to pixels.
Definition: spherical.c:36
int64_t pts
Presentation timestamp in time_base units (time when frame should be shown to user).
Definition: frame.h:319
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:188
const char * av_stereo3d_type_name(unsigned int type)
Provide a human-readable name of a given stereo3d type.
Definition: stereo3d.c:57
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:88
int interlaced_frame
The content of the picture is interlaced.
Definition: frame.h:373
The data represents the AVSphericalMapping structure defined in libavutil/spherical.h.
Definition: frame.h:130
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:439
AVFrameSideData ** side_data
Definition: frame.h:438
#define av_log(a,...)
const char * name
Definition: pixdesc.h:82
A filter pad used for either input or output.
Definition: internal.h:54
int width
Definition: frame.h:284
int flags
Additional information about the frame packing.
Definition: stereo3d.h:185
uint8_t log2_chroma_h
Amount to shift the luma height right to find the chroma height.
Definition: pixdesc.h:101
#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:186
Display matrix.
const char * r
Definition: vf_curves.c:114
enum AVColorRange color_range
MPEG vs JPEG YUV range.
Definition: frame.h:471
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:131
enum AVColorSpace colorspace
YUV colorspace type.
Definition: frame.h:482
const char * av_color_primaries_name(enum AVColorPrimaries primaries)
Definition: pixdesc.c:2791
common internal API header
Video frame is split into 6 faces of a cube, and arranged on a 3x2 layout.
Definition: spherical.h:65
enum AVPictureType pict_type
Picture type of the frame.
Definition: frame.h:309
static int config_props(AVFilterContext *ctx, AVFilterLink *link, int is_out)
Definition: vf_showinfo.c:241
Spherical video.
static void dump_stereo3d(AVFilterContext *ctx, AVFrameSideData *sd)
Definition: vf_showinfo.c:80
int32_t
AVFormatContext * ctx
Definition: movenc.c:48
int32_t yaw
Rotation around the up vector [-180, 180].
Definition: spherical.h:126
static volatile int checksum
Definition: adler32.c:30
uint32_t padding
Number of pixels to pad from the edge of each cube face.
Definition: spherical.h:182
Public header for Adler-32 hash function implementation.
int format
format of the frame, -1 if unknown or unset Values correspond to enum AVPixelFormat for video frames...
Definition: frame.h:299
enum AVStereo3DType type
How views are packed within the video.
Definition: stereo3d.h:180
#define AV_LOG_INFO
Standard information.
Definition: log.h:187
This side data contains a 3x3 transformation matrix describing an affine transformation that needs to...
Definition: frame.h:84
Timecode helpers header.
int linesize[AV_NUM_DATA_POINTERS]
For video, size in bytes of each picture line.
Definition: frame.h:257
Descriptor that unambiguously describes how the bits of a pixel are stored in the up to 4 data planes...
Definition: pixdesc.h:81
AVRational sample_aspect_ratio
Sample aspect ratio for the video frame, 0/1 if unknown/unspecified.
Definition: frame.h:314
uint8_t * data
Definition: frame.h:190
static const AVFilterPad avfilter_vf_showinfo_outputs[]
Definition: vf_showinfo.c:274
Filter definition.
Definition: avfilter.h:144
int32_t roll
Rotation around the forward vector [-180, 180].
Definition: spherical.h:128
const char * name
Filter name.
Definition: avfilter.h:148
This structure describes how to handle spherical videos, outlining information about projection...
Definition: spherical.h:82
AVFilterLink ** outputs
array of pointers to output links
Definition: avfilter.h:350
char * av_timecode_make_smpte_tc_string(char *buf, uint32_t tcsmpte, int prevent_df)
Get the timecode string from the SMPTE timecode format.
Definition: timecode.c:118
enum AVFrameSideDataType type
Definition: frame.h:189
#define SIZE_SPECIFIER
Definition: internal.h:262
uint8_t * data[AV_NUM_DATA_POINTERS]
pointer to the picture/channel planes.
Definition: frame.h:240
enum AVSphericalProjection projection
Projection type.
Definition: spherical.h:86
const char * av_color_transfer_name(enum AVColorTransferCharacteristic transfer)
Definition: pixdesc.c:2815
Stereoscopic video.
int den
Denominator.
Definition: rational.h:60
int top_field_first
If the content is interlaced, is top field displayed first.
Definition: frame.h:378
#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
int key_frame
1 -> keyframe, 0-> not
Definition: frame.h:304
enum AVColorPrimaries color_primaries
Definition: frame.h:473
An instance of a filter.
Definition: avfilter.h:338
double av_display_rotation_get(const int32_t matrix[9])
Extract the rotation component of the transformation matrix.
Definition: display.c:34
int height
Definition: frame.h:284
enum AVColorTransferCharacteristic color_trc
Definition: frame.h:475
internal API functions
Stereoscopic 3d metadata.
Definition: frame.h:63
for(j=16;j >0;--j)
#define AV_TIMECODE_STR_SIZE
Definition: timecode.h:33
#define AV_CEIL_RSHIFT(a, b)
Definition: common.h:58
AVFilter ff_vf_showinfo
Definition: vf_showinfo.c:283