]> git.sesse.net Git - ffmpeg/blob - libavfilter/vf_paletteuse.c
avfilter: Constify all AVFilters
[ffmpeg] / libavfilter / vf_paletteuse.c
1 /*
2  * Copyright (c) 2015 Stupeflix
3  *
4  * This file is part of FFmpeg.
5  *
6  * FFmpeg is free software; you can redistribute it and/or
7  * modify it under the terms of the GNU Lesser General Public
8  * License as published by the Free Software Foundation; either
9  * version 2.1 of the License, or (at your option) any later version.
10  *
11  * FFmpeg is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
14  * Lesser General Public License for more details.
15  *
16  * You should have received a copy of the GNU Lesser General Public
17  * License along with FFmpeg; if not, write to the Free Software
18  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
19  */
20
21 /**
22  * @file
23  * Use a palette to downsample an input video stream.
24  */
25
26 #include "libavutil/bprint.h"
27 #include "libavutil/internal.h"
28 #include "libavutil/opt.h"
29 #include "libavutil/qsort.h"
30 #include "avfilter.h"
31 #include "filters.h"
32 #include "framesync.h"
33 #include "internal.h"
34
35 enum dithering_mode {
36     DITHERING_NONE,
37     DITHERING_BAYER,
38     DITHERING_HECKBERT,
39     DITHERING_FLOYD_STEINBERG,
40     DITHERING_SIERRA2,
41     DITHERING_SIERRA2_4A,
42     NB_DITHERING
43 };
44
45 enum color_search_method {
46     COLOR_SEARCH_NNS_ITERATIVE,
47     COLOR_SEARCH_NNS_RECURSIVE,
48     COLOR_SEARCH_BRUTEFORCE,
49     NB_COLOR_SEARCHES
50 };
51
52 enum diff_mode {
53     DIFF_MODE_NONE,
54     DIFF_MODE_RECTANGLE,
55     NB_DIFF_MODE
56 };
57
58 struct color_node {
59     uint8_t val[4];
60     uint8_t palette_id;
61     int split;
62     int left_id, right_id;
63 };
64
65 #define NBITS 5
66 #define CACHE_SIZE (1<<(3*NBITS))
67
68 struct cached_color {
69     uint32_t color;
70     uint8_t pal_entry;
71 };
72
73 struct cache_node {
74     struct cached_color *entries;
75     int nb_entries;
76 };
77
78 struct PaletteUseContext;
79
80 typedef int (*set_frame_func)(struct PaletteUseContext *s, AVFrame *out, AVFrame *in,
81                               int x_start, int y_start, int width, int height);
82
83 typedef struct PaletteUseContext {
84     const AVClass *class;
85     FFFrameSync fs;
86     struct cache_node cache[CACHE_SIZE];    /* lookup cache */
87     struct color_node map[AVPALETTE_COUNT]; /* 3D-Tree (KD-Tree with K=3) for reverse colormap */
88     uint32_t palette[AVPALETTE_COUNT];
89     int transparency_index; /* index in the palette of transparency. -1 if there is no transparency in the palette. */
90     int trans_thresh;
91     int palette_loaded;
92     int dither;
93     int new;
94     set_frame_func set_frame;
95     int bayer_scale;
96     int ordered_dither[8*8];
97     int diff_mode;
98     AVFrame *last_in;
99     AVFrame *last_out;
100
101     /* debug options */
102     char *dot_filename;
103     int color_search_method;
104     int calc_mean_err;
105     uint64_t total_mean_err;
106     int debug_accuracy;
107 } PaletteUseContext;
108
109 #define OFFSET(x) offsetof(PaletteUseContext, x)
110 #define FLAGS AV_OPT_FLAG_FILTERING_PARAM|AV_OPT_FLAG_VIDEO_PARAM
111 static const AVOption paletteuse_options[] = {
112     { "dither", "select dithering mode", OFFSET(dither), AV_OPT_TYPE_INT, {.i64=DITHERING_SIERRA2_4A}, 0, NB_DITHERING-1, FLAGS, "dithering_mode" },
113         { "bayer",           "ordered 8x8 bayer dithering (deterministic)",                            0, AV_OPT_TYPE_CONST, {.i64=DITHERING_BAYER},           INT_MIN, INT_MAX, FLAGS, "dithering_mode" },
114         { "heckbert",        "dithering as defined by Paul Heckbert in 1982 (simple error diffusion)", 0, AV_OPT_TYPE_CONST, {.i64=DITHERING_HECKBERT},        INT_MIN, INT_MAX, FLAGS, "dithering_mode" },
115         { "floyd_steinberg", "Floyd and Steingberg dithering (error diffusion)",                       0, AV_OPT_TYPE_CONST, {.i64=DITHERING_FLOYD_STEINBERG}, INT_MIN, INT_MAX, FLAGS, "dithering_mode" },
116         { "sierra2",         "Frankie Sierra dithering v2 (error diffusion)",                          0, AV_OPT_TYPE_CONST, {.i64=DITHERING_SIERRA2},         INT_MIN, INT_MAX, FLAGS, "dithering_mode" },
117         { "sierra2_4a",      "Frankie Sierra dithering v2 \"Lite\" (error diffusion)",                 0, AV_OPT_TYPE_CONST, {.i64=DITHERING_SIERRA2_4A},      INT_MIN, INT_MAX, FLAGS, "dithering_mode" },
118     { "bayer_scale", "set scale for bayer dithering", OFFSET(bayer_scale), AV_OPT_TYPE_INT, {.i64=2}, 0, 5, FLAGS },
119     { "diff_mode",   "set frame difference mode",     OFFSET(diff_mode),   AV_OPT_TYPE_INT, {.i64=DIFF_MODE_NONE}, 0, NB_DIFF_MODE-1, FLAGS, "diff_mode" },
120         { "rectangle", "process smallest different rectangle", 0, AV_OPT_TYPE_CONST, {.i64=DIFF_MODE_RECTANGLE}, INT_MIN, INT_MAX, FLAGS, "diff_mode" },
121     { "new", "take new palette for each output frame", OFFSET(new), AV_OPT_TYPE_BOOL, {.i64=0}, 0, 1, FLAGS },
122     { "alpha_threshold", "set the alpha threshold for transparency", OFFSET(trans_thresh), AV_OPT_TYPE_INT, {.i64=128}, 0, 255, FLAGS },
123
124     /* following are the debug options, not part of the official API */
125     { "debug_kdtree", "save Graphviz graph of the kdtree in specified file", OFFSET(dot_filename), AV_OPT_TYPE_STRING, {.str=NULL}, 0, 0, FLAGS },
126     { "color_search", "set reverse colormap color search method", OFFSET(color_search_method), AV_OPT_TYPE_INT, {.i64=COLOR_SEARCH_NNS_ITERATIVE}, 0, NB_COLOR_SEARCHES-1, FLAGS, "search" },
127         { "nns_iterative", "iterative search",             0, AV_OPT_TYPE_CONST, {.i64=COLOR_SEARCH_NNS_ITERATIVE}, INT_MIN, INT_MAX, FLAGS, "search" },
128         { "nns_recursive", "recursive search",             0, AV_OPT_TYPE_CONST, {.i64=COLOR_SEARCH_NNS_RECURSIVE}, INT_MIN, INT_MAX, FLAGS, "search" },
129         { "bruteforce",    "brute-force into the palette", 0, AV_OPT_TYPE_CONST, {.i64=COLOR_SEARCH_BRUTEFORCE},    INT_MIN, INT_MAX, FLAGS, "search" },
130     { "mean_err", "compute and print mean error", OFFSET(calc_mean_err), AV_OPT_TYPE_BOOL, {.i64=0}, 0, 1, FLAGS },
131     { "debug_accuracy", "test color search accuracy", OFFSET(debug_accuracy), AV_OPT_TYPE_BOOL, {.i64=0}, 0, 1, FLAGS },
132     { NULL }
133 };
134
135 AVFILTER_DEFINE_CLASS(paletteuse);
136
137 static int load_apply_palette(FFFrameSync *fs);
138
139 static int query_formats(AVFilterContext *ctx)
140 {
141     static const enum AVPixelFormat in_fmts[]    = {AV_PIX_FMT_RGB32, AV_PIX_FMT_NONE};
142     static const enum AVPixelFormat inpal_fmts[] = {AV_PIX_FMT_RGB32, AV_PIX_FMT_NONE};
143     static const enum AVPixelFormat out_fmts[]   = {AV_PIX_FMT_PAL8,  AV_PIX_FMT_NONE};
144     int ret;
145     if ((ret = ff_formats_ref(ff_make_format_list(in_fmts),
146                               &ctx->inputs[0]->outcfg.formats)) < 0 ||
147         (ret = ff_formats_ref(ff_make_format_list(inpal_fmts),
148                               &ctx->inputs[1]->outcfg.formats)) < 0 ||
149         (ret = ff_formats_ref(ff_make_format_list(out_fmts),
150                               &ctx->outputs[0]->incfg.formats)) < 0)
151         return ret;
152     return 0;
153 }
154
155 static av_always_inline uint32_t dither_color(uint32_t px, int er, int eg,
156                                               int eb, int scale, int shift)
157 {
158     return                px >> 24                                        << 24
159          | av_clip_uint8((px >> 16 & 0xff) + ((er * scale) / (1<<shift))) << 16
160          | av_clip_uint8((px >>  8 & 0xff) + ((eg * scale) / (1<<shift))) <<  8
161          | av_clip_uint8((px       & 0xff) + ((eb * scale) / (1<<shift)));
162 }
163
164 static av_always_inline int diff(const uint8_t *c1, const uint8_t *c2, const int trans_thresh)
165 {
166     // XXX: try L*a*b with CIE76 (dL*dL + da*da + db*db)
167     const int dr = c1[1] - c2[1];
168     const int dg = c1[2] - c2[2];
169     const int db = c1[3] - c2[3];
170
171     if (c1[0] < trans_thresh && c2[0] < trans_thresh) {
172         return 0;
173     } else if (c1[0] >= trans_thresh && c2[0] >= trans_thresh) {
174         return dr*dr + dg*dg + db*db;
175     } else {
176         return 255*255 + 255*255 + 255*255;
177     }
178 }
179
180 static av_always_inline uint8_t colormap_nearest_bruteforce(const uint32_t *palette, const uint8_t *argb, const int trans_thresh)
181 {
182     int i, pal_id = -1, min_dist = INT_MAX;
183
184     for (i = 0; i < AVPALETTE_COUNT; i++) {
185         const uint32_t c = palette[i];
186
187         if (c >> 24 >= trans_thresh) { // ignore transparent entry
188             const uint8_t palargb[] = {
189                 palette[i]>>24 & 0xff,
190                 palette[i]>>16 & 0xff,
191                 palette[i]>> 8 & 0xff,
192                 palette[i]     & 0xff,
193             };
194             const int d = diff(palargb, argb, trans_thresh);
195             if (d < min_dist) {
196                 pal_id = i;
197                 min_dist = d;
198             }
199         }
200     }
201     return pal_id;
202 }
203
204 /* Recursive form, simpler but a bit slower. Kept for reference. */
205 struct nearest_color {
206     int node_pos;
207     int dist_sqd;
208 };
209
210 static void colormap_nearest_node(const struct color_node *map,
211                                   const int node_pos,
212                                   const uint8_t *target,
213                                   const int trans_thresh,
214                                   struct nearest_color *nearest)
215 {
216     const struct color_node *kd = map + node_pos;
217     const int s = kd->split;
218     int dx, nearer_kd_id, further_kd_id;
219     const uint8_t *current = kd->val;
220     const int current_to_target = diff(target, current, trans_thresh);
221
222     if (current_to_target < nearest->dist_sqd) {
223         nearest->node_pos = node_pos;
224         nearest->dist_sqd = current_to_target;
225     }
226
227     if (kd->left_id != -1 || kd->right_id != -1) {
228         dx = target[s] - current[s];
229
230         if (dx <= 0) nearer_kd_id = kd->left_id,  further_kd_id = kd->right_id;
231         else         nearer_kd_id = kd->right_id, further_kd_id = kd->left_id;
232
233         if (nearer_kd_id != -1)
234             colormap_nearest_node(map, nearer_kd_id, target, trans_thresh, nearest);
235
236         if (further_kd_id != -1 && dx*dx < nearest->dist_sqd)
237             colormap_nearest_node(map, further_kd_id, target, trans_thresh, nearest);
238     }
239 }
240
241 static av_always_inline uint8_t colormap_nearest_recursive(const struct color_node *node, const uint8_t *rgb, const int trans_thresh)
242 {
243     struct nearest_color res = {.dist_sqd = INT_MAX, .node_pos = -1};
244     colormap_nearest_node(node, 0, rgb, trans_thresh, &res);
245     return node[res.node_pos].palette_id;
246 }
247
248 struct stack_node {
249     int color_id;
250     int dx2;
251 };
252
253 static av_always_inline uint8_t colormap_nearest_iterative(const struct color_node *root, const uint8_t *target, const int trans_thresh)
254 {
255     int pos = 0, best_node_id = -1, best_dist = INT_MAX, cur_color_id = 0;
256     struct stack_node nodes[16];
257     struct stack_node *node = &nodes[0];
258
259     for (;;) {
260
261         const struct color_node *kd = &root[cur_color_id];
262         const uint8_t *current = kd->val;
263         const int current_to_target = diff(target, current, trans_thresh);
264
265         /* Compare current color node to the target and update our best node if
266          * it's actually better. */
267         if (current_to_target < best_dist) {
268             best_node_id = cur_color_id;
269             if (!current_to_target)
270                 goto end; // exact match, we can return immediately
271             best_dist = current_to_target;
272         }
273
274         /* Check if it's not a leaf */
275         if (kd->left_id != -1 || kd->right_id != -1) {
276             const int split = kd->split;
277             const int dx = target[split] - current[split];
278             int nearer_kd_id, further_kd_id;
279
280             /* Define which side is the most interesting. */
281             if (dx <= 0) nearer_kd_id = kd->left_id,  further_kd_id = kd->right_id;
282             else         nearer_kd_id = kd->right_id, further_kd_id = kd->left_id;
283
284             if (nearer_kd_id != -1) {
285                 if (further_kd_id != -1) {
286                     /* Here, both paths are defined, so we push a state for
287                      * when we are going back. */
288                     node->color_id = further_kd_id;
289                     node->dx2 = dx*dx;
290                     pos++;
291                     node++;
292                 }
293                 /* We can now update current color with the most probable path
294                  * (no need to create a state since there is nothing to save
295                  * anymore). */
296                 cur_color_id = nearer_kd_id;
297                 continue;
298             } else if (dx*dx < best_dist) {
299                 /* The nearest path isn't available, so there is only one path
300                  * possible and it's the least probable. We enter it only if the
301                  * distance from the current point to the hyper rectangle is
302                  * less than our best distance. */
303                 cur_color_id = further_kd_id;
304                 continue;
305             }
306         }
307
308         /* Unstack as much as we can, typically as long as the least probable
309          * branch aren't actually probable. */
310         do {
311             if (--pos < 0)
312                 goto end;
313             node--;
314         } while (node->dx2 >= best_dist);
315
316         /* We got a node where the least probable branch might actually contain
317          * a relevant color. */
318         cur_color_id = node->color_id;
319     }
320
321 end:
322     return root[best_node_id].palette_id;
323 }
324
325 #define COLORMAP_NEAREST(search, palette, root, target, trans_thresh)                                    \
326     search == COLOR_SEARCH_NNS_ITERATIVE ? colormap_nearest_iterative(root, target, trans_thresh) :      \
327     search == COLOR_SEARCH_NNS_RECURSIVE ? colormap_nearest_recursive(root, target, trans_thresh) :      \
328                                            colormap_nearest_bruteforce(palette, target, trans_thresh)
329
330 /**
331  * Check if the requested color is in the cache already. If not, find it in the
332  * color tree and cache it.
333  * Note: a, r, g, and b are the components of color, but are passed as well to avoid
334  * recomputing them (they are generally computed by the caller for other uses).
335  */
336 static av_always_inline int color_get(PaletteUseContext *s, uint32_t color,
337                                       uint8_t a, uint8_t r, uint8_t g, uint8_t b,
338                                       const enum color_search_method search_method)
339 {
340     int i;
341     const uint8_t argb_elts[] = {a, r, g, b};
342     const uint8_t rhash = r & ((1<<NBITS)-1);
343     const uint8_t ghash = g & ((1<<NBITS)-1);
344     const uint8_t bhash = b & ((1<<NBITS)-1);
345     const unsigned hash = rhash<<(NBITS*2) | ghash<<NBITS | bhash;
346     struct cache_node *node = &s->cache[hash];
347     struct cached_color *e;
348
349     // first, check for transparency
350     if (a < s->trans_thresh && s->transparency_index >= 0) {
351         return s->transparency_index;
352     }
353
354     for (i = 0; i < node->nb_entries; i++) {
355         e = &node->entries[i];
356         if (e->color == color)
357             return e->pal_entry;
358     }
359
360     e = av_dynarray2_add((void**)&node->entries, &node->nb_entries,
361                          sizeof(*node->entries), NULL);
362     if (!e)
363         return AVERROR(ENOMEM);
364     e->color = color;
365     e->pal_entry = COLORMAP_NEAREST(search_method, s->palette, s->map, argb_elts, s->trans_thresh);
366
367     return e->pal_entry;
368 }
369
370 static av_always_inline int get_dst_color_err(PaletteUseContext *s,
371                                               uint32_t c, int *er, int *eg, int *eb,
372                                               const enum color_search_method search_method)
373 {
374     const uint8_t a = c >> 24 & 0xff;
375     const uint8_t r = c >> 16 & 0xff;
376     const uint8_t g = c >>  8 & 0xff;
377     const uint8_t b = c       & 0xff;
378     uint32_t dstc;
379     const int dstx = color_get(s, c, a, r, g, b, search_method);
380     if (dstx < 0)
381         return dstx;
382     dstc = s->palette[dstx];
383     *er = r - (dstc >> 16 & 0xff);
384     *eg = g - (dstc >>  8 & 0xff);
385     *eb = b - (dstc       & 0xff);
386     return dstx;
387 }
388
389 static av_always_inline int set_frame(PaletteUseContext *s, AVFrame *out, AVFrame *in,
390                                       int x_start, int y_start, int w, int h,
391                                       enum dithering_mode dither,
392                                       const enum color_search_method search_method)
393 {
394     int x, y;
395     const int src_linesize = in ->linesize[0] >> 2;
396     const int dst_linesize = out->linesize[0];
397     uint32_t *src = ((uint32_t *)in ->data[0]) + y_start*src_linesize;
398     uint8_t  *dst =              out->data[0]  + y_start*dst_linesize;
399
400     w += x_start;
401     h += y_start;
402
403     for (y = y_start; y < h; y++) {
404         for (x = x_start; x < w; x++) {
405             int er, eg, eb;
406
407             if (dither == DITHERING_BAYER) {
408                 const int d = s->ordered_dither[(y & 7)<<3 | (x & 7)];
409                 const uint8_t a8 = src[x] >> 24 & 0xff;
410                 const uint8_t r8 = src[x] >> 16 & 0xff;
411                 const uint8_t g8 = src[x] >>  8 & 0xff;
412                 const uint8_t b8 = src[x]       & 0xff;
413                 const uint8_t r = av_clip_uint8(r8 + d);
414                 const uint8_t g = av_clip_uint8(g8 + d);
415                 const uint8_t b = av_clip_uint8(b8 + d);
416                 const int color = color_get(s, src[x], a8, r, g, b, search_method);
417
418                 if (color < 0)
419                     return color;
420                 dst[x] = color;
421
422             } else if (dither == DITHERING_HECKBERT) {
423                 const int right = x < w - 1, down = y < h - 1;
424                 const int color = get_dst_color_err(s, src[x], &er, &eg, &eb, search_method);
425
426                 if (color < 0)
427                     return color;
428                 dst[x] = color;
429
430                 if (right)         src[               x + 1] = dither_color(src[               x + 1], er, eg, eb, 3, 3);
431                 if (         down) src[src_linesize + x    ] = dither_color(src[src_linesize + x    ], er, eg, eb, 3, 3);
432                 if (right && down) src[src_linesize + x + 1] = dither_color(src[src_linesize + x + 1], er, eg, eb, 2, 3);
433
434             } else if (dither == DITHERING_FLOYD_STEINBERG) {
435                 const int right = x < w - 1, down = y < h - 1, left = x > x_start;
436                 const int color = get_dst_color_err(s, src[x], &er, &eg, &eb, search_method);
437
438                 if (color < 0)
439                     return color;
440                 dst[x] = color;
441
442                 if (right)         src[               x + 1] = dither_color(src[               x + 1], er, eg, eb, 7, 4);
443                 if (left  && down) src[src_linesize + x - 1] = dither_color(src[src_linesize + x - 1], er, eg, eb, 3, 4);
444                 if (         down) src[src_linesize + x    ] = dither_color(src[src_linesize + x    ], er, eg, eb, 5, 4);
445                 if (right && down) src[src_linesize + x + 1] = dither_color(src[src_linesize + x + 1], er, eg, eb, 1, 4);
446
447             } else if (dither == DITHERING_SIERRA2) {
448                 const int right  = x < w - 1, down  = y < h - 1, left  = x > x_start;
449                 const int right2 = x < w - 2,                    left2 = x > x_start + 1;
450                 const int color = get_dst_color_err(s, src[x], &er, &eg, &eb, search_method);
451
452                 if (color < 0)
453                     return color;
454                 dst[x] = color;
455
456                 if (right)          src[                 x + 1] = dither_color(src[                 x + 1], er, eg, eb, 4, 4);
457                 if (right2)         src[                 x + 2] = dither_color(src[                 x + 2], er, eg, eb, 3, 4);
458
459                 if (down) {
460                     if (left2)      src[  src_linesize + x - 2] = dither_color(src[  src_linesize + x - 2], er, eg, eb, 1, 4);
461                     if (left)       src[  src_linesize + x - 1] = dither_color(src[  src_linesize + x - 1], er, eg, eb, 2, 4);
462                     if (1)          src[  src_linesize + x    ] = dither_color(src[  src_linesize + x    ], er, eg, eb, 3, 4);
463                     if (right)      src[  src_linesize + x + 1] = dither_color(src[  src_linesize + x + 1], er, eg, eb, 2, 4);
464                     if (right2)     src[  src_linesize + x + 2] = dither_color(src[  src_linesize + x + 2], er, eg, eb, 1, 4);
465                 }
466
467             } else if (dither == DITHERING_SIERRA2_4A) {
468                 const int right = x < w - 1, down = y < h - 1, left = x > x_start;
469                 const int color = get_dst_color_err(s, src[x], &er, &eg, &eb, search_method);
470
471                 if (color < 0)
472                     return color;
473                 dst[x] = color;
474
475                 if (right)         src[               x + 1] = dither_color(src[               x + 1], er, eg, eb, 2, 2);
476                 if (left  && down) src[src_linesize + x - 1] = dither_color(src[src_linesize + x - 1], er, eg, eb, 1, 2);
477                 if (         down) src[src_linesize + x    ] = dither_color(src[src_linesize + x    ], er, eg, eb, 1, 2);
478
479             } else {
480                 const uint8_t a = src[x] >> 24 & 0xff;
481                 const uint8_t r = src[x] >> 16 & 0xff;
482                 const uint8_t g = src[x] >>  8 & 0xff;
483                 const uint8_t b = src[x]       & 0xff;
484                 const int color = color_get(s, src[x], a, r, g, b, search_method);
485
486                 if (color < 0)
487                     return color;
488                 dst[x] = color;
489             }
490         }
491         src += src_linesize;
492         dst += dst_linesize;
493     }
494     return 0;
495 }
496
497 #define INDENT 4
498 static void disp_node(AVBPrint *buf,
499                       const struct color_node *map,
500                       int parent_id, int node_id,
501                       int depth)
502 {
503     const struct color_node *node = &map[node_id];
504     const uint32_t fontcolor = node->val[1] > 0x50 &&
505                                node->val[2] > 0x50 &&
506                                node->val[3] > 0x50 ? 0 : 0xffffff;
507     const int rgb_comp = node->split - 1;
508     av_bprintf(buf, "%*cnode%d ["
509                "label=\"%c%02X%c%02X%c%02X%c\" "
510                "fillcolor=\"#%02x%02x%02x\" "
511                "fontcolor=\"#%06"PRIX32"\"]\n",
512                depth*INDENT, ' ', node->palette_id,
513                "[  "[rgb_comp], node->val[1],
514                "][ "[rgb_comp], node->val[2],
515                " ]["[rgb_comp], node->val[3],
516                "  ]"[rgb_comp],
517                node->val[1], node->val[2], node->val[3],
518                fontcolor);
519     if (parent_id != -1)
520         av_bprintf(buf, "%*cnode%d -> node%d\n", depth*INDENT, ' ',
521                    map[parent_id].palette_id, node->palette_id);
522     if (node->left_id  != -1) disp_node(buf, map, node_id, node->left_id,  depth + 1);
523     if (node->right_id != -1) disp_node(buf, map, node_id, node->right_id, depth + 1);
524 }
525
526 // debug_kdtree=kdtree.dot -> dot -Tpng kdtree.dot > kdtree.png
527 static int disp_tree(const struct color_node *node, const char *fname)
528 {
529     AVBPrint buf;
530     FILE *f = av_fopen_utf8(fname, "w");
531
532     if (!f) {
533         int ret = AVERROR(errno);
534         av_log(NULL, AV_LOG_ERROR, "Cannot open file '%s' for writing: %s\n",
535                fname, av_err2str(ret));
536         return ret;
537     }
538
539     av_bprint_init(&buf, 0, AV_BPRINT_SIZE_UNLIMITED);
540
541     av_bprintf(&buf, "digraph {\n");
542     av_bprintf(&buf, "    node [style=filled fontsize=10 shape=box]\n");
543     disp_node(&buf, node, -1, 0, 0);
544     av_bprintf(&buf, "}\n");
545
546     fwrite(buf.str, 1, buf.len, f);
547     fclose(f);
548     av_bprint_finalize(&buf, NULL);
549     return 0;
550 }
551
552 static int debug_accuracy(const struct color_node *node, const uint32_t *palette, const int trans_thresh,
553                           const enum color_search_method search_method)
554 {
555     int r, g, b, ret = 0;
556
557     for (r = 0; r < 256; r++) {
558         for (g = 0; g < 256; g++) {
559             for (b = 0; b < 256; b++) {
560                 const uint8_t argb[] = {0xff, r, g, b};
561                 const int r1 = COLORMAP_NEAREST(search_method, palette, node, argb, trans_thresh);
562                 const int r2 = colormap_nearest_bruteforce(palette, argb, trans_thresh);
563                 if (r1 != r2) {
564                     const uint32_t c1 = palette[r1];
565                     const uint32_t c2 = palette[r2];
566                     const uint8_t palargb1[] = { 0xff, c1>>16 & 0xff, c1>> 8 & 0xff, c1 & 0xff };
567                     const uint8_t palargb2[] = { 0xff, c2>>16 & 0xff, c2>> 8 & 0xff, c2 & 0xff };
568                     const int d1 = diff(palargb1, argb, trans_thresh);
569                     const int d2 = diff(palargb2, argb, trans_thresh);
570                     if (d1 != d2) {
571                         av_log(NULL, AV_LOG_ERROR,
572                                "/!\\ %02X%02X%02X: %d ! %d (%06"PRIX32" ! %06"PRIX32") / dist: %d ! %d\n",
573                                r, g, b, r1, r2, c1 & 0xffffff, c2 & 0xffffff, d1, d2);
574                         ret = 1;
575                     }
576                 }
577             }
578         }
579     }
580     return ret;
581 }
582
583 struct color {
584     uint32_t value;
585     uint8_t pal_id;
586 };
587
588 struct color_rect {
589     uint8_t min[3];
590     uint8_t max[3];
591 };
592
593 typedef int (*cmp_func)(const void *, const void *);
594
595 #define DECLARE_CMP_FUNC(name, pos)                     \
596 static int cmp_##name(const void *pa, const void *pb)   \
597 {                                                       \
598     const struct color *a = pa;                         \
599     const struct color *b = pb;                         \
600     return   (a->value >> (8 * (3 - (pos))) & 0xff)     \
601            - (b->value >> (8 * (3 - (pos))) & 0xff);    \
602 }
603
604 DECLARE_CMP_FUNC(a, 0)
605 DECLARE_CMP_FUNC(r, 1)
606 DECLARE_CMP_FUNC(g, 2)
607 DECLARE_CMP_FUNC(b, 3)
608
609 static const cmp_func cmp_funcs[] = {cmp_a, cmp_r, cmp_g, cmp_b};
610
611 static int get_next_color(const uint8_t *color_used, const uint32_t *palette,
612                           const int trans_thresh,
613                           int *component, const struct color_rect *box)
614 {
615     int wr, wg, wb;
616     int i, longest = 0;
617     unsigned nb_color = 0;
618     struct color_rect ranges;
619     struct color tmp_pal[256];
620     cmp_func cmpf;
621
622     ranges.min[0] = ranges.min[1] = ranges.min[2] = 0xff;
623     ranges.max[0] = ranges.max[1] = ranges.max[2] = 0x00;
624
625     for (i = 0; i < AVPALETTE_COUNT; i++) {
626         const uint32_t c = palette[i];
627         const uint8_t a = c >> 24 & 0xff;
628         const uint8_t r = c >> 16 & 0xff;
629         const uint8_t g = c >>  8 & 0xff;
630         const uint8_t b = c       & 0xff;
631
632         if (a < trans_thresh) {
633             continue;
634         }
635
636         if (color_used[i] || (a != 0xff) ||
637             r < box->min[0] || g < box->min[1] || b < box->min[2] ||
638             r > box->max[0] || g > box->max[1] || b > box->max[2])
639             continue;
640
641         if (r < ranges.min[0]) ranges.min[0] = r;
642         if (g < ranges.min[1]) ranges.min[1] = g;
643         if (b < ranges.min[2]) ranges.min[2] = b;
644
645         if (r > ranges.max[0]) ranges.max[0] = r;
646         if (g > ranges.max[1]) ranges.max[1] = g;
647         if (b > ranges.max[2]) ranges.max[2] = b;
648
649         tmp_pal[nb_color].value  = c;
650         tmp_pal[nb_color].pal_id = i;
651
652         nb_color++;
653     }
654
655     if (!nb_color)
656         return -1;
657
658     /* define longest axis that will be the split component */
659     wr = ranges.max[0] - ranges.min[0];
660     wg = ranges.max[1] - ranges.min[1];
661     wb = ranges.max[2] - ranges.min[2];
662     if (wr >= wg && wr >= wb) longest = 1;
663     if (wg >= wr && wg >= wb) longest = 2;
664     if (wb >= wr && wb >= wg) longest = 3;
665     cmpf = cmp_funcs[longest];
666     *component = longest;
667
668     /* sort along this axis to get median */
669     AV_QSORT(tmp_pal, nb_color, struct color, cmpf);
670
671     return tmp_pal[nb_color >> 1].pal_id;
672 }
673
674 static int colormap_insert(struct color_node *map,
675                            uint8_t *color_used,
676                            int *nb_used,
677                            const uint32_t *palette,
678                            const int trans_thresh,
679                            const struct color_rect *box)
680 {
681     uint32_t c;
682     int component, cur_id;
683     int node_left_id = -1, node_right_id = -1;
684     struct color_node *node;
685     struct color_rect box1, box2;
686     const int pal_id = get_next_color(color_used, palette, trans_thresh, &component, box);
687
688     if (pal_id < 0)
689         return -1;
690
691     /* create new node with that color */
692     cur_id = (*nb_used)++;
693     c = palette[pal_id];
694     node = &map[cur_id];
695     node->split = component;
696     node->palette_id = pal_id;
697     node->val[0] = c>>24 & 0xff;
698     node->val[1] = c>>16 & 0xff;
699     node->val[2] = c>> 8 & 0xff;
700     node->val[3] = c     & 0xff;
701
702     color_used[pal_id] = 1;
703
704     /* get the two boxes this node creates */
705     box1 = box2 = *box;
706     box1.max[component-1] = node->val[component];
707     box2.min[component-1] = node->val[component] + 1;
708
709     node_left_id = colormap_insert(map, color_used, nb_used, palette, trans_thresh, &box1);
710
711     if (box2.min[component-1] <= box2.max[component-1])
712         node_right_id = colormap_insert(map, color_used, nb_used, palette, trans_thresh, &box2);
713
714     node->left_id  = node_left_id;
715     node->right_id = node_right_id;
716
717     return cur_id;
718 }
719
720 static int cmp_pal_entry(const void *a, const void *b)
721 {
722     const int c1 = *(const uint32_t *)a & 0xffffff;
723     const int c2 = *(const uint32_t *)b & 0xffffff;
724     return c1 - c2;
725 }
726
727 static void load_colormap(PaletteUseContext *s)
728 {
729     int i, nb_used = 0;
730     uint8_t color_used[AVPALETTE_COUNT] = {0};
731     uint32_t last_color = 0;
732     struct color_rect box;
733
734     /* disable transparent colors and dups */
735     qsort(s->palette, AVPALETTE_COUNT, sizeof(*s->palette), cmp_pal_entry);
736     // update transparency index:
737     if (s->transparency_index >= 0) {
738         for (i = 0; i < AVPALETTE_COUNT; i++) {
739             if ((s->palette[i]>>24 & 0xff) == 0) {
740                 s->transparency_index = i; // we are assuming at most one transparent color in palette
741                 break;
742             }
743         }
744     }
745
746     for (i = 0; i < AVPALETTE_COUNT; i++) {
747         const uint32_t c = s->palette[i];
748         if (i != 0 && c == last_color) {
749             color_used[i] = 1;
750             continue;
751         }
752         last_color = c;
753         if (c >> 24 < s->trans_thresh) {
754             color_used[i] = 1; // ignore transparent color(s)
755             continue;
756         }
757     }
758
759     box.min[0] = box.min[1] = box.min[2] = 0x00;
760     box.max[0] = box.max[1] = box.max[2] = 0xff;
761
762     colormap_insert(s->map, color_used, &nb_used, s->palette, s->trans_thresh, &box);
763
764     if (s->dot_filename)
765         disp_tree(s->map, s->dot_filename);
766
767     if (s->debug_accuracy) {
768         if (!debug_accuracy(s->map, s->palette, s->trans_thresh, s->color_search_method))
769             av_log(NULL, AV_LOG_INFO, "Accuracy check passed\n");
770     }
771 }
772
773 static void debug_mean_error(PaletteUseContext *s, const AVFrame *in1,
774                              const AVFrame *in2, int frame_count)
775 {
776     int x, y;
777     const uint32_t *palette = s->palette;
778     uint32_t *src1 = (uint32_t *)in1->data[0];
779     uint8_t  *src2 =             in2->data[0];
780     const int src1_linesize = in1->linesize[0] >> 2;
781     const int src2_linesize = in2->linesize[0];
782     const float div = in1->width * in1->height * 3;
783     unsigned mean_err = 0;
784
785     for (y = 0; y < in1->height; y++) {
786         for (x = 0; x < in1->width; x++) {
787             const uint32_t c1 = src1[x];
788             const uint32_t c2 = palette[src2[x]];
789             const uint8_t argb1[] = {0xff, c1 >> 16 & 0xff, c1 >> 8 & 0xff, c1 & 0xff};
790             const uint8_t argb2[] = {0xff, c2 >> 16 & 0xff, c2 >> 8 & 0xff, c2 & 0xff};
791             mean_err += diff(argb1, argb2, s->trans_thresh);
792         }
793         src1 += src1_linesize;
794         src2 += src2_linesize;
795     }
796
797     s->total_mean_err += mean_err;
798
799     av_log(NULL, AV_LOG_INFO, "MEP:%.3f TotalMEP:%.3f\n",
800            mean_err / div, s->total_mean_err / (div * frame_count));
801 }
802
803 static void set_processing_window(enum diff_mode diff_mode,
804                                   const AVFrame *prv_src, const AVFrame *cur_src,
805                                   const AVFrame *prv_dst,       AVFrame *cur_dst,
806                                   int *xp, int *yp, int *wp, int *hp)
807 {
808     int x_start = 0, y_start = 0;
809     int width  = cur_src->width;
810     int height = cur_src->height;
811
812     if (prv_src->data[0] && diff_mode == DIFF_MODE_RECTANGLE) {
813         int y;
814         int x_end = cur_src->width  - 1,
815             y_end = cur_src->height - 1;
816         const uint32_t *prv_srcp = (const uint32_t *)prv_src->data[0];
817         const uint32_t *cur_srcp = (const uint32_t *)cur_src->data[0];
818         const uint8_t  *prv_dstp = prv_dst->data[0];
819         uint8_t        *cur_dstp = cur_dst->data[0];
820
821         const int prv_src_linesize = prv_src->linesize[0] >> 2;
822         const int cur_src_linesize = cur_src->linesize[0] >> 2;
823         const int prv_dst_linesize = prv_dst->linesize[0];
824         const int cur_dst_linesize = cur_dst->linesize[0];
825
826         /* skip common lines */
827         while (y_start < y_end && !memcmp(prv_srcp + y_start*prv_src_linesize,
828                                           cur_srcp + y_start*cur_src_linesize,
829                                           cur_src->width * 4)) {
830             memcpy(cur_dstp + y_start*cur_dst_linesize,
831                    prv_dstp + y_start*prv_dst_linesize,
832                    cur_dst->width);
833             y_start++;
834         }
835         while (y_end > y_start && !memcmp(prv_srcp + y_end*prv_src_linesize,
836                                           cur_srcp + y_end*cur_src_linesize,
837                                           cur_src->width * 4)) {
838             memcpy(cur_dstp + y_end*cur_dst_linesize,
839                    prv_dstp + y_end*prv_dst_linesize,
840                    cur_dst->width);
841             y_end--;
842         }
843
844         height = y_end + 1 - y_start;
845
846         /* skip common columns */
847         while (x_start < x_end) {
848             int same_column = 1;
849             for (y = y_start; y <= y_end; y++) {
850                 if (prv_srcp[y*prv_src_linesize + x_start] != cur_srcp[y*cur_src_linesize + x_start]) {
851                     same_column = 0;
852                     break;
853                 }
854             }
855             if (!same_column)
856                 break;
857             x_start++;
858         }
859         while (x_end > x_start) {
860             int same_column = 1;
861             for (y = y_start; y <= y_end; y++) {
862                 if (prv_srcp[y*prv_src_linesize + x_end] != cur_srcp[y*cur_src_linesize + x_end]) {
863                     same_column = 0;
864                     break;
865                 }
866             }
867             if (!same_column)
868                 break;
869             x_end--;
870         }
871         width = x_end + 1 - x_start;
872
873         if (x_start) {
874             for (y = y_start; y <= y_end; y++)
875                 memcpy(cur_dstp + y*cur_dst_linesize,
876                        prv_dstp + y*prv_dst_linesize, x_start);
877         }
878         if (x_end != cur_src->width - 1) {
879             const int copy_len = cur_src->width - 1 - x_end;
880             for (y = y_start; y <= y_end; y++)
881                 memcpy(cur_dstp + y*cur_dst_linesize + x_end + 1,
882                        prv_dstp + y*prv_dst_linesize + x_end + 1,
883                        copy_len);
884         }
885     }
886     *xp = x_start;
887     *yp = y_start;
888     *wp = width;
889     *hp = height;
890 }
891
892 static int apply_palette(AVFilterLink *inlink, AVFrame *in, AVFrame **outf)
893 {
894     int x, y, w, h, ret;
895     AVFilterContext *ctx = inlink->dst;
896     PaletteUseContext *s = ctx->priv;
897     AVFilterLink *outlink = inlink->dst->outputs[0];
898
899     AVFrame *out = ff_get_video_buffer(outlink, outlink->w, outlink->h);
900     if (!out) {
901         *outf = NULL;
902         return AVERROR(ENOMEM);
903     }
904     av_frame_copy_props(out, in);
905
906     set_processing_window(s->diff_mode, s->last_in, in,
907                           s->last_out, out, &x, &y, &w, &h);
908     av_frame_unref(s->last_in);
909     av_frame_unref(s->last_out);
910     if ((ret = av_frame_ref(s->last_in, in))       < 0 ||
911         (ret = av_frame_ref(s->last_out, out))     < 0 ||
912         (ret = av_frame_make_writable(s->last_in)) < 0) {
913         av_frame_free(&out);
914         *outf = NULL;
915         return ret;
916     }
917
918     ff_dlog(ctx, "%dx%d rect: (%d;%d) -> (%d,%d) [area:%dx%d]\n",
919             w, h, x, y, x+w, y+h, in->width, in->height);
920
921     ret = s->set_frame(s, out, in, x, y, w, h);
922     if (ret < 0) {
923         av_frame_free(&out);
924         *outf = NULL;
925         return ret;
926     }
927     memcpy(out->data[1], s->palette, AVPALETTE_SIZE);
928     if (s->calc_mean_err)
929         debug_mean_error(s, in, out, inlink->frame_count_out);
930     *outf = out;
931     return 0;
932 }
933
934 static int config_output(AVFilterLink *outlink)
935 {
936     int ret;
937     AVFilterContext *ctx = outlink->src;
938     PaletteUseContext *s = ctx->priv;
939
940     ret = ff_framesync_init_dualinput(&s->fs, ctx);
941     if (ret < 0)
942         return ret;
943     s->fs.opt_repeatlast = 1; // only 1 frame in the palette
944     s->fs.in[1].before = s->fs.in[1].after = EXT_INFINITY;
945     s->fs.on_event = load_apply_palette;
946
947     outlink->w = ctx->inputs[0]->w;
948     outlink->h = ctx->inputs[0]->h;
949
950     outlink->time_base = ctx->inputs[0]->time_base;
951     if ((ret = ff_framesync_configure(&s->fs)) < 0)
952         return ret;
953     return 0;
954 }
955
956 static int config_input_palette(AVFilterLink *inlink)
957 {
958     AVFilterContext *ctx = inlink->dst;
959
960     if (inlink->w * inlink->h != AVPALETTE_COUNT) {
961         av_log(ctx, AV_LOG_ERROR,
962                "Palette input must contain exactly %d pixels. "
963                "Specified input has %dx%d=%d pixels\n",
964                AVPALETTE_COUNT, inlink->w, inlink->h,
965                inlink->w * inlink->h);
966         return AVERROR(EINVAL);
967     }
968     return 0;
969 }
970
971 static void load_palette(PaletteUseContext *s, const AVFrame *palette_frame)
972 {
973     int i, x, y;
974     const uint32_t *p = (const uint32_t *)palette_frame->data[0];
975     const int p_linesize = palette_frame->linesize[0] >> 2;
976
977     s->transparency_index = -1;
978
979     if (s->new) {
980         memset(s->palette, 0, sizeof(s->palette));
981         memset(s->map, 0, sizeof(s->map));
982         for (i = 0; i < CACHE_SIZE; i++)
983             av_freep(&s->cache[i].entries);
984         memset(s->cache, 0, sizeof(s->cache));
985     }
986
987     i = 0;
988     for (y = 0; y < palette_frame->height; y++) {
989         for (x = 0; x < palette_frame->width; x++) {
990             s->palette[i] = p[x];
991             if (p[x]>>24 < s->trans_thresh) {
992                 s->transparency_index = i; // we are assuming at most one transparent color in palette
993             }
994             i++;
995         }
996         p += p_linesize;
997     }
998
999     load_colormap(s);
1000
1001     if (!s->new)
1002         s->palette_loaded = 1;
1003 }
1004
1005 static int load_apply_palette(FFFrameSync *fs)
1006 {
1007     AVFilterContext *ctx = fs->parent;
1008     AVFilterLink *inlink = ctx->inputs[0];
1009     PaletteUseContext *s = ctx->priv;
1010     AVFrame *master, *second, *out = NULL;
1011     int ret;
1012
1013     // writable for error diffusal dithering
1014     ret = ff_framesync_dualinput_get_writable(fs, &master, &second);
1015     if (ret < 0)
1016         return ret;
1017     if (!master || !second) {
1018         av_frame_free(&master);
1019         return AVERROR_BUG;
1020     }
1021     if (!s->palette_loaded) {
1022         load_palette(s, second);
1023     }
1024     ret = apply_palette(inlink, master, &out);
1025     av_frame_free(&master);
1026     if (ret < 0)
1027         return ret;
1028     return ff_filter_frame(ctx->outputs[0], out);
1029 }
1030
1031 #define DEFINE_SET_FRAME(color_search, name, value)                             \
1032 static int set_frame_##name(PaletteUseContext *s, AVFrame *out, AVFrame *in,    \
1033                             int x_start, int y_start, int w, int h)             \
1034 {                                                                               \
1035     return set_frame(s, out, in, x_start, y_start, w, h, value, color_search);  \
1036 }
1037
1038 #define DEFINE_SET_FRAME_COLOR_SEARCH(color_search, color_search_macro)                                 \
1039     DEFINE_SET_FRAME(color_search_macro, color_search##_##none,            DITHERING_NONE)              \
1040     DEFINE_SET_FRAME(color_search_macro, color_search##_##bayer,           DITHERING_BAYER)             \
1041     DEFINE_SET_FRAME(color_search_macro, color_search##_##heckbert,        DITHERING_HECKBERT)          \
1042     DEFINE_SET_FRAME(color_search_macro, color_search##_##floyd_steinberg, DITHERING_FLOYD_STEINBERG)   \
1043     DEFINE_SET_FRAME(color_search_macro, color_search##_##sierra2,         DITHERING_SIERRA2)           \
1044     DEFINE_SET_FRAME(color_search_macro, color_search##_##sierra2_4a,      DITHERING_SIERRA2_4A)        \
1045
1046 DEFINE_SET_FRAME_COLOR_SEARCH(nns_iterative, COLOR_SEARCH_NNS_ITERATIVE)
1047 DEFINE_SET_FRAME_COLOR_SEARCH(nns_recursive, COLOR_SEARCH_NNS_RECURSIVE)
1048 DEFINE_SET_FRAME_COLOR_SEARCH(bruteforce,    COLOR_SEARCH_BRUTEFORCE)
1049
1050 #define DITHERING_ENTRIES(color_search) {       \
1051     set_frame_##color_search##_none,            \
1052     set_frame_##color_search##_bayer,           \
1053     set_frame_##color_search##_heckbert,        \
1054     set_frame_##color_search##_floyd_steinberg, \
1055     set_frame_##color_search##_sierra2,         \
1056     set_frame_##color_search##_sierra2_4a,      \
1057 }
1058
1059 static const set_frame_func set_frame_lut[NB_COLOR_SEARCHES][NB_DITHERING] = {
1060     DITHERING_ENTRIES(nns_iterative),
1061     DITHERING_ENTRIES(nns_recursive),
1062     DITHERING_ENTRIES(bruteforce),
1063 };
1064
1065 static int dither_value(int p)
1066 {
1067     const int q = p ^ (p >> 3);
1068     return   (p & 4) >> 2 | (q & 4) >> 1 \
1069            | (p & 2) << 1 | (q & 2) << 2 \
1070            | (p & 1) << 4 | (q & 1) << 5;
1071 }
1072
1073 static av_cold int init(AVFilterContext *ctx)
1074 {
1075     PaletteUseContext *s = ctx->priv;
1076
1077     s->last_in  = av_frame_alloc();
1078     s->last_out = av_frame_alloc();
1079     if (!s->last_in || !s->last_out) {
1080         av_frame_free(&s->last_in);
1081         av_frame_free(&s->last_out);
1082         return AVERROR(ENOMEM);
1083     }
1084
1085     s->set_frame = set_frame_lut[s->color_search_method][s->dither];
1086
1087     if (s->dither == DITHERING_BAYER) {
1088         int i;
1089         const int delta = 1 << (5 - s->bayer_scale); // to avoid too much luma
1090
1091         for (i = 0; i < FF_ARRAY_ELEMS(s->ordered_dither); i++)
1092             s->ordered_dither[i] = (dither_value(i) >> s->bayer_scale) - delta;
1093     }
1094
1095     return 0;
1096 }
1097
1098 static int activate(AVFilterContext *ctx)
1099 {
1100     PaletteUseContext *s = ctx->priv;
1101     return ff_framesync_activate(&s->fs);
1102 }
1103
1104 static av_cold void uninit(AVFilterContext *ctx)
1105 {
1106     int i;
1107     PaletteUseContext *s = ctx->priv;
1108
1109     ff_framesync_uninit(&s->fs);
1110     for (i = 0; i < CACHE_SIZE; i++)
1111         av_freep(&s->cache[i].entries);
1112     av_frame_free(&s->last_in);
1113     av_frame_free(&s->last_out);
1114 }
1115
1116 static const AVFilterPad paletteuse_inputs[] = {
1117     {
1118         .name           = "default",
1119         .type           = AVMEDIA_TYPE_VIDEO,
1120     },{
1121         .name           = "palette",
1122         .type           = AVMEDIA_TYPE_VIDEO,
1123         .config_props   = config_input_palette,
1124     },
1125     { NULL }
1126 };
1127
1128 static const AVFilterPad paletteuse_outputs[] = {
1129     {
1130         .name          = "default",
1131         .type          = AVMEDIA_TYPE_VIDEO,
1132         .config_props  = config_output,
1133     },
1134     { NULL }
1135 };
1136
1137 const AVFilter ff_vf_paletteuse = {
1138     .name          = "paletteuse",
1139     .description   = NULL_IF_CONFIG_SMALL("Use a palette to downsample an input video stream."),
1140     .priv_size     = sizeof(PaletteUseContext),
1141     .query_formats = query_formats,
1142     .init          = init,
1143     .uninit        = uninit,
1144     .activate      = activate,
1145     .inputs        = paletteuse_inputs,
1146     .outputs       = paletteuse_outputs,
1147     .priv_class    = &paletteuse_class,
1148 };