2 * Copyright (c) 2003-2013 Loren Merritt
3 * Copyright (c) 2015 Paul B Mahol
5 * This file is part of FFmpeg.
7 * FFmpeg is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2.1 of the License, or (at your option) any later version.
12 * FFmpeg is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with FFmpeg; if not, write to the Free Software
19 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
22 /* Computes the Structural Similarity Metric between two video streams.
24 * Z. Wang, A. C. Bovik, H. R. Sheikh and E. P. Simoncelli,
25 * "Image quality assessment: From error visibility to structural similarity,"
26 * IEEE Transactions on Image Processing, vol. 13, no. 4, pp. 600-612, Apr. 2004.
28 * To improve speed, this implementation uses the standard approximation of
29 * overlapped 8x8 block sums, rather than the original gaussian weights.
34 * Caculate the SSIM between two input videos.
37 #include "libavutil/avstring.h"
38 #include "libavutil/opt.h"
39 #include "libavutil/pixdesc.h"
41 #include "dualinput.h"
42 #include "drawutils.h"
48 typedef struct SSIMContext {
50 FFDualInputContext dinput;
56 double ssim[4], ssim_total;
64 float (*ssim_plane)(SSIMDSPContext *dsp,
65 uint8_t *main, int main_stride,
66 uint8_t *ref, int ref_stride,
67 int width, int height, void *temp,
72 #define OFFSET(x) offsetof(SSIMContext, x)
73 #define FLAGS AV_OPT_FLAG_FILTERING_PARAM|AV_OPT_FLAG_VIDEO_PARAM
75 static const AVOption ssim_options[] = {
76 {"stats_file", "Set file where to store per-frame difference information", OFFSET(stats_file_str), AV_OPT_TYPE_STRING, {.str=NULL}, 0, 0, FLAGS },
77 {"f", "Set file where to store per-frame difference information", OFFSET(stats_file_str), AV_OPT_TYPE_STRING, {.str=NULL}, 0, 0, FLAGS },
81 AVFILTER_DEFINE_CLASS(ssim);
83 static void set_meta(AVDictionary **metadata, const char *key, char comp, float d)
86 snprintf(value, sizeof(value), "%0.2f", d);
89 snprintf(key2, sizeof(key2), "%s%c", key, comp);
90 av_dict_set(metadata, key2, value, 0);
92 av_dict_set(metadata, key, value, 0);
96 static void ssim_4x4xn_16bit(const uint8_t *main8, ptrdiff_t main_stride,
97 const uint8_t *ref8, ptrdiff_t ref_stride,
98 int64_t (*sums)[4], int width)
100 const uint16_t *main16 = (const uint16_t *)main8;
101 const uint16_t *ref16 = (const uint16_t *)ref8;
107 for (z = 0; z < width; z++) {
108 uint64_t s1 = 0, s2 = 0, ss = 0, s12 = 0;
110 for (y = 0; y < 4; y++) {
111 for (x = 0; x < 4; x++) {
112 int a = main16[x + y * main_stride];
113 int b = ref16[x + y * ref_stride];
132 static void ssim_4x4xn_8bit(const uint8_t *main, ptrdiff_t main_stride,
133 const uint8_t *ref, ptrdiff_t ref_stride,
134 int (*sums)[4], int width)
138 for (z = 0; z < width; z++) {
139 uint32_t s1 = 0, s2 = 0, ss = 0, s12 = 0;
141 for (y = 0; y < 4; y++) {
142 for (x = 0; x < 4; x++) {
143 int a = main[x + y * main_stride];
144 int b = ref[x + y * ref_stride];
163 static float ssim_end1x(int64_t s1, int64_t s2, int64_t ss, int64_t s12, int max)
165 int64_t ssim_c1 = (int64_t)(.01*.01*max*max*64 + .5);
166 int64_t ssim_c2 = (int64_t)(.03*.03*max*max*64*63 + .5);
172 int64_t vars = fss * 64 - fs1 * fs1 - fs2 * fs2;
173 int64_t covar = fs12 * 64 - fs1 * fs2;
175 return (float)(2 * fs1 * fs2 + ssim_c1) * (float)(2 * covar + ssim_c2)
176 / ((float)(fs1 * fs1 + fs2 * fs2 + ssim_c1) * (float)(vars + ssim_c2));
179 static float ssim_end1(int s1, int s2, int ss, int s12)
181 static const int ssim_c1 = (int)(.01*.01*255*255*64 + .5);
182 static const int ssim_c2 = (int)(.03*.03*255*255*64*63 + .5);
188 int vars = fss * 64 - fs1 * fs1 - fs2 * fs2;
189 int covar = fs12 * 64 - fs1 * fs2;
191 return (float)(2 * fs1 * fs2 + ssim_c1) * (float)(2 * covar + ssim_c2)
192 / ((float)(fs1 * fs1 + fs2 * fs2 + ssim_c1) * (float)(vars + ssim_c2));
195 static float ssim_endn_16bit(const int64_t (*sum0)[4], const int64_t (*sum1)[4], int width, int max)
200 for (i = 0; i < width; i++)
201 ssim += ssim_end1x(sum0[i][0] + sum0[i + 1][0] + sum1[i][0] + sum1[i + 1][0],
202 sum0[i][1] + sum0[i + 1][1] + sum1[i][1] + sum1[i + 1][1],
203 sum0[i][2] + sum0[i + 1][2] + sum1[i][2] + sum1[i + 1][2],
204 sum0[i][3] + sum0[i + 1][3] + sum1[i][3] + sum1[i + 1][3],
209 static float ssim_endn_8bit(const int (*sum0)[4], const int (*sum1)[4], int width)
214 for (i = 0; i < width; i++)
215 ssim += ssim_end1(sum0[i][0] + sum0[i + 1][0] + sum1[i][0] + sum1[i + 1][0],
216 sum0[i][1] + sum0[i + 1][1] + sum1[i][1] + sum1[i + 1][1],
217 sum0[i][2] + sum0[i + 1][2] + sum1[i][2] + sum1[i + 1][2],
218 sum0[i][3] + sum0[i + 1][3] + sum1[i][3] + sum1[i + 1][3]);
222 static float ssim_plane_16bit(SSIMDSPContext *dsp,
223 uint8_t *main, int main_stride,
224 uint8_t *ref, int ref_stride,
225 int width, int height, void *temp,
230 int64_t (*sum0)[4] = temp;
231 int64_t (*sum1)[4] = sum0 + (width >> 2) + 3;
236 for (y = 1; y < height; y++) {
237 for (; z <= y; z++) {
238 FFSWAP(void*, sum0, sum1);
239 ssim_4x4xn_16bit(&main[4 * z * main_stride], main_stride,
240 &ref[4 * z * ref_stride], ref_stride,
244 ssim += ssim_endn_16bit((const int64_t (*)[4])sum0, (const int64_t (*)[4])sum1, width - 1, max);
247 return ssim / ((height - 1) * (width - 1));
250 static float ssim_plane(SSIMDSPContext *dsp,
251 uint8_t *main, int main_stride,
252 uint8_t *ref, int ref_stride,
253 int width, int height, void *temp,
258 int (*sum0)[4] = temp;
259 int (*sum1)[4] = sum0 + (width >> 2) + 3;
264 for (y = 1; y < height; y++) {
265 for (; z <= y; z++) {
266 FFSWAP(void*, sum0, sum1);
267 dsp->ssim_4x4_line(&main[4 * z * main_stride], main_stride,
268 &ref[4 * z * ref_stride], ref_stride,
272 ssim += dsp->ssim_end_line((const int (*)[4])sum0, (const int (*)[4])sum1, width - 1);
275 return ssim / ((height - 1) * (width - 1));
278 static double ssim_db(double ssim, double weight)
280 return 10 * log10(weight / (weight - ssim));
283 static AVFrame *do_ssim(AVFilterContext *ctx, AVFrame *main,
286 AVDictionary **metadata = &main->metadata;
287 SSIMContext *s = ctx->priv;
288 float c[4], ssimv = 0.0;
293 for (i = 0; i < s->nb_components; i++) {
294 c[i] = s->ssim_plane(&s->dsp, main->data[i], main->linesize[i],
295 ref->data[i], ref->linesize[i],
296 s->planewidth[i], s->planeheight[i], s->temp,
298 ssimv += s->coefs[i] * c[i];
301 for (i = 0; i < s->nb_components; i++) {
302 int cidx = s->is_rgb ? s->rgba_map[i] : i;
303 set_meta(metadata, "lavfi.ssim.", s->comps[i], c[cidx]);
305 s->ssim_total += ssimv;
307 set_meta(metadata, "lavfi.ssim.All", 0, ssimv);
308 set_meta(metadata, "lavfi.ssim.dB", 0, ssim_db(ssimv, 1.0));
311 fprintf(s->stats_file, "n:%"PRId64" ", s->nb_frames);
313 for (i = 0; i < s->nb_components; i++) {
314 int cidx = s->is_rgb ? s->rgba_map[i] : i;
315 fprintf(s->stats_file, "%c:%f ", s->comps[i], c[cidx]);
318 fprintf(s->stats_file, "All:%f (%f)\n", ssimv, ssim_db(ssimv, 1.0));
324 static av_cold int init(AVFilterContext *ctx)
326 SSIMContext *s = ctx->priv;
328 if (s->stats_file_str) {
329 if (!strcmp(s->stats_file_str, "-")) {
330 s->stats_file = stdout;
332 s->stats_file = fopen(s->stats_file_str, "w");
333 if (!s->stats_file) {
334 int err = AVERROR(errno);
336 av_strerror(err, buf, sizeof(buf));
337 av_log(ctx, AV_LOG_ERROR, "Could not open stats file %s: %s\n",
338 s->stats_file_str, buf);
344 s->dinput.process = do_ssim;
345 s->dinput.shortest = 1;
346 s->dinput.repeatlast = 0;
350 static int query_formats(AVFilterContext *ctx)
352 static const enum AVPixelFormat pix_fmts[] = {
353 AV_PIX_FMT_GRAY8, AV_PIX_FMT_GRAY10,
354 AV_PIX_FMT_GRAY12, AV_PIX_FMT_GRAY16,
355 AV_PIX_FMT_YUV420P, AV_PIX_FMT_YUV422P, AV_PIX_FMT_YUV444P,
356 AV_PIX_FMT_YUV440P, AV_PIX_FMT_YUV411P, AV_PIX_FMT_YUV410P,
357 AV_PIX_FMT_YUVJ411P, AV_PIX_FMT_YUVJ420P, AV_PIX_FMT_YUVJ422P,
358 AV_PIX_FMT_YUVJ440P, AV_PIX_FMT_YUVJ444P,
360 #define PF(suf) AV_PIX_FMT_YUV420##suf, AV_PIX_FMT_YUV422##suf, AV_PIX_FMT_YUV444##suf, AV_PIX_FMT_GBR##suf
361 PF(P9), PF(P10), PF(P12), PF(P14), PF(P16),
365 AVFilterFormats *fmts_list = ff_make_format_list(pix_fmts);
367 return AVERROR(ENOMEM);
368 return ff_set_common_formats(ctx, fmts_list);
371 static int config_input_ref(AVFilterLink *inlink)
373 const AVPixFmtDescriptor *desc = av_pix_fmt_desc_get(inlink->format);
374 AVFilterContext *ctx = inlink->dst;
375 SSIMContext *s = ctx->priv;
378 s->nb_components = desc->nb_components;
380 if (ctx->inputs[0]->w != ctx->inputs[1]->w ||
381 ctx->inputs[0]->h != ctx->inputs[1]->h) {
382 av_log(ctx, AV_LOG_ERROR, "Width and height of input videos must be same.\n");
383 return AVERROR(EINVAL);
385 if (ctx->inputs[0]->format != ctx->inputs[1]->format) {
386 av_log(ctx, AV_LOG_ERROR, "Inputs must be of same pixel format.\n");
387 return AVERROR(EINVAL);
390 s->is_rgb = ff_fill_rgba_map(s->rgba_map, inlink->format) >= 0;
391 s->comps[0] = s->is_rgb ? 'R' : 'Y';
392 s->comps[1] = s->is_rgb ? 'G' : 'U';
393 s->comps[2] = s->is_rgb ? 'B' : 'V';
396 s->planeheight[1] = s->planeheight[2] = AV_CEIL_RSHIFT(inlink->h, desc->log2_chroma_h);
397 s->planeheight[0] = s->planeheight[3] = inlink->h;
398 s->planewidth[1] = s->planewidth[2] = AV_CEIL_RSHIFT(inlink->w, desc->log2_chroma_w);
399 s->planewidth[0] = s->planewidth[3] = inlink->w;
400 for (i = 0; i < s->nb_components; i++)
401 sum += s->planeheight[i] * s->planewidth[i];
402 for (i = 0; i < s->nb_components; i++)
403 s->coefs[i] = (double) s->planeheight[i] * s->planewidth[i] / sum;
405 s->temp = av_malloc_array((2 * inlink->w + 12), sizeof(*s->temp) * (1 + (desc->comp[0].depth > 8)));
407 return AVERROR(ENOMEM);
408 s->max = (1 << desc->comp[0].depth) - 1;
410 s->ssim_plane = desc->comp[0].depth > 8 ? ssim_plane_16bit : ssim_plane;
411 s->dsp.ssim_4x4_line = ssim_4x4xn_8bit;
412 s->dsp.ssim_end_line = ssim_endn_8bit;
414 ff_ssim_init_x86(&s->dsp);
419 static int config_output(AVFilterLink *outlink)
421 AVFilterContext *ctx = outlink->src;
422 SSIMContext *s = ctx->priv;
423 AVFilterLink *mainlink = ctx->inputs[0];
426 outlink->w = mainlink->w;
427 outlink->h = mainlink->h;
428 outlink->time_base = mainlink->time_base;
429 outlink->sample_aspect_ratio = mainlink->sample_aspect_ratio;
430 outlink->frame_rate = mainlink->frame_rate;
432 if ((ret = ff_dualinput_init(ctx, &s->dinput)) < 0)
438 static int filter_frame(AVFilterLink *inlink, AVFrame *buf)
440 SSIMContext *s = inlink->dst->priv;
441 return ff_dualinput_filter_frame(&s->dinput, inlink, buf);
444 static int request_frame(AVFilterLink *outlink)
446 SSIMContext *s = outlink->src->priv;
447 return ff_dualinput_request_frame(&s->dinput, outlink);
450 static av_cold void uninit(AVFilterContext *ctx)
452 SSIMContext *s = ctx->priv;
454 if (s->nb_frames > 0) {
458 for (i = 0; i < s->nb_components; i++) {
459 int c = s->is_rgb ? s->rgba_map[i] : i;
460 av_strlcatf(buf, sizeof(buf), " %c:%f (%f)", s->comps[i], s->ssim[c] / s->nb_frames,
461 ssim_db(s->ssim[c], s->nb_frames));
463 av_log(ctx, AV_LOG_INFO, "SSIM%s All:%f (%f)\n", buf,
464 s->ssim_total / s->nb_frames, ssim_db(s->ssim_total, s->nb_frames));
467 ff_dualinput_uninit(&s->dinput);
469 if (s->stats_file && s->stats_file != stdout)
470 fclose(s->stats_file);
475 static const AVFilterPad ssim_inputs[] = {
478 .type = AVMEDIA_TYPE_VIDEO,
479 .filter_frame = filter_frame,
482 .type = AVMEDIA_TYPE_VIDEO,
483 .filter_frame = filter_frame,
484 .config_props = config_input_ref,
489 static const AVFilterPad ssim_outputs[] = {
492 .type = AVMEDIA_TYPE_VIDEO,
493 .config_props = config_output,
494 .request_frame = request_frame,
499 AVFilter ff_vf_ssim = {
501 .description = NULL_IF_CONFIG_SMALL("Calculate the SSIM between two video streams."),
504 .query_formats = query_formats,
505 .priv_size = sizeof(SSIMContext),
506 .priv_class = &ssim_class,
507 .inputs = ssim_inputs,
508 .outputs = ssim_outputs,