2 * Copyright (c) 2013 Clément Bœsch
3 * Copyright (c) 2018 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
24 * 3D Lookup table filter
27 #include "libavutil/opt.h"
28 #include "libavutil/file.h"
29 #include "libavutil/intreadwrite.h"
30 #include "libavutil/avassert.h"
31 #include "libavutil/pixdesc.h"
32 #include "libavutil/avstring.h"
34 #include "drawutils.h"
36 #include "framesync.h"
47 INTERPOLATE_TRILINEAR,
48 INTERPOLATE_TETRAHEDRAL,
56 /* 3D LUT don't often go up to level 32, but it is common to have a Hald CLUT
57 * of 512x512 (64x64x64) */
60 typedef struct LUT3DContext {
62 int interpolation; ///<interp_mode
66 avfilter_action_func *interp;
68 struct rgbvec lut[MAX_LEVEL][MAX_LEVEL][MAX_LEVEL];
70 #if CONFIG_HALDCLUT_FILTER
71 uint8_t clut_rgba_map[4];
80 typedef struct ThreadData {
84 #define OFFSET(x) offsetof(LUT3DContext, x)
85 #define FLAGS AV_OPT_FLAG_FILTERING_PARAM|AV_OPT_FLAG_VIDEO_PARAM
86 #define COMMON_OPTIONS \
87 { "interp", "select interpolation mode", OFFSET(interpolation), AV_OPT_TYPE_INT, {.i64=INTERPOLATE_TETRAHEDRAL}, 0, NB_INTERP_MODE-1, FLAGS, "interp_mode" }, \
88 { "nearest", "use values from the nearest defined points", 0, AV_OPT_TYPE_CONST, {.i64=INTERPOLATE_NEAREST}, INT_MIN, INT_MAX, FLAGS, "interp_mode" }, \
89 { "trilinear", "interpolate values using the 8 points defining a cube", 0, AV_OPT_TYPE_CONST, {.i64=INTERPOLATE_TRILINEAR}, INT_MIN, INT_MAX, FLAGS, "interp_mode" }, \
90 { "tetrahedral", "interpolate values using a tetrahedron", 0, AV_OPT_TYPE_CONST, {.i64=INTERPOLATE_TETRAHEDRAL}, INT_MIN, INT_MAX, FLAGS, "interp_mode" }, \
93 static inline float lerpf(float v0, float v1, float f)
95 return v0 + (v1 - v0) * f;
98 static inline struct rgbvec lerp(const struct rgbvec *v0, const struct rgbvec *v1, float f)
101 lerpf(v0->r, v1->r, f), lerpf(v0->g, v1->g, f), lerpf(v0->b, v1->b, f)
106 #define NEAR(x) ((int)((x) + .5))
107 #define PREV(x) ((int)(x))
108 #define NEXT(x) (FFMIN((int)(x) + 1, lut3d->lutsize - 1))
111 * Get the nearest defined point
113 static inline struct rgbvec interp_nearest(const LUT3DContext *lut3d,
114 const struct rgbvec *s)
116 return lut3d->lut[NEAR(s->r)][NEAR(s->g)][NEAR(s->b)];
120 * Interpolate using the 8 vertices of a cube
121 * @see https://en.wikipedia.org/wiki/Trilinear_interpolation
123 static inline struct rgbvec interp_trilinear(const LUT3DContext *lut3d,
124 const struct rgbvec *s)
126 const int prev[] = {PREV(s->r), PREV(s->g), PREV(s->b)};
127 const int next[] = {NEXT(s->r), NEXT(s->g), NEXT(s->b)};
128 const struct rgbvec d = {s->r - prev[0], s->g - prev[1], s->b - prev[2]};
129 const struct rgbvec c000 = lut3d->lut[prev[0]][prev[1]][prev[2]];
130 const struct rgbvec c001 = lut3d->lut[prev[0]][prev[1]][next[2]];
131 const struct rgbvec c010 = lut3d->lut[prev[0]][next[1]][prev[2]];
132 const struct rgbvec c011 = lut3d->lut[prev[0]][next[1]][next[2]];
133 const struct rgbvec c100 = lut3d->lut[next[0]][prev[1]][prev[2]];
134 const struct rgbvec c101 = lut3d->lut[next[0]][prev[1]][next[2]];
135 const struct rgbvec c110 = lut3d->lut[next[0]][next[1]][prev[2]];
136 const struct rgbvec c111 = lut3d->lut[next[0]][next[1]][next[2]];
137 const struct rgbvec c00 = lerp(&c000, &c100, d.r);
138 const struct rgbvec c10 = lerp(&c010, &c110, d.r);
139 const struct rgbvec c01 = lerp(&c001, &c101, d.r);
140 const struct rgbvec c11 = lerp(&c011, &c111, d.r);
141 const struct rgbvec c0 = lerp(&c00, &c10, d.g);
142 const struct rgbvec c1 = lerp(&c01, &c11, d.g);
143 const struct rgbvec c = lerp(&c0, &c1, d.b);
148 * Tetrahedral interpolation. Based on code found in Truelight Software Library paper.
149 * @see http://www.filmlight.ltd.uk/pdf/whitepapers/FL-TL-TN-0057-SoftwareLib.pdf
151 static inline struct rgbvec interp_tetrahedral(const LUT3DContext *lut3d,
152 const struct rgbvec *s)
154 const int prev[] = {PREV(s->r), PREV(s->g), PREV(s->b)};
155 const int next[] = {NEXT(s->r), NEXT(s->g), NEXT(s->b)};
156 const struct rgbvec d = {s->r - prev[0], s->g - prev[1], s->b - prev[2]};
157 const struct rgbvec c000 = lut3d->lut[prev[0]][prev[1]][prev[2]];
158 const struct rgbvec c111 = lut3d->lut[next[0]][next[1]][next[2]];
162 const struct rgbvec c100 = lut3d->lut[next[0]][prev[1]][prev[2]];
163 const struct rgbvec c110 = lut3d->lut[next[0]][next[1]][prev[2]];
164 c.r = (1-d.r) * c000.r + (d.r-d.g) * c100.r + (d.g-d.b) * c110.r + (d.b) * c111.r;
165 c.g = (1-d.r) * c000.g + (d.r-d.g) * c100.g + (d.g-d.b) * c110.g + (d.b) * c111.g;
166 c.b = (1-d.r) * c000.b + (d.r-d.g) * c100.b + (d.g-d.b) * c110.b + (d.b) * c111.b;
167 } else if (d.r > d.b) {
168 const struct rgbvec c100 = lut3d->lut[next[0]][prev[1]][prev[2]];
169 const struct rgbvec c101 = lut3d->lut[next[0]][prev[1]][next[2]];
170 c.r = (1-d.r) * c000.r + (d.r-d.b) * c100.r + (d.b-d.g) * c101.r + (d.g) * c111.r;
171 c.g = (1-d.r) * c000.g + (d.r-d.b) * c100.g + (d.b-d.g) * c101.g + (d.g) * c111.g;
172 c.b = (1-d.r) * c000.b + (d.r-d.b) * c100.b + (d.b-d.g) * c101.b + (d.g) * c111.b;
174 const struct rgbvec c001 = lut3d->lut[prev[0]][prev[1]][next[2]];
175 const struct rgbvec c101 = lut3d->lut[next[0]][prev[1]][next[2]];
176 c.r = (1-d.b) * c000.r + (d.b-d.r) * c001.r + (d.r-d.g) * c101.r + (d.g) * c111.r;
177 c.g = (1-d.b) * c000.g + (d.b-d.r) * c001.g + (d.r-d.g) * c101.g + (d.g) * c111.g;
178 c.b = (1-d.b) * c000.b + (d.b-d.r) * c001.b + (d.r-d.g) * c101.b + (d.g) * c111.b;
182 const struct rgbvec c001 = lut3d->lut[prev[0]][prev[1]][next[2]];
183 const struct rgbvec c011 = lut3d->lut[prev[0]][next[1]][next[2]];
184 c.r = (1-d.b) * c000.r + (d.b-d.g) * c001.r + (d.g-d.r) * c011.r + (d.r) * c111.r;
185 c.g = (1-d.b) * c000.g + (d.b-d.g) * c001.g + (d.g-d.r) * c011.g + (d.r) * c111.g;
186 c.b = (1-d.b) * c000.b + (d.b-d.g) * c001.b + (d.g-d.r) * c011.b + (d.r) * c111.b;
187 } else if (d.b > d.r) {
188 const struct rgbvec c010 = lut3d->lut[prev[0]][next[1]][prev[2]];
189 const struct rgbvec c011 = lut3d->lut[prev[0]][next[1]][next[2]];
190 c.r = (1-d.g) * c000.r + (d.g-d.b) * c010.r + (d.b-d.r) * c011.r + (d.r) * c111.r;
191 c.g = (1-d.g) * c000.g + (d.g-d.b) * c010.g + (d.b-d.r) * c011.g + (d.r) * c111.g;
192 c.b = (1-d.g) * c000.b + (d.g-d.b) * c010.b + (d.b-d.r) * c011.b + (d.r) * c111.b;
194 const struct rgbvec c010 = lut3d->lut[prev[0]][next[1]][prev[2]];
195 const struct rgbvec c110 = lut3d->lut[next[0]][next[1]][prev[2]];
196 c.r = (1-d.g) * c000.r + (d.g-d.r) * c010.r + (d.r-d.b) * c110.r + (d.b) * c111.r;
197 c.g = (1-d.g) * c000.g + (d.g-d.r) * c010.g + (d.r-d.b) * c110.g + (d.b) * c111.g;
198 c.b = (1-d.g) * c000.b + (d.g-d.r) * c010.b + (d.r-d.b) * c110.b + (d.b) * c111.b;
204 #define DEFINE_INTERP_FUNC_PLANAR(name, nbits, depth) \
205 static int interp_##nbits##_##name##_p##depth(AVFilterContext *ctx, void *arg, int jobnr, int nb_jobs) \
208 const LUT3DContext *lut3d = ctx->priv; \
209 const ThreadData *td = arg; \
210 const AVFrame *in = td->in; \
211 const AVFrame *out = td->out; \
212 const int direct = out == in; \
213 const int slice_start = (in->height * jobnr ) / nb_jobs; \
214 const int slice_end = (in->height * (jobnr+1)) / nb_jobs; \
215 uint8_t *grow = out->data[0] + slice_start * out->linesize[0]; \
216 uint8_t *brow = out->data[1] + slice_start * out->linesize[1]; \
217 uint8_t *rrow = out->data[2] + slice_start * out->linesize[2]; \
218 uint8_t *arow = out->data[3] + slice_start * out->linesize[3]; \
219 const uint8_t *srcgrow = in->data[0] + slice_start * in->linesize[0]; \
220 const uint8_t *srcbrow = in->data[1] + slice_start * in->linesize[1]; \
221 const uint8_t *srcrrow = in->data[2] + slice_start * in->linesize[2]; \
222 const uint8_t *srcarow = in->data[3] + slice_start * in->linesize[3]; \
223 const float scale_r = (lut3d->scale.r / ((1<<depth) - 1)) * (lut3d->lutsize - 1); \
224 const float scale_g = (lut3d->scale.g / ((1<<depth) - 1)) * (lut3d->lutsize - 1); \
225 const float scale_b = (lut3d->scale.b / ((1<<depth) - 1)) * (lut3d->lutsize - 1); \
227 for (y = slice_start; y < slice_end; y++) { \
228 uint##nbits##_t *dstg = (uint##nbits##_t *)grow; \
229 uint##nbits##_t *dstb = (uint##nbits##_t *)brow; \
230 uint##nbits##_t *dstr = (uint##nbits##_t *)rrow; \
231 uint##nbits##_t *dsta = (uint##nbits##_t *)arow; \
232 const uint##nbits##_t *srcg = (const uint##nbits##_t *)srcgrow; \
233 const uint##nbits##_t *srcb = (const uint##nbits##_t *)srcbrow; \
234 const uint##nbits##_t *srcr = (const uint##nbits##_t *)srcrrow; \
235 const uint##nbits##_t *srca = (const uint##nbits##_t *)srcarow; \
236 for (x = 0; x < in->width; x++) { \
237 const struct rgbvec scaled_rgb = {srcr[x] * scale_r, \
239 srcb[x] * scale_b}; \
240 struct rgbvec vec = interp_##name(lut3d, &scaled_rgb); \
241 dstr[x] = av_clip_uintp2(vec.r * (float)((1<<depth) - 1), depth); \
242 dstg[x] = av_clip_uintp2(vec.g * (float)((1<<depth) - 1), depth); \
243 dstb[x] = av_clip_uintp2(vec.b * (float)((1<<depth) - 1), depth); \
244 if (!direct && in->linesize[3]) \
247 grow += out->linesize[0]; \
248 brow += out->linesize[1]; \
249 rrow += out->linesize[2]; \
250 arow += out->linesize[3]; \
251 srcgrow += in->linesize[0]; \
252 srcbrow += in->linesize[1]; \
253 srcrrow += in->linesize[2]; \
254 srcarow += in->linesize[3]; \
259 DEFINE_INTERP_FUNC_PLANAR(nearest, 8, 8)
260 DEFINE_INTERP_FUNC_PLANAR(trilinear, 8, 8)
261 DEFINE_INTERP_FUNC_PLANAR(tetrahedral, 8, 8)
263 DEFINE_INTERP_FUNC_PLANAR(nearest, 16, 9)
264 DEFINE_INTERP_FUNC_PLANAR(trilinear, 16, 9)
265 DEFINE_INTERP_FUNC_PLANAR(tetrahedral, 16, 9)
267 DEFINE_INTERP_FUNC_PLANAR(nearest, 16, 10)
268 DEFINE_INTERP_FUNC_PLANAR(trilinear, 16, 10)
269 DEFINE_INTERP_FUNC_PLANAR(tetrahedral, 16, 10)
271 DEFINE_INTERP_FUNC_PLANAR(nearest, 16, 12)
272 DEFINE_INTERP_FUNC_PLANAR(trilinear, 16, 12)
273 DEFINE_INTERP_FUNC_PLANAR(tetrahedral, 16, 12)
275 DEFINE_INTERP_FUNC_PLANAR(nearest, 16, 14)
276 DEFINE_INTERP_FUNC_PLANAR(trilinear, 16, 14)
277 DEFINE_INTERP_FUNC_PLANAR(tetrahedral, 16, 14)
279 DEFINE_INTERP_FUNC_PLANAR(nearest, 16, 16)
280 DEFINE_INTERP_FUNC_PLANAR(trilinear, 16, 16)
281 DEFINE_INTERP_FUNC_PLANAR(tetrahedral, 16, 16)
283 #define DEFINE_INTERP_FUNC(name, nbits) \
284 static int interp_##nbits##_##name(AVFilterContext *ctx, void *arg, int jobnr, int nb_jobs) \
287 const LUT3DContext *lut3d = ctx->priv; \
288 const ThreadData *td = arg; \
289 const AVFrame *in = td->in; \
290 const AVFrame *out = td->out; \
291 const int direct = out == in; \
292 const int step = lut3d->step; \
293 const uint8_t r = lut3d->rgba_map[R]; \
294 const uint8_t g = lut3d->rgba_map[G]; \
295 const uint8_t b = lut3d->rgba_map[B]; \
296 const uint8_t a = lut3d->rgba_map[A]; \
297 const int slice_start = (in->height * jobnr ) / nb_jobs; \
298 const int slice_end = (in->height * (jobnr+1)) / nb_jobs; \
299 uint8_t *dstrow = out->data[0] + slice_start * out->linesize[0]; \
300 const uint8_t *srcrow = in ->data[0] + slice_start * in ->linesize[0]; \
301 const float scale_r = (lut3d->scale.r / ((1<<nbits) - 1)) * (lut3d->lutsize - 1); \
302 const float scale_g = (lut3d->scale.g / ((1<<nbits) - 1)) * (lut3d->lutsize - 1); \
303 const float scale_b = (lut3d->scale.b / ((1<<nbits) - 1)) * (lut3d->lutsize - 1); \
305 for (y = slice_start; y < slice_end; y++) { \
306 uint##nbits##_t *dst = (uint##nbits##_t *)dstrow; \
307 const uint##nbits##_t *src = (const uint##nbits##_t *)srcrow; \
308 for (x = 0; x < in->width * step; x += step) { \
309 const struct rgbvec scaled_rgb = {src[x + r] * scale_r, \
310 src[x + g] * scale_g, \
311 src[x + b] * scale_b}; \
312 struct rgbvec vec = interp_##name(lut3d, &scaled_rgb); \
313 dst[x + r] = av_clip_uint##nbits(vec.r * (float)((1<<nbits) - 1)); \
314 dst[x + g] = av_clip_uint##nbits(vec.g * (float)((1<<nbits) - 1)); \
315 dst[x + b] = av_clip_uint##nbits(vec.b * (float)((1<<nbits) - 1)); \
316 if (!direct && step == 4) \
317 dst[x + a] = src[x + a]; \
319 dstrow += out->linesize[0]; \
320 srcrow += in ->linesize[0]; \
325 DEFINE_INTERP_FUNC(nearest, 8)
326 DEFINE_INTERP_FUNC(trilinear, 8)
327 DEFINE_INTERP_FUNC(tetrahedral, 8)
329 DEFINE_INTERP_FUNC(nearest, 16)
330 DEFINE_INTERP_FUNC(trilinear, 16)
331 DEFINE_INTERP_FUNC(tetrahedral, 16)
333 #define MAX_LINE_SIZE 512
335 static int skip_line(const char *p)
337 while (*p && av_isspace(*p))
339 return !*p || *p == '#';
342 #define NEXT_LINE(loop_cond) do { \
343 if (!fgets(line, sizeof(line), f)) { \
344 av_log(ctx, AV_LOG_ERROR, "Unexpected EOF\n"); \
345 return AVERROR_INVALIDDATA; \
349 /* Basically r g and b float values on each line, with a facultative 3DLUTSIZE
350 * directive; seems to be generated by Davinci */
351 static int parse_dat(AVFilterContext *ctx, FILE *f)
353 LUT3DContext *lut3d = ctx->priv;
354 char line[MAX_LINE_SIZE];
357 lut3d->lutsize = size = 33;
359 NEXT_LINE(skip_line(line));
360 if (!strncmp(line, "3DLUTSIZE ", 10)) {
361 size = strtol(line + 10, NULL, 0);
362 if (size < 2 || size > MAX_LEVEL) {
363 av_log(ctx, AV_LOG_ERROR, "Too large or invalid 3D LUT size\n");
364 return AVERROR(EINVAL);
366 lut3d->lutsize = size;
367 NEXT_LINE(skip_line(line));
369 for (k = 0; k < size; k++) {
370 for (j = 0; j < size; j++) {
371 for (i = 0; i < size; i++) {
372 struct rgbvec *vec = &lut3d->lut[k][j][i];
373 if (k != 0 || j != 0 || i != 0)
374 NEXT_LINE(skip_line(line));
375 if (av_sscanf(line, "%f %f %f", &vec->r, &vec->g, &vec->b) != 3)
376 return AVERROR_INVALIDDATA;
384 static int parse_cube(AVFilterContext *ctx, FILE *f)
386 LUT3DContext *lut3d = ctx->priv;
387 char line[MAX_LINE_SIZE];
388 float min[3] = {0.0, 0.0, 0.0};
389 float max[3] = {1.0, 1.0, 1.0};
391 while (fgets(line, sizeof(line), f)) {
392 if (!strncmp(line, "LUT_3D_SIZE", 11)) {
394 const int size = strtol(line + 12, NULL, 0);
396 if (size < 2 || size > MAX_LEVEL) {
397 av_log(ctx, AV_LOG_ERROR, "Too large or invalid 3D LUT size\n");
398 return AVERROR(EINVAL);
400 lut3d->lutsize = size;
401 for (k = 0; k < size; k++) {
402 for (j = 0; j < size; j++) {
403 for (i = 0; i < size; i++) {
404 struct rgbvec *vec = &lut3d->lut[i][j][k];
409 if (!strncmp(line, "DOMAIN_", 7)) {
411 if (!strncmp(line + 7, "MIN ", 4)) vals = min;
412 else if (!strncmp(line + 7, "MAX ", 4)) vals = max;
414 return AVERROR_INVALIDDATA;
415 av_sscanf(line + 11, "%f %f %f", vals, vals + 1, vals + 2);
416 av_log(ctx, AV_LOG_DEBUG, "min: %f %f %f | max: %f %f %f\n",
417 min[0], min[1], min[2], max[0], max[1], max[2]);
419 } else if (!strncmp(line, "TITLE", 5)) {
422 } while (skip_line(line));
423 if (av_sscanf(line, "%f %f %f", &vec->r, &vec->g, &vec->b) != 3)
424 return AVERROR_INVALIDDATA;
432 lut3d->scale.r = av_clipf(1. / (max[0] - min[0]), 0.f, 1.f);
433 lut3d->scale.g = av_clipf(1. / (max[1] - min[1]), 0.f, 1.f);
434 lut3d->scale.b = av_clipf(1. / (max[2] - min[2]), 0.f, 1.f);
439 /* Assume 17x17x17 LUT with a 16-bit depth
440 * FIXME: it seems there are various 3dl formats */
441 static int parse_3dl(AVFilterContext *ctx, FILE *f)
443 char line[MAX_LINE_SIZE];
444 LUT3DContext *lut3d = ctx->priv;
447 const float scale = 16*16*16;
449 lut3d->lutsize = size;
450 NEXT_LINE(skip_line(line));
451 for (k = 0; k < size; k++) {
452 for (j = 0; j < size; j++) {
453 for (i = 0; i < size; i++) {
455 struct rgbvec *vec = &lut3d->lut[k][j][i];
457 NEXT_LINE(skip_line(line));
458 if (av_sscanf(line, "%d %d %d", &r, &g, &b) != 3)
459 return AVERROR_INVALIDDATA;
470 static int parse_m3d(AVFilterContext *ctx, FILE *f)
472 LUT3DContext *lut3d = ctx->priv;
474 int i, j, k, size, in = -1, out = -1;
475 char line[MAX_LINE_SIZE];
476 uint8_t rgb_map[3] = {0, 1, 2};
478 while (fgets(line, sizeof(line), f)) {
479 if (!strncmp(line, "in", 2)) in = strtol(line + 2, NULL, 0);
480 else if (!strncmp(line, "out", 3)) out = strtol(line + 3, NULL, 0);
481 else if (!strncmp(line, "values", 6)) {
482 const char *p = line + 6;
483 #define SET_COLOR(id) do { \
484 while (av_isspace(*p)) \
487 case 'r': rgb_map[id] = 0; break; \
488 case 'g': rgb_map[id] = 1; break; \
489 case 'b': rgb_map[id] = 2; break; \
491 while (*p && !av_isspace(*p)) \
501 if (in == -1 || out == -1) {
502 av_log(ctx, AV_LOG_ERROR, "in and out must be defined\n");
503 return AVERROR_INVALIDDATA;
505 if (in < 2 || out < 2 ||
506 in > MAX_LEVEL*MAX_LEVEL*MAX_LEVEL ||
507 out > MAX_LEVEL*MAX_LEVEL*MAX_LEVEL) {
508 av_log(ctx, AV_LOG_ERROR, "invalid in (%d) or out (%d)\n", in, out);
509 return AVERROR_INVALIDDATA;
511 for (size = 1; size*size*size < in; size++);
512 lut3d->lutsize = size;
513 scale = 1. / (out - 1);
515 for (k = 0; k < size; k++) {
516 for (j = 0; j < size; j++) {
517 for (i = 0; i < size; i++) {
518 struct rgbvec *vec = &lut3d->lut[k][j][i];
522 if (av_sscanf(line, "%f %f %f", val, val + 1, val + 2) != 3)
523 return AVERROR_INVALIDDATA;
524 vec->r = val[rgb_map[0]] * scale;
525 vec->g = val[rgb_map[1]] * scale;
526 vec->b = val[rgb_map[2]] * scale;
533 static int parse_cinespace(AVFilterContext *ctx, FILE *f)
535 LUT3DContext *lut3d = ctx->priv;
536 char line[MAX_LINE_SIZE];
537 float in_min[3] = {0.0, 0.0, 0.0};
538 float in_max[3] = {1.0, 1.0, 1.0};
539 float out_min[3] = {0.0, 0.0, 0.0};
540 float out_max[3] = {1.0, 1.0, 1.0};
541 int inside_metadata = 0, size;
543 NEXT_LINE(skip_line(line));
544 if (strncmp(line, "CSPLUTV100", 10)) {
545 av_log(ctx, AV_LOG_ERROR, "Not cineSpace LUT format\n");
546 return AVERROR(EINVAL);
549 NEXT_LINE(skip_line(line));
550 if (strncmp(line, "3D", 2)) {
551 av_log(ctx, AV_LOG_ERROR, "Not 3D LUT format\n");
552 return AVERROR(EINVAL);
556 NEXT_LINE(skip_line(line));
558 if (!strncmp(line, "BEGIN METADATA", 14)) {
562 if (!strncmp(line, "END METADATA", 12)) {
566 if (inside_metadata == 0) {
567 int size_r, size_g, size_b;
569 for (int i = 0; i < 3; i++) {
570 int npoints = strtol(line, NULL, 0);
573 av_log(ctx, AV_LOG_ERROR, "Unsupported number of pre-lut points.\n");
574 return AVERROR_PATCHWELCOME;
577 NEXT_LINE(skip_line(line));
578 if (av_sscanf(line, "%f %f", &in_min[i], &in_max[i]) != 2)
579 return AVERROR_INVALIDDATA;
580 NEXT_LINE(skip_line(line));
581 if (av_sscanf(line, "%f %f", &out_min[i], &out_max[i]) != 2)
582 return AVERROR_INVALIDDATA;
583 NEXT_LINE(skip_line(line));
586 if (av_sscanf(line, "%d %d %d", &size_r, &size_g, &size_b) != 3)
587 return AVERROR(EINVAL);
588 if (size_r != size_g || size_r != size_b) {
589 av_log(ctx, AV_LOG_ERROR, "Unsupported size combination: %dx%dx%d.\n", size_r, size_g, size_b);
590 return AVERROR_PATCHWELCOME;
594 if (size < 2 || size > MAX_LEVEL) {
595 av_log(ctx, AV_LOG_ERROR, "Too large or invalid 3D LUT size\n");
596 return AVERROR(EINVAL);
599 lut3d->lutsize = size;
601 for (int k = 0; k < size; k++) {
602 for (int j = 0; j < size; j++) {
603 for (int i = 0; i < size; i++) {
604 struct rgbvec *vec = &lut3d->lut[i][j][k];
605 if (k != 0 || j != 0 || i != 0)
606 NEXT_LINE(skip_line(line));
607 if (av_sscanf(line, "%f %f %f", &vec->r, &vec->g, &vec->b) != 3)
608 return AVERROR_INVALIDDATA;
609 vec->r *= out_max[0] - out_min[0];
610 vec->g *= out_max[1] - out_min[1];
611 vec->b *= out_max[2] - out_min[2];
620 lut3d->scale.r = av_clipf(1. / (in_max[0] - in_min[0]), 0.f, 1.f);
621 lut3d->scale.g = av_clipf(1. / (in_max[1] - in_min[1]), 0.f, 1.f);
622 lut3d->scale.b = av_clipf(1. / (in_max[2] - in_min[2]), 0.f, 1.f);
627 static void set_identity_matrix(LUT3DContext *lut3d, int size)
630 const float c = 1. / (size - 1);
632 lut3d->lutsize = size;
633 for (k = 0; k < size; k++) {
634 for (j = 0; j < size; j++) {
635 for (i = 0; i < size; i++) {
636 struct rgbvec *vec = &lut3d->lut[k][j][i];
645 static int query_formats(AVFilterContext *ctx)
647 static const enum AVPixelFormat pix_fmts[] = {
648 AV_PIX_FMT_RGB24, AV_PIX_FMT_BGR24,
649 AV_PIX_FMT_RGBA, AV_PIX_FMT_BGRA,
650 AV_PIX_FMT_ARGB, AV_PIX_FMT_ABGR,
651 AV_PIX_FMT_0RGB, AV_PIX_FMT_0BGR,
652 AV_PIX_FMT_RGB0, AV_PIX_FMT_BGR0,
653 AV_PIX_FMT_RGB48, AV_PIX_FMT_BGR48,
654 AV_PIX_FMT_RGBA64, AV_PIX_FMT_BGRA64,
655 AV_PIX_FMT_GBRP, AV_PIX_FMT_GBRAP,
657 AV_PIX_FMT_GBRP10, AV_PIX_FMT_GBRAP10,
658 AV_PIX_FMT_GBRP12, AV_PIX_FMT_GBRAP12,
660 AV_PIX_FMT_GBRP16, AV_PIX_FMT_GBRAP16,
663 AVFilterFormats *fmts_list = ff_make_format_list(pix_fmts);
665 return AVERROR(ENOMEM);
666 return ff_set_common_formats(ctx, fmts_list);
669 static int config_input(AVFilterLink *inlink)
671 int depth, is16bit = 0, planar = 0;
672 LUT3DContext *lut3d = inlink->dst->priv;
673 const AVPixFmtDescriptor *desc = av_pix_fmt_desc_get(inlink->format);
675 depth = desc->comp[0].depth;
677 switch (inlink->format) {
678 case AV_PIX_FMT_RGB48:
679 case AV_PIX_FMT_BGR48:
680 case AV_PIX_FMT_RGBA64:
681 case AV_PIX_FMT_BGRA64:
684 case AV_PIX_FMT_GBRP9:
685 case AV_PIX_FMT_GBRP10:
686 case AV_PIX_FMT_GBRP12:
687 case AV_PIX_FMT_GBRP14:
688 case AV_PIX_FMT_GBRP16:
689 case AV_PIX_FMT_GBRAP10:
690 case AV_PIX_FMT_GBRAP12:
691 case AV_PIX_FMT_GBRAP16:
693 case AV_PIX_FMT_GBRP:
694 case AV_PIX_FMT_GBRAP:
699 ff_fill_rgba_map(lut3d->rgba_map, inlink->format);
700 lut3d->step = av_get_padded_bits_per_pixel(desc) >> (3 + is16bit);
702 #define SET_FUNC(name) do { \
705 case 8: lut3d->interp = interp_8_##name##_p8; break; \
706 case 9: lut3d->interp = interp_16_##name##_p9; break; \
707 case 10: lut3d->interp = interp_16_##name##_p10; break; \
708 case 12: lut3d->interp = interp_16_##name##_p12; break; \
709 case 14: lut3d->interp = interp_16_##name##_p14; break; \
710 case 16: lut3d->interp = interp_16_##name##_p16; break; \
712 } else if (is16bit) { lut3d->interp = interp_16_##name; \
713 } else { lut3d->interp = interp_8_##name; } \
716 switch (lut3d->interpolation) {
717 case INTERPOLATE_NEAREST: SET_FUNC(nearest); break;
718 case INTERPOLATE_TRILINEAR: SET_FUNC(trilinear); break;
719 case INTERPOLATE_TETRAHEDRAL: SET_FUNC(tetrahedral); break;
727 static AVFrame *apply_lut(AVFilterLink *inlink, AVFrame *in)
729 AVFilterContext *ctx = inlink->dst;
730 LUT3DContext *lut3d = ctx->priv;
731 AVFilterLink *outlink = inlink->dst->outputs[0];
735 if (av_frame_is_writable(in)) {
738 out = ff_get_video_buffer(outlink, outlink->w, outlink->h);
743 av_frame_copy_props(out, in);
748 ctx->internal->execute(ctx, lut3d->interp, &td, NULL, FFMIN(outlink->h, ff_filter_get_nb_threads(ctx)));
756 static int filter_frame(AVFilterLink *inlink, AVFrame *in)
758 AVFilterLink *outlink = inlink->dst->outputs[0];
759 AVFrame *out = apply_lut(inlink, in);
761 return AVERROR(ENOMEM);
762 return ff_filter_frame(outlink, out);
765 #if CONFIG_LUT3D_FILTER
766 static const AVOption lut3d_options[] = {
767 { "file", "set 3D LUT file name", OFFSET(file), AV_OPT_TYPE_STRING, {.str=NULL}, .flags = FLAGS },
771 AVFILTER_DEFINE_CLASS(lut3d);
773 static av_cold int lut3d_init(AVFilterContext *ctx)
778 LUT3DContext *lut3d = ctx->priv;
780 lut3d->scale.r = lut3d->scale.g = lut3d->scale.b = 1.f;
783 set_identity_matrix(lut3d, 32);
787 f = fopen(lut3d->file, "r");
789 ret = AVERROR(errno);
790 av_log(ctx, AV_LOG_ERROR, "%s: %s\n", lut3d->file, av_err2str(ret));
794 ext = strrchr(lut3d->file, '.');
796 av_log(ctx, AV_LOG_ERROR, "Unable to guess the format from the extension\n");
797 ret = AVERROR_INVALIDDATA;
802 if (!av_strcasecmp(ext, "dat")) {
803 ret = parse_dat(ctx, f);
804 } else if (!av_strcasecmp(ext, "3dl")) {
805 ret = parse_3dl(ctx, f);
806 } else if (!av_strcasecmp(ext, "cube")) {
807 ret = parse_cube(ctx, f);
808 } else if (!av_strcasecmp(ext, "m3d")) {
809 ret = parse_m3d(ctx, f);
810 } else if (!av_strcasecmp(ext, "csp")) {
811 ret = parse_cinespace(ctx, f);
813 av_log(ctx, AV_LOG_ERROR, "Unrecognized '.%s' file type\n", ext);
814 ret = AVERROR(EINVAL);
817 if (!ret && !lut3d->lutsize) {
818 av_log(ctx, AV_LOG_ERROR, "3D LUT is empty\n");
819 ret = AVERROR_INVALIDDATA;
827 static const AVFilterPad lut3d_inputs[] = {
830 .type = AVMEDIA_TYPE_VIDEO,
831 .filter_frame = filter_frame,
832 .config_props = config_input,
837 static const AVFilterPad lut3d_outputs[] = {
840 .type = AVMEDIA_TYPE_VIDEO,
845 AVFilter ff_vf_lut3d = {
847 .description = NULL_IF_CONFIG_SMALL("Adjust colors using a 3D LUT."),
848 .priv_size = sizeof(LUT3DContext),
850 .query_formats = query_formats,
851 .inputs = lut3d_inputs,
852 .outputs = lut3d_outputs,
853 .priv_class = &lut3d_class,
854 .flags = AVFILTER_FLAG_SUPPORT_TIMELINE_GENERIC | AVFILTER_FLAG_SLICE_THREADS,
858 #if CONFIG_HALDCLUT_FILTER
860 static void update_clut_packed(LUT3DContext *lut3d, const AVFrame *frame)
862 const uint8_t *data = frame->data[0];
863 const int linesize = frame->linesize[0];
864 const int w = lut3d->clut_width;
865 const int step = lut3d->clut_step;
866 const uint8_t *rgba_map = lut3d->clut_rgba_map;
867 const int level = lut3d->lutsize;
869 #define LOAD_CLUT(nbits) do { \
870 int i, j, k, x = 0, y = 0; \
872 for (k = 0; k < level; k++) { \
873 for (j = 0; j < level; j++) { \
874 for (i = 0; i < level; i++) { \
875 const uint##nbits##_t *src = (const uint##nbits##_t *) \
876 (data + y*linesize + x*step); \
877 struct rgbvec *vec = &lut3d->lut[i][j][k]; \
878 vec->r = src[rgba_map[0]] / (float)((1<<(nbits)) - 1); \
879 vec->g = src[rgba_map[1]] / (float)((1<<(nbits)) - 1); \
880 vec->b = src[rgba_map[2]] / (float)((1<<(nbits)) - 1); \
890 switch (lut3d->clut_bits) {
891 case 8: LOAD_CLUT(8); break;
892 case 16: LOAD_CLUT(16); break;
896 static void update_clut_planar(LUT3DContext *lut3d, const AVFrame *frame)
898 const uint8_t *datag = frame->data[0];
899 const uint8_t *datab = frame->data[1];
900 const uint8_t *datar = frame->data[2];
901 const int glinesize = frame->linesize[0];
902 const int blinesize = frame->linesize[1];
903 const int rlinesize = frame->linesize[2];
904 const int w = lut3d->clut_width;
905 const int level = lut3d->lutsize;
907 #define LOAD_CLUT_PLANAR(nbits, depth) do { \
908 int i, j, k, x = 0, y = 0; \
910 for (k = 0; k < level; k++) { \
911 for (j = 0; j < level; j++) { \
912 for (i = 0; i < level; i++) { \
913 const uint##nbits##_t *gsrc = (const uint##nbits##_t *) \
914 (datag + y*glinesize); \
915 const uint##nbits##_t *bsrc = (const uint##nbits##_t *) \
916 (datab + y*blinesize); \
917 const uint##nbits##_t *rsrc = (const uint##nbits##_t *) \
918 (datar + y*rlinesize); \
919 struct rgbvec *vec = &lut3d->lut[i][j][k]; \
920 vec->r = gsrc[x] / (float)((1<<(depth)) - 1); \
921 vec->g = bsrc[x] / (float)((1<<(depth)) - 1); \
922 vec->b = rsrc[x] / (float)((1<<(depth)) - 1); \
932 switch (lut3d->clut_bits) {
933 case 8: LOAD_CLUT_PLANAR(8, 8); break;
934 case 9: LOAD_CLUT_PLANAR(16, 9); break;
935 case 10: LOAD_CLUT_PLANAR(16, 10); break;
936 case 12: LOAD_CLUT_PLANAR(16, 12); break;
937 case 14: LOAD_CLUT_PLANAR(16, 14); break;
938 case 16: LOAD_CLUT_PLANAR(16, 16); break;
942 static int config_output(AVFilterLink *outlink)
944 AVFilterContext *ctx = outlink->src;
945 LUT3DContext *lut3d = ctx->priv;
948 ret = ff_framesync_init_dualinput(&lut3d->fs, ctx);
951 outlink->w = ctx->inputs[0]->w;
952 outlink->h = ctx->inputs[0]->h;
953 outlink->time_base = ctx->inputs[0]->time_base;
954 if ((ret = ff_framesync_configure(&lut3d->fs)) < 0)
959 static int activate(AVFilterContext *ctx)
961 LUT3DContext *s = ctx->priv;
962 return ff_framesync_activate(&s->fs);
965 static int config_clut(AVFilterLink *inlink)
967 int size, level, w, h;
968 AVFilterContext *ctx = inlink->dst;
969 LUT3DContext *lut3d = ctx->priv;
970 const AVPixFmtDescriptor *desc = av_pix_fmt_desc_get(inlink->format);
974 lut3d->clut_bits = desc->comp[0].depth;
975 lut3d->clut_planar = av_pix_fmt_count_planes(inlink->format) > 1;
977 lut3d->clut_step = av_get_padded_bits_per_pixel(desc) >> 3;
978 ff_fill_rgba_map(lut3d->clut_rgba_map, inlink->format);
980 if (inlink->w > inlink->h)
981 av_log(ctx, AV_LOG_INFO, "Padding on the right (%dpx) of the "
982 "Hald CLUT will be ignored\n", inlink->w - inlink->h);
983 else if (inlink->w < inlink->h)
984 av_log(ctx, AV_LOG_INFO, "Padding at the bottom (%dpx) of the "
985 "Hald CLUT will be ignored\n", inlink->h - inlink->w);
986 lut3d->clut_width = w = h = FFMIN(inlink->w, inlink->h);
988 for (level = 1; level*level*level < w; level++);
989 size = level*level*level;
991 av_log(ctx, AV_LOG_WARNING, "The Hald CLUT width does not match the level\n");
992 return AVERROR_INVALIDDATA;
994 av_assert0(w == h && w == size);
996 if (level > MAX_LEVEL) {
997 const int max_clut_level = sqrt(MAX_LEVEL);
998 const int max_clut_size = max_clut_level*max_clut_level*max_clut_level;
999 av_log(ctx, AV_LOG_ERROR, "Too large Hald CLUT "
1000 "(maximum level is %d, or %dx%d CLUT)\n",
1001 max_clut_level, max_clut_size, max_clut_size);
1002 return AVERROR(EINVAL);
1004 lut3d->lutsize = level;
1009 static int update_apply_clut(FFFrameSync *fs)
1011 AVFilterContext *ctx = fs->parent;
1012 LUT3DContext *lut3d = ctx->priv;
1013 AVFilterLink *inlink = ctx->inputs[0];
1014 AVFrame *master, *second, *out;
1017 ret = ff_framesync_dualinput_get(fs, &master, &second);
1021 return ff_filter_frame(ctx->outputs[0], master);
1022 if (lut3d->clut_planar)
1023 update_clut_planar(ctx->priv, second);
1025 update_clut_packed(ctx->priv, second);
1026 out = apply_lut(inlink, master);
1027 return ff_filter_frame(ctx->outputs[0], out);
1030 static av_cold int haldclut_init(AVFilterContext *ctx)
1032 LUT3DContext *lut3d = ctx->priv;
1033 lut3d->scale.r = lut3d->scale.g = lut3d->scale.b = 1.f;
1034 lut3d->fs.on_event = update_apply_clut;
1038 static av_cold void haldclut_uninit(AVFilterContext *ctx)
1040 LUT3DContext *lut3d = ctx->priv;
1041 ff_framesync_uninit(&lut3d->fs);
1044 static const AVOption haldclut_options[] = {
1048 FRAMESYNC_DEFINE_CLASS(haldclut, LUT3DContext, fs);
1050 static const AVFilterPad haldclut_inputs[] = {
1053 .type = AVMEDIA_TYPE_VIDEO,
1054 .config_props = config_input,
1057 .type = AVMEDIA_TYPE_VIDEO,
1058 .config_props = config_clut,
1063 static const AVFilterPad haldclut_outputs[] = {
1066 .type = AVMEDIA_TYPE_VIDEO,
1067 .config_props = config_output,
1072 AVFilter ff_vf_haldclut = {
1074 .description = NULL_IF_CONFIG_SMALL("Adjust colors using a Hald CLUT."),
1075 .priv_size = sizeof(LUT3DContext),
1076 .preinit = haldclut_framesync_preinit,
1077 .init = haldclut_init,
1078 .uninit = haldclut_uninit,
1079 .query_formats = query_formats,
1080 .activate = activate,
1081 .inputs = haldclut_inputs,
1082 .outputs = haldclut_outputs,
1083 .priv_class = &haldclut_class,
1084 .flags = AVFILTER_FLAG_SUPPORT_TIMELINE_INTERNAL | AVFILTER_FLAG_SLICE_THREADS,
1088 #if CONFIG_LUT1D_FILTER
1090 enum interp_1d_mode {
1091 INTERPOLATE_1D_NEAREST,
1092 INTERPOLATE_1D_LINEAR,
1093 INTERPOLATE_1D_CUBIC,
1094 INTERPOLATE_1D_COSINE,
1095 INTERPOLATE_1D_SPLINE,
1099 #define MAX_1D_LEVEL 65536
1101 typedef struct LUT1DContext {
1102 const AVClass *class;
1104 int interpolation; ///<interp_1d_mode
1105 struct rgbvec scale;
1106 uint8_t rgba_map[4];
1108 float lut[3][MAX_1D_LEVEL];
1110 avfilter_action_func *interp;
1114 #define OFFSET(x) offsetof(LUT1DContext, x)
1116 static void set_identity_matrix_1d(LUT1DContext *lut1d, int size)
1118 const float c = 1. / (size - 1);
1121 lut1d->lutsize = size;
1122 for (i = 0; i < size; i++) {
1123 lut1d->lut[0][i] = i * c;
1124 lut1d->lut[1][i] = i * c;
1125 lut1d->lut[2][i] = i * c;
1129 static int parse_cinespace_1d(AVFilterContext *ctx, FILE *f)
1131 LUT1DContext *lut1d = ctx->priv;
1132 char line[MAX_LINE_SIZE];
1133 float in_min[3] = {0.0, 0.0, 0.0};
1134 float in_max[3] = {1.0, 1.0, 1.0};
1135 float out_min[3] = {0.0, 0.0, 0.0};
1136 float out_max[3] = {1.0, 1.0, 1.0};
1137 int inside_metadata = 0, size;
1139 NEXT_LINE(skip_line(line));
1140 if (strncmp(line, "CSPLUTV100", 10)) {
1141 av_log(ctx, AV_LOG_ERROR, "Not cineSpace LUT format\n");
1142 return AVERROR(EINVAL);
1145 NEXT_LINE(skip_line(line));
1146 if (strncmp(line, "1D", 2)) {
1147 av_log(ctx, AV_LOG_ERROR, "Not 1D LUT format\n");
1148 return AVERROR(EINVAL);
1152 NEXT_LINE(skip_line(line));
1154 if (!strncmp(line, "BEGIN METADATA", 14)) {
1155 inside_metadata = 1;
1158 if (!strncmp(line, "END METADATA", 12)) {
1159 inside_metadata = 0;
1162 if (inside_metadata == 0) {
1163 for (int i = 0; i < 3; i++) {
1164 int npoints = strtol(line, NULL, 0);
1167 av_log(ctx, AV_LOG_ERROR, "Unsupported number of pre-lut points.\n");
1168 return AVERROR_PATCHWELCOME;
1171 NEXT_LINE(skip_line(line));
1172 if (av_sscanf(line, "%f %f", &in_min[i], &in_max[i]) != 2)
1173 return AVERROR_INVALIDDATA;
1174 NEXT_LINE(skip_line(line));
1175 if (av_sscanf(line, "%f %f", &out_min[i], &out_max[i]) != 2)
1176 return AVERROR_INVALIDDATA;
1177 NEXT_LINE(skip_line(line));
1180 size = strtol(line, NULL, 0);
1182 if (size < 2 || size > MAX_1D_LEVEL) {
1183 av_log(ctx, AV_LOG_ERROR, "Too large or invalid 1D LUT size\n");
1184 return AVERROR(EINVAL);
1187 lut1d->lutsize = size;
1189 for (int i = 0; i < size; i++) {
1190 NEXT_LINE(skip_line(line));
1191 if (av_sscanf(line, "%f %f %f", &lut1d->lut[0][i], &lut1d->lut[1][i], &lut1d->lut[2][i]) != 3)
1192 return AVERROR_INVALIDDATA;
1193 lut1d->lut[0][i] *= out_max[0] - out_min[0];
1194 lut1d->lut[1][i] *= out_max[1] - out_min[1];
1195 lut1d->lut[2][i] *= out_max[2] - out_min[2];
1202 lut1d->scale.r = av_clipf(1. / (in_max[0] - in_min[0]), 0.f, 1.f);
1203 lut1d->scale.g = av_clipf(1. / (in_max[1] - in_min[1]), 0.f, 1.f);
1204 lut1d->scale.b = av_clipf(1. / (in_max[2] - in_min[2]), 0.f, 1.f);
1209 static int parse_cube_1d(AVFilterContext *ctx, FILE *f)
1211 LUT1DContext *lut1d = ctx->priv;
1212 char line[MAX_LINE_SIZE];
1213 float min[3] = {0.0, 0.0, 0.0};
1214 float max[3] = {1.0, 1.0, 1.0};
1216 while (fgets(line, sizeof(line), f)) {
1217 if (!strncmp(line, "LUT_1D_SIZE", 11)) {
1218 const int size = strtol(line + 12, NULL, 0);
1221 if (size < 2 || size > MAX_1D_LEVEL) {
1222 av_log(ctx, AV_LOG_ERROR, "Too large or invalid 1D LUT size\n");
1223 return AVERROR(EINVAL);
1225 lut1d->lutsize = size;
1226 for (i = 0; i < size; i++) {
1230 if (!strncmp(line, "DOMAIN_", 7)) {
1232 if (!strncmp(line + 7, "MIN ", 4)) vals = min;
1233 else if (!strncmp(line + 7, "MAX ", 4)) vals = max;
1235 return AVERROR_INVALIDDATA;
1236 av_sscanf(line + 11, "%f %f %f", vals, vals + 1, vals + 2);
1237 av_log(ctx, AV_LOG_DEBUG, "min: %f %f %f | max: %f %f %f\n",
1238 min[0], min[1], min[2], max[0], max[1], max[2]);
1240 } else if (!strncmp(line, "LUT_1D_INPUT_RANGE ", 19)) {
1241 av_sscanf(line + 19, "%f %f", min, max);
1242 min[1] = min[2] = min[0];
1243 max[1] = max[2] = max[0];
1245 } else if (!strncmp(line, "TITLE", 5)) {
1248 } while (skip_line(line));
1249 if (av_sscanf(line, "%f %f %f", &lut1d->lut[0][i], &lut1d->lut[1][i], &lut1d->lut[2][i]) != 3)
1250 return AVERROR_INVALIDDATA;
1256 lut1d->scale.r = av_clipf(1. / (max[0] - min[0]), 0.f, 1.f);
1257 lut1d->scale.g = av_clipf(1. / (max[1] - min[1]), 0.f, 1.f);
1258 lut1d->scale.b = av_clipf(1. / (max[2] - min[2]), 0.f, 1.f);
1263 static const AVOption lut1d_options[] = {
1264 { "file", "set 1D LUT file name", OFFSET(file), AV_OPT_TYPE_STRING, {.str=NULL}, .flags = FLAGS },
1265 { "interp", "select interpolation mode", OFFSET(interpolation), AV_OPT_TYPE_INT, {.i64=INTERPOLATE_1D_LINEAR}, 0, NB_INTERP_1D_MODE-1, FLAGS, "interp_mode" },
1266 { "nearest", "use values from the nearest defined points", 0, AV_OPT_TYPE_CONST, {.i64=INTERPOLATE_1D_NEAREST}, INT_MIN, INT_MAX, FLAGS, "interp_mode" },
1267 { "linear", "use values from the linear interpolation", 0, AV_OPT_TYPE_CONST, {.i64=INTERPOLATE_1D_LINEAR}, INT_MIN, INT_MAX, FLAGS, "interp_mode" },
1268 { "cosine", "use values from the cosine interpolation", 0, AV_OPT_TYPE_CONST, {.i64=INTERPOLATE_1D_COSINE}, INT_MIN, INT_MAX, FLAGS, "interp_mode" },
1269 { "cubic", "use values from the cubic interpolation", 0, AV_OPT_TYPE_CONST, {.i64=INTERPOLATE_1D_CUBIC}, INT_MIN, INT_MAX, FLAGS, "interp_mode" },
1270 { "spline", "use values from the spline interpolation", 0, AV_OPT_TYPE_CONST, {.i64=INTERPOLATE_1D_SPLINE}, INT_MIN, INT_MAX, FLAGS, "interp_mode" },
1274 AVFILTER_DEFINE_CLASS(lut1d);
1276 static inline float interp_1d_nearest(const LUT1DContext *lut1d,
1277 int idx, const float s)
1279 return lut1d->lut[idx][NEAR(s)];
1282 #define NEXT1D(x) (FFMIN((int)(x) + 1, lut1d->lutsize - 1))
1284 static inline float interp_1d_linear(const LUT1DContext *lut1d,
1285 int idx, const float s)
1287 const int prev = PREV(s);
1288 const int next = NEXT1D(s);
1289 const float d = s - prev;
1290 const float p = lut1d->lut[idx][prev];
1291 const float n = lut1d->lut[idx][next];
1293 return lerpf(p, n, d);
1296 static inline float interp_1d_cosine(const LUT1DContext *lut1d,
1297 int idx, const float s)
1299 const int prev = PREV(s);
1300 const int next = NEXT1D(s);
1301 const float d = s - prev;
1302 const float p = lut1d->lut[idx][prev];
1303 const float n = lut1d->lut[idx][next];
1304 const float m = (1.f - cosf(d * M_PI)) * .5f;
1306 return lerpf(p, n, m);
1309 static inline float interp_1d_cubic(const LUT1DContext *lut1d,
1310 int idx, const float s)
1312 const int prev = PREV(s);
1313 const int next = NEXT1D(s);
1314 const float mu = s - prev;
1315 float a0, a1, a2, a3, mu2;
1317 float y0 = lut1d->lut[idx][FFMAX(prev - 1, 0)];
1318 float y1 = lut1d->lut[idx][prev];
1319 float y2 = lut1d->lut[idx][next];
1320 float y3 = lut1d->lut[idx][FFMIN(next + 1, lut1d->lutsize - 1)];
1324 a0 = y3 - y2 - y0 + y1;
1329 return a0 * mu * mu2 + a1 * mu2 + a2 * mu + a3;
1332 static inline float interp_1d_spline(const LUT1DContext *lut1d,
1333 int idx, const float s)
1335 const int prev = PREV(s);
1336 const int next = NEXT1D(s);
1337 const float x = s - prev;
1338 float c0, c1, c2, c3;
1340 float y0 = lut1d->lut[idx][FFMAX(prev - 1, 0)];
1341 float y1 = lut1d->lut[idx][prev];
1342 float y2 = lut1d->lut[idx][next];
1343 float y3 = lut1d->lut[idx][FFMIN(next + 1, lut1d->lutsize - 1)];
1346 c1 = .5f * (y2 - y0);
1347 c2 = y0 - 2.5f * y1 + 2.f * y2 - .5f * y3;
1348 c3 = .5f * (y3 - y0) + 1.5f * (y1 - y2);
1350 return ((c3 * x + c2) * x + c1) * x + c0;
1353 #define DEFINE_INTERP_FUNC_PLANAR_1D(name, nbits, depth) \
1354 static int interp_1d_##nbits##_##name##_p##depth(AVFilterContext *ctx, \
1355 void *arg, int jobnr, \
1359 const LUT1DContext *lut1d = ctx->priv; \
1360 const ThreadData *td = arg; \
1361 const AVFrame *in = td->in; \
1362 const AVFrame *out = td->out; \
1363 const int direct = out == in; \
1364 const int slice_start = (in->height * jobnr ) / nb_jobs; \
1365 const int slice_end = (in->height * (jobnr+1)) / nb_jobs; \
1366 uint8_t *grow = out->data[0] + slice_start * out->linesize[0]; \
1367 uint8_t *brow = out->data[1] + slice_start * out->linesize[1]; \
1368 uint8_t *rrow = out->data[2] + slice_start * out->linesize[2]; \
1369 uint8_t *arow = out->data[3] + slice_start * out->linesize[3]; \
1370 const uint8_t *srcgrow = in->data[0] + slice_start * in->linesize[0]; \
1371 const uint8_t *srcbrow = in->data[1] + slice_start * in->linesize[1]; \
1372 const uint8_t *srcrrow = in->data[2] + slice_start * in->linesize[2]; \
1373 const uint8_t *srcarow = in->data[3] + slice_start * in->linesize[3]; \
1374 const float factor = (1 << depth) - 1; \
1375 const float scale_r = (lut1d->scale.r / factor) * (lut1d->lutsize - 1); \
1376 const float scale_g = (lut1d->scale.g / factor) * (lut1d->lutsize - 1); \
1377 const float scale_b = (lut1d->scale.b / factor) * (lut1d->lutsize - 1); \
1379 for (y = slice_start; y < slice_end; y++) { \
1380 uint##nbits##_t *dstg = (uint##nbits##_t *)grow; \
1381 uint##nbits##_t *dstb = (uint##nbits##_t *)brow; \
1382 uint##nbits##_t *dstr = (uint##nbits##_t *)rrow; \
1383 uint##nbits##_t *dsta = (uint##nbits##_t *)arow; \
1384 const uint##nbits##_t *srcg = (const uint##nbits##_t *)srcgrow; \
1385 const uint##nbits##_t *srcb = (const uint##nbits##_t *)srcbrow; \
1386 const uint##nbits##_t *srcr = (const uint##nbits##_t *)srcrrow; \
1387 const uint##nbits##_t *srca = (const uint##nbits##_t *)srcarow; \
1388 for (x = 0; x < in->width; x++) { \
1389 float r = srcr[x] * scale_r; \
1390 float g = srcg[x] * scale_g; \
1391 float b = srcb[x] * scale_b; \
1392 r = interp_1d_##name(lut1d, 0, r); \
1393 g = interp_1d_##name(lut1d, 1, g); \
1394 b = interp_1d_##name(lut1d, 2, b); \
1395 dstr[x] = av_clip_uintp2(r * factor, depth); \
1396 dstg[x] = av_clip_uintp2(g * factor, depth); \
1397 dstb[x] = av_clip_uintp2(b * factor, depth); \
1398 if (!direct && in->linesize[3]) \
1399 dsta[x] = srca[x]; \
1401 grow += out->linesize[0]; \
1402 brow += out->linesize[1]; \
1403 rrow += out->linesize[2]; \
1404 arow += out->linesize[3]; \
1405 srcgrow += in->linesize[0]; \
1406 srcbrow += in->linesize[1]; \
1407 srcrrow += in->linesize[2]; \
1408 srcarow += in->linesize[3]; \
1413 DEFINE_INTERP_FUNC_PLANAR_1D(nearest, 8, 8)
1414 DEFINE_INTERP_FUNC_PLANAR_1D(linear, 8, 8)
1415 DEFINE_INTERP_FUNC_PLANAR_1D(cosine, 8, 8)
1416 DEFINE_INTERP_FUNC_PLANAR_1D(cubic, 8, 8)
1417 DEFINE_INTERP_FUNC_PLANAR_1D(spline, 8, 8)
1419 DEFINE_INTERP_FUNC_PLANAR_1D(nearest, 16, 9)
1420 DEFINE_INTERP_FUNC_PLANAR_1D(linear, 16, 9)
1421 DEFINE_INTERP_FUNC_PLANAR_1D(cosine, 16, 9)
1422 DEFINE_INTERP_FUNC_PLANAR_1D(cubic, 16, 9)
1423 DEFINE_INTERP_FUNC_PLANAR_1D(spline, 16, 9)
1425 DEFINE_INTERP_FUNC_PLANAR_1D(nearest, 16, 10)
1426 DEFINE_INTERP_FUNC_PLANAR_1D(linear, 16, 10)
1427 DEFINE_INTERP_FUNC_PLANAR_1D(cosine, 16, 10)
1428 DEFINE_INTERP_FUNC_PLANAR_1D(cubic, 16, 10)
1429 DEFINE_INTERP_FUNC_PLANAR_1D(spline, 16, 10)
1431 DEFINE_INTERP_FUNC_PLANAR_1D(nearest, 16, 12)
1432 DEFINE_INTERP_FUNC_PLANAR_1D(linear, 16, 12)
1433 DEFINE_INTERP_FUNC_PLANAR_1D(cosine, 16, 12)
1434 DEFINE_INTERP_FUNC_PLANAR_1D(cubic, 16, 12)
1435 DEFINE_INTERP_FUNC_PLANAR_1D(spline, 16, 12)
1437 DEFINE_INTERP_FUNC_PLANAR_1D(nearest, 16, 14)
1438 DEFINE_INTERP_FUNC_PLANAR_1D(linear, 16, 14)
1439 DEFINE_INTERP_FUNC_PLANAR_1D(cosine, 16, 14)
1440 DEFINE_INTERP_FUNC_PLANAR_1D(cubic, 16, 14)
1441 DEFINE_INTERP_FUNC_PLANAR_1D(spline, 16, 14)
1443 DEFINE_INTERP_FUNC_PLANAR_1D(nearest, 16, 16)
1444 DEFINE_INTERP_FUNC_PLANAR_1D(linear, 16, 16)
1445 DEFINE_INTERP_FUNC_PLANAR_1D(cosine, 16, 16)
1446 DEFINE_INTERP_FUNC_PLANAR_1D(cubic, 16, 16)
1447 DEFINE_INTERP_FUNC_PLANAR_1D(spline, 16, 16)
1449 #define DEFINE_INTERP_FUNC_1D(name, nbits) \
1450 static int interp_1d_##nbits##_##name(AVFilterContext *ctx, void *arg, \
1451 int jobnr, int nb_jobs) \
1454 const LUT1DContext *lut1d = ctx->priv; \
1455 const ThreadData *td = arg; \
1456 const AVFrame *in = td->in; \
1457 const AVFrame *out = td->out; \
1458 const int direct = out == in; \
1459 const int step = lut1d->step; \
1460 const uint8_t r = lut1d->rgba_map[R]; \
1461 const uint8_t g = lut1d->rgba_map[G]; \
1462 const uint8_t b = lut1d->rgba_map[B]; \
1463 const uint8_t a = lut1d->rgba_map[A]; \
1464 const int slice_start = (in->height * jobnr ) / nb_jobs; \
1465 const int slice_end = (in->height * (jobnr+1)) / nb_jobs; \
1466 uint8_t *dstrow = out->data[0] + slice_start * out->linesize[0]; \
1467 const uint8_t *srcrow = in ->data[0] + slice_start * in ->linesize[0]; \
1468 const float factor = (1 << nbits) - 1; \
1469 const float scale_r = (lut1d->scale.r / factor) * (lut1d->lutsize - 1); \
1470 const float scale_g = (lut1d->scale.g / factor) * (lut1d->lutsize - 1); \
1471 const float scale_b = (lut1d->scale.b / factor) * (lut1d->lutsize - 1); \
1473 for (y = slice_start; y < slice_end; y++) { \
1474 uint##nbits##_t *dst = (uint##nbits##_t *)dstrow; \
1475 const uint##nbits##_t *src = (const uint##nbits##_t *)srcrow; \
1476 for (x = 0; x < in->width * step; x += step) { \
1477 float rr = src[x + r] * scale_r; \
1478 float gg = src[x + g] * scale_g; \
1479 float bb = src[x + b] * scale_b; \
1480 rr = interp_1d_##name(lut1d, 0, rr); \
1481 gg = interp_1d_##name(lut1d, 1, gg); \
1482 bb = interp_1d_##name(lut1d, 2, bb); \
1483 dst[x + r] = av_clip_uint##nbits(rr * factor); \
1484 dst[x + g] = av_clip_uint##nbits(gg * factor); \
1485 dst[x + b] = av_clip_uint##nbits(bb * factor); \
1486 if (!direct && step == 4) \
1487 dst[x + a] = src[x + a]; \
1489 dstrow += out->linesize[0]; \
1490 srcrow += in ->linesize[0]; \
1495 DEFINE_INTERP_FUNC_1D(nearest, 8)
1496 DEFINE_INTERP_FUNC_1D(linear, 8)
1497 DEFINE_INTERP_FUNC_1D(cosine, 8)
1498 DEFINE_INTERP_FUNC_1D(cubic, 8)
1499 DEFINE_INTERP_FUNC_1D(spline, 8)
1501 DEFINE_INTERP_FUNC_1D(nearest, 16)
1502 DEFINE_INTERP_FUNC_1D(linear, 16)
1503 DEFINE_INTERP_FUNC_1D(cosine, 16)
1504 DEFINE_INTERP_FUNC_1D(cubic, 16)
1505 DEFINE_INTERP_FUNC_1D(spline, 16)
1507 static int config_input_1d(AVFilterLink *inlink)
1509 int depth, is16bit = 0, planar = 0;
1510 LUT1DContext *lut1d = inlink->dst->priv;
1511 const AVPixFmtDescriptor *desc = av_pix_fmt_desc_get(inlink->format);
1513 depth = desc->comp[0].depth;
1515 switch (inlink->format) {
1516 case AV_PIX_FMT_RGB48:
1517 case AV_PIX_FMT_BGR48:
1518 case AV_PIX_FMT_RGBA64:
1519 case AV_PIX_FMT_BGRA64:
1522 case AV_PIX_FMT_GBRP9:
1523 case AV_PIX_FMT_GBRP10:
1524 case AV_PIX_FMT_GBRP12:
1525 case AV_PIX_FMT_GBRP14:
1526 case AV_PIX_FMT_GBRP16:
1527 case AV_PIX_FMT_GBRAP10:
1528 case AV_PIX_FMT_GBRAP12:
1529 case AV_PIX_FMT_GBRAP16:
1531 case AV_PIX_FMT_GBRP:
1532 case AV_PIX_FMT_GBRAP:
1537 ff_fill_rgba_map(lut1d->rgba_map, inlink->format);
1538 lut1d->step = av_get_padded_bits_per_pixel(desc) >> (3 + is16bit);
1540 #define SET_FUNC_1D(name) do { \
1543 case 8: lut1d->interp = interp_1d_8_##name##_p8; break; \
1544 case 9: lut1d->interp = interp_1d_16_##name##_p9; break; \
1545 case 10: lut1d->interp = interp_1d_16_##name##_p10; break; \
1546 case 12: lut1d->interp = interp_1d_16_##name##_p12; break; \
1547 case 14: lut1d->interp = interp_1d_16_##name##_p14; break; \
1548 case 16: lut1d->interp = interp_1d_16_##name##_p16; break; \
1550 } else if (is16bit) { lut1d->interp = interp_1d_16_##name; \
1551 } else { lut1d->interp = interp_1d_8_##name; } \
1554 switch (lut1d->interpolation) {
1555 case INTERPOLATE_1D_NEAREST: SET_FUNC_1D(nearest); break;
1556 case INTERPOLATE_1D_LINEAR: SET_FUNC_1D(linear); break;
1557 case INTERPOLATE_1D_COSINE: SET_FUNC_1D(cosine); break;
1558 case INTERPOLATE_1D_CUBIC: SET_FUNC_1D(cubic); break;
1559 case INTERPOLATE_1D_SPLINE: SET_FUNC_1D(spline); break;
1567 static av_cold int lut1d_init(AVFilterContext *ctx)
1572 LUT1DContext *lut1d = ctx->priv;
1574 lut1d->scale.r = lut1d->scale.g = lut1d->scale.b = 1.f;
1577 set_identity_matrix_1d(lut1d, 32);
1581 f = fopen(lut1d->file, "r");
1583 ret = AVERROR(errno);
1584 av_log(ctx, AV_LOG_ERROR, "%s: %s\n", lut1d->file, av_err2str(ret));
1588 ext = strrchr(lut1d->file, '.');
1590 av_log(ctx, AV_LOG_ERROR, "Unable to guess the format from the extension\n");
1591 ret = AVERROR_INVALIDDATA;
1596 if (!av_strcasecmp(ext, "cube") || !av_strcasecmp(ext, "1dlut")) {
1597 ret = parse_cube_1d(ctx, f);
1598 } else if (!av_strcasecmp(ext, "csp")) {
1599 ret = parse_cinespace_1d(ctx, f);
1601 av_log(ctx, AV_LOG_ERROR, "Unrecognized '.%s' file type\n", ext);
1602 ret = AVERROR(EINVAL);
1605 if (!ret && !lut1d->lutsize) {
1606 av_log(ctx, AV_LOG_ERROR, "1D LUT is empty\n");
1607 ret = AVERROR_INVALIDDATA;
1615 static AVFrame *apply_1d_lut(AVFilterLink *inlink, AVFrame *in)
1617 AVFilterContext *ctx = inlink->dst;
1618 LUT1DContext *lut1d = ctx->priv;
1619 AVFilterLink *outlink = inlink->dst->outputs[0];
1623 if (av_frame_is_writable(in)) {
1626 out = ff_get_video_buffer(outlink, outlink->w, outlink->h);
1631 av_frame_copy_props(out, in);
1636 ctx->internal->execute(ctx, lut1d->interp, &td, NULL, FFMIN(outlink->h, ff_filter_get_nb_threads(ctx)));
1644 static int filter_frame_1d(AVFilterLink *inlink, AVFrame *in)
1646 AVFilterLink *outlink = inlink->dst->outputs[0];
1647 AVFrame *out = apply_1d_lut(inlink, in);
1649 return AVERROR(ENOMEM);
1650 return ff_filter_frame(outlink, out);
1653 static const AVFilterPad lut1d_inputs[] = {
1656 .type = AVMEDIA_TYPE_VIDEO,
1657 .filter_frame = filter_frame_1d,
1658 .config_props = config_input_1d,
1663 static const AVFilterPad lut1d_outputs[] = {
1666 .type = AVMEDIA_TYPE_VIDEO,
1671 AVFilter ff_vf_lut1d = {
1673 .description = NULL_IF_CONFIG_SMALL("Adjust colors using a 1D LUT."),
1674 .priv_size = sizeof(LUT1DContext),
1676 .query_formats = query_formats,
1677 .inputs = lut1d_inputs,
1678 .outputs = lut1d_outputs,
1679 .priv_class = &lut1d_class,
1680 .flags = AVFILTER_FLAG_SUPPORT_TIMELINE_GENERIC | AVFILTER_FLAG_SLICE_THREADS,