avfilter/af_afftdn: add alias for sample_noise end
[ffmpeg.git] / libavfilter / vf_showinfo.c
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
41 static void dump_spherical(AVFilterContext *ctx, AVFrame *frame, AVFrameSideData *sd)
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
68     if (spherical->projection == AV_SPHERICAL_EQUIRECTANGULAR_TILE) {
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,
73                "[%"SIZE_SPECIFIER", %"SIZE_SPECIFIER", %"SIZE_SPECIFIER", %"SIZE_SPECIFIER"] ",
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
80 static void dump_stereo3d(AVFilterContext *ctx, AVFrameSideData *sd)
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
98 static void dump_color_property(AVFilterContext *ctx, AVFrame *frame)
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;
144     const AVPixFmtDescriptor *desc = av_pix_fmt_desc_get(inlink->format);
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,
175            frame->sample_aspect_ratio.num, frame->sample_aspect_ratio.den,
176            frame->width, frame->height,
177            !frame->interlaced_frame ? 'P' :         /* Progressive  */
178            frame->top_field_first   ? 'T' : 'B',    /* Top / Bottom */
179            frame->key_frame,
180            av_get_picture_type_char(frame->pict_type),
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) {
199         case AV_FRAME_DATA_PANSCAN:
200             av_log(ctx, AV_LOG_INFO, "pan/scan");
201             break;
202         case AV_FRAME_DATA_A53_CC:
203             av_log(ctx, AV_LOG_INFO, "A/53 closed captions (%d bytes)", sd->size);
204             break;
205         case AV_FRAME_DATA_SPHERICAL:
206             dump_spherical(ctx, frame, sd);
207             break;
208         case AV_FRAME_DATA_STEREO3D:
209             dump_stereo3d(ctx, sd);
210             break;
211         case AV_FRAME_DATA_S12M_TIMECODE: {
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         }
220         case AV_FRAME_DATA_DISPLAYMATRIX:
221             av_log(ctx, AV_LOG_INFO, "displaymatrix: rotation of %.2f degrees",
222                    av_display_rotation_get((int32_t *)sd->data));
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
258 static int config_props_out(AVFilterLink *link)
259 {
260     AVFilterContext *ctx = link->src;
261     return config_props(ctx, link, 1);
262 }
263
264 static const AVFilterPad avfilter_vf_showinfo_inputs[] = {
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
274 static const AVFilterPad avfilter_vf_showinfo_outputs[] = {
275     {
276         .name = "default",
277         .type = AVMEDIA_TYPE_VIDEO,
278         .config_props  = config_props_out,
279     },
280     { NULL }
281 };
282
283 AVFilter ff_vf_showinfo = {
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 };