2 * Copyright (c) 2011 Stefano Sabatini
3 * This file is part of FFmpeg.
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.
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.
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
22 * filter for showing textual video frame information
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"
41 static void dump_spherical(AVFilterContext *ctx, AVFrame *frame, AVFrameSideData *sd)
43 AVSphericalMapping *spherical = (AVSphericalMapping *)sd->data;
44 double yaw, pitch, roll;
46 av_log(ctx, AV_LOG_INFO, "spherical information: ");
47 if (sd->size < sizeof(*spherical)) {
48 av_log(ctx, AV_LOG_INFO, "invalid data");
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 ");
59 av_log(ctx, AV_LOG_WARNING, "unknown");
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);
68 if (spherical->projection == AV_SPHERICAL_EQUIRECTANGULAR_TILE) {
70 av_spherical_tile_bounds(spherical, frame->width, frame->height,
72 av_log(ctx, AV_LOG_INFO,
73 "[%"SIZE_SPECIFIER", %"SIZE_SPECIFIER", %"SIZE_SPECIFIER", %"SIZE_SPECIFIER"] ",
75 } else if (spherical->projection == AV_SPHERICAL_CUBEMAP) {
76 av_log(ctx, AV_LOG_INFO, "[pad %"PRIu32"] ", spherical->padding);
80 static void dump_stereo3d(AVFilterContext *ctx, AVFrameSideData *sd)
84 av_log(ctx, AV_LOG_INFO, "stereoscopic information: ");
85 if (sd->size < sizeof(*stereo)) {
86 av_log(ctx, AV_LOG_INFO, "invalid data");
90 stereo = (AVStereo3D *)sd->data;
92 av_log(ctx, AV_LOG_INFO, "type - %s", av_stereo3d_type_name(stereo->type));
94 if (stereo->flags & AV_STEREO3D_FLAG_INVERT)
95 av_log(ctx, AV_LOG_INFO, " (inverted)");
98 static void update_sample_stats(const uint8_t *src, int len, int64_t *sum, int64_t *sum2)
102 for (i = 0; i < len; i++) {
104 *sum2 += src[i] * src[i];
108 static int filter_frame(AVFilterLink *inlink, AVFrame *frame)
110 AVFilterContext *ctx = inlink->dst;
111 const AVPixFmtDescriptor *desc = av_pix_fmt_desc_get(inlink->format);
112 uint32_t plane_checksum[4] = {0}, checksum = 0;
113 int64_t sum[4] = {0}, sum2[4] = {0};
114 int32_t pixelcount[4] = {0};
115 int i, plane, vsub = desc->log2_chroma_h;
117 for (plane = 0; plane < 4 && frame->data[plane] && frame->linesize[plane]; plane++) {
118 uint8_t *data = frame->data[plane];
119 int h = plane == 1 || plane == 2 ? AV_CEIL_RSHIFT(inlink->h, vsub) : inlink->h;
120 int linesize = av_image_get_linesize(frame->format, frame->width, plane);
125 for (i = 0; i < h; i++) {
126 plane_checksum[plane] = av_adler32_update(plane_checksum[plane], data, linesize);
127 checksum = av_adler32_update(checksum, data, linesize);
129 update_sample_stats(data, linesize, sum+plane, sum2+plane);
130 pixelcount[plane] += linesize;
131 data += frame->linesize[plane];
135 av_log(ctx, AV_LOG_INFO,
136 "n:%4"PRId64" pts:%7s pts_time:%-7s pos:%9"PRId64" "
137 "fmt:%s sar:%d/%d s:%dx%d i:%c iskey:%d type:%c "
138 "checksum:%08"PRIX32" plane_checksum:[%08"PRIX32,
139 inlink->frame_count_out,
140 av_ts2str(frame->pts), av_ts2timestr(frame->pts, &inlink->time_base), frame->pkt_pos,
142 frame->sample_aspect_ratio.num, frame->sample_aspect_ratio.den,
143 frame->width, frame->height,
144 !frame->interlaced_frame ? 'P' : /* Progressive */
145 frame->top_field_first ? 'T' : 'B', /* Top / Bottom */
147 av_get_picture_type_char(frame->pict_type),
148 checksum, plane_checksum[0]);
150 for (plane = 1; plane < 4 && frame->data[plane] && frame->linesize[plane]; plane++)
151 av_log(ctx, AV_LOG_INFO, " %08"PRIX32, plane_checksum[plane]);
152 av_log(ctx, AV_LOG_INFO, "] mean:[");
153 for (plane = 0; plane < 4 && frame->data[plane] && frame->linesize[plane]; plane++)
154 av_log(ctx, AV_LOG_INFO, "%"PRId64" ", (sum[plane] + pixelcount[plane]/2) / pixelcount[plane]);
155 av_log(ctx, AV_LOG_INFO, "\b] stdev:[");
156 for (plane = 0; plane < 4 && frame->data[plane] && frame->linesize[plane]; plane++)
157 av_log(ctx, AV_LOG_INFO, "%3.1f ",
158 sqrt((sum2[plane] - sum[plane]*(double)sum[plane]/pixelcount[plane])/pixelcount[plane]));
159 av_log(ctx, AV_LOG_INFO, "\b]\n");
161 for (i = 0; i < frame->nb_side_data; i++) {
162 AVFrameSideData *sd = frame->side_data[i];
164 av_log(ctx, AV_LOG_INFO, " side data - ");
166 case AV_FRAME_DATA_PANSCAN:
167 av_log(ctx, AV_LOG_INFO, "pan/scan");
169 case AV_FRAME_DATA_A53_CC:
170 av_log(ctx, AV_LOG_INFO, "A/53 closed captions (%d bytes)", sd->size);
172 case AV_FRAME_DATA_SPHERICAL:
173 dump_spherical(ctx, frame, sd);
175 case AV_FRAME_DATA_STEREO3D:
176 dump_stereo3d(ctx, sd);
178 case AV_FRAME_DATA_S12M_TIMECODE: {
179 uint32_t *tc = (uint32_t*)sd->data;
180 for (int j = 1; j < tc[0]; j++) {
181 char tcbuf[AV_TIMECODE_STR_SIZE];
182 av_timecode_make_smpte_tc_string(tcbuf, tc[j], 0);
183 av_log(ctx, AV_LOG_INFO, "timecode - %s%s", tcbuf, j != tc[0] - 1 ? ", " : "");
187 case AV_FRAME_DATA_DISPLAYMATRIX:
188 av_log(ctx, AV_LOG_INFO, "displaymatrix: rotation of %.2f degrees",
189 av_display_rotation_get((int32_t *)sd->data));
191 case AV_FRAME_DATA_AFD:
192 av_log(ctx, AV_LOG_INFO, "afd: value of %"PRIu8, sd->data[0]);
195 av_log(ctx, AV_LOG_WARNING, "unknown side data type %d (%d bytes)",
200 av_log(ctx, AV_LOG_INFO, "\n");
203 return ff_filter_frame(inlink->dst->outputs[0], frame);
206 static int config_props(AVFilterContext *ctx, AVFilterLink *link, int is_out)
209 av_log(ctx, AV_LOG_INFO, "config %s time_base: %d/%d, frame_rate: %d/%d\n",
210 is_out ? "out" : "in",
211 link->time_base.num, link->time_base.den,
212 link->frame_rate.num, link->frame_rate.den);
217 static int config_props_in(AVFilterLink *link)
219 AVFilterContext *ctx = link->dst;
220 return config_props(ctx, link, 0);
223 static int config_props_out(AVFilterLink *link)
225 AVFilterContext *ctx = link->src;
226 return config_props(ctx, link, 1);
229 static const AVFilterPad avfilter_vf_showinfo_inputs[] = {
232 .type = AVMEDIA_TYPE_VIDEO,
233 .filter_frame = filter_frame,
234 .config_props = config_props_in,
239 static const AVFilterPad avfilter_vf_showinfo_outputs[] = {
242 .type = AVMEDIA_TYPE_VIDEO,
243 .config_props = config_props_out,
248 AVFilter ff_vf_showinfo = {
250 .description = NULL_IF_CONFIG_SMALL("Show textual information for each video frame."),
251 .inputs = avfilter_vf_showinfo_inputs,
252 .outputs = avfilter_vf_showinfo_outputs,