2 * Discrete wavelet transform
3 * Copyright (c) 2007 Kamil Nowosad
4 * Copyright (c) 2013 Nicolas Bertrand <nicoinattendu@gmail.com>
6 * This file is part of FFmpeg.
8 * FFmpeg is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU Lesser General Public
10 * License as published by the Free Software Foundation; either
11 * version 2.1 of the License, or (at your option) any later version.
13 * FFmpeg is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 * Lesser General Public License for more details.
18 * You should have received a copy of the GNU Lesser General Public
19 * License along with FFmpeg; if not, write to the Free Software
20 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
25 * Discrete wavelet transform
28 #include "libavutil/avassert.h"
29 #include "libavutil/common.h"
30 #include "libavutil/mem.h"
31 #include "jpeg2000dwt.h"
34 /* Defines for 9/7 DWT lifting parameters.
35 * Parameters are in float. */
36 #define F_LFTG_ALPHA 1.586134342059924f
37 #define F_LFTG_BETA 0.052980118572961f
38 #define F_LFTG_GAMMA 0.882911075530934f
39 #define F_LFTG_DELTA 0.443506852043971f
40 #define F_LFTG_K 1.230174104914001f
41 #define F_LFTG_X 1.625732422f
42 /* FIXME: Why use 1.625732422 instead of 1/F_LFTG_K?
43 * Incorrect value in JPEG2000 norm.
44 * see (ISO/IEC 15444:1 (version 2002) F.3.8.2 */
46 /* Lifting parameters in integer format.
47 * Computed as param = (float param) * (1 << 16) */
48 #define I_LFTG_ALPHA 103949
49 #define I_LFTG_BETA 3472
50 #define I_LFTG_GAMMA 57862
51 #define I_LFTG_DELTA 29066
52 #define I_LFTG_K 80621
53 #define I_LFTG_X 106544
55 static inline void extend53(int *p, int i0, int i1)
57 p[i0 - 1] = p[i0 + 1];
59 p[i0 - 2] = p[i0 + 2];
60 p[i1 + 1] = p[i1 - 3];
63 static inline void extend97_float(float *p, int i0, int i1)
67 for (i = 1; i <= 4; i++) {
68 p[i0 - i] = p[i0 + i];
69 p[i1 + i - 1] = p[i1 - i - 1];
73 static inline void extend97_int(int32_t *p, int i0, int i1)
77 for (i = 1; i <= 4; i++) {
78 p[i0 - i] = p[i0 + i];
79 p[i1 + i - 1] = p[i1 - i - 1];
83 static void sd_1d53(int *p, int i0, int i1)
95 for (i = (i0+1)/2 - 1; i < (i1+1)/2; i++)
96 p[2*i+1] -= (p[2*i] + p[2*i+2]) >> 1;
97 for (i = (i0+1)/2; i < (i1+1)/2; i++)
98 p[2*i] += (p[2*i-1] + p[2*i+1] + 2) >> 2;
101 static void dwt_encode53(DWTContext *s, int *t)
104 w = s->linelen[s->ndeclevels-1][0];
105 int *line = s->i_linebuf;
108 for (lev = s->ndeclevels-1; lev >= 0; lev--){
109 int lh = s->linelen[lev][0],
110 lv = s->linelen[lev][1],
118 for (lp = 0; lp < lh; lp++) {
121 for (i = 0; i < lv; i++)
124 sd_1d53(line, mv, mv + lv);
126 // copy back and deinterleave
127 for (i = mv; i < lv; i+=2, j++)
129 for (i = 1-mv; i < lv; i+=2, j++)
135 for (lp = 0; lp < lv; lp++){
138 for (i = 0; i < lh; i++)
141 sd_1d53(line, mh, mh + lh);
143 // copy back and deinterleave
144 for (i = mh; i < lh; i+=2, j++)
146 for (i = 1-mh; i < lh; i+=2, j++)
151 static void sd_1d97_float(float *p, int i0, int i1)
163 extend97_float(p, i0, i1);
166 for (i = i0/2 - 2; i < i1/2 + 1; i++)
167 p[2*i+1] -= 1.586134 * (p[2*i] + p[2*i+2]);
168 for (i = i0/2 - 1; i < i1/2 + 1; i++)
169 p[2*i] -= 0.052980 * (p[2*i-1] + p[2*i+1]);
170 for (i = i0/2 - 1; i < i1/2; i++)
171 p[2*i+1] += 0.882911 * (p[2*i] + p[2*i+2]);
172 for (i = i0/2; i < i1/2; i++)
173 p[2*i] += 0.443506 * (p[2*i-1] + p[2*i+1]);
176 static void dwt_encode97_float(DWTContext *s, float *t)
179 w = s->linelen[s->ndeclevels-1][0];
180 float *line = s->f_linebuf;
183 for (lev = s->ndeclevels-1; lev >= 0; lev--){
184 int lh = s->linelen[lev][0],
185 lv = s->linelen[lev][1],
191 av_assert1(!mh && !mv);
194 for (lp = 0; lp < lv; lp++){
197 for (i = 0; i < lh; i++)
200 sd_1d97_float(line, mh, mh + lh);
202 // copy back and deinterleave
203 for (i = mh; i < lh; i+=2, j++)
204 t[w*lp + j] = F_LFTG_X * l[i] / 2;
205 for (i = 1-mh; i < lh; i+=2, j++)
206 t[w*lp + j] = F_LFTG_K * l[i] / 2;
211 for (lp = 0; lp < lh; lp++) {
214 for (i = 0; i < lv; i++)
217 sd_1d97_float(line, mv, mv + lv);
219 // copy back and deinterleave
220 for (i = mv; i < lv; i+=2, j++)
221 t[w*j + lp] = F_LFTG_X * l[i] / 2;
222 for (i = 1-mv; i < lv; i+=2, j++)
223 t[w*j + lp] = F_LFTG_K * l[i] / 2;
228 static void sd_1d97_int(int *p, int i0, int i1)
234 p[1] = (p[1] * I_LFTG_X + (1<<15)) >> 16;
236 p[0] = (p[0] * I_LFTG_K + (1<<15)) >> 16;
240 extend97_int(p, i0, i1);
243 for (i = i0/2 - 2; i < i1/2 + 1; i++)
244 p[2 * i + 1] -= (I_LFTG_ALPHA * (p[2 * i] + p[2 * i + 2]) + (1 << 15)) >> 16;
245 for (i = i0/2 - 1; i < i1/2 + 1; i++)
246 p[2 * i] -= (I_LFTG_BETA * (p[2 * i - 1] + p[2 * i + 1]) + (1 << 15)) >> 16;
247 for (i = i0/2 - 1; i < i1/2; i++)
248 p[2 * i + 1] += (I_LFTG_GAMMA * (p[2 * i] + p[2 * i + 2]) + (1 << 15)) >> 16;
249 for (i = i0/2; i < i1/2; i++)
250 p[2 * i] += (I_LFTG_DELTA * (p[2 * i - 1] + p[2 * i + 1]) + (1 << 15)) >> 16;
253 static void dwt_encode97_int(DWTContext *s, int *t)
256 w = s->linelen[s->ndeclevels-1][0];
257 int *line = s->i_linebuf;
260 for (lev = s->ndeclevels-1; lev >= 0; lev--){
261 int lh = s->linelen[lev][0],
262 lv = s->linelen[lev][1],
268 av_assert1(!mh && !mv);
272 for (lp = 0; lp < lh; lp++) {
275 for (i = 0; i < lv; i++)
278 sd_1d97_int(line, mv, mv + lv);
280 // copy back and deinterleave
281 for (i = mv; i < lv; i+=2, j++)
282 t[w*j + lp] = ((l[i] * I_LFTG_X) + (1 << 16)) >> 17;
283 for (i = 1-mv; i < lv; i+=2, j++)
284 t[w*j + lp] = ((l[i] * I_LFTG_K) + (1 << 16)) >> 17;
289 for (lp = 0; lp < lv; lp++){
292 for (i = 0; i < lh; i++)
295 sd_1d97_int(line, mh, mh + lh);
297 // copy back and deinterleave
298 for (i = mh; i < lh; i+=2, j++)
299 t[w*lp + j] = ((l[i] * I_LFTG_X) + (1 << 16)) >> 17;
300 for (i = 1-mh; i < lh; i+=2, j++)
301 t[w*lp + j] = ((l[i] * I_LFTG_K) + (1 << 16)) >> 17;
307 static void sr_1d53(int *p, int i0, int i1)
319 for (i = i0 / 2; i < i1 / 2 + 1; i++)
320 p[2 * i] -= (p[2 * i - 1] + p[2 * i + 1] + 2) >> 2;
321 for (i = i0 / 2; i < i1 / 2; i++)
322 p[2 * i + 1] += (p[2 * i] + p[2 * i + 2]) >> 1;
325 static void dwt_decode53(DWTContext *s, int *t)
328 int w = s->linelen[s->ndeclevels - 1][0];
329 int32_t *line = s->i_linebuf;
332 for (lev = 0; lev < s->ndeclevels; lev++) {
333 int lh = s->linelen[lev][0],
334 lv = s->linelen[lev][1],
342 for (lp = 0; lp < lv; lp++) {
344 // copy with interleaving
345 for (i = mh; i < lh; i += 2, j++)
346 l[i] = t[w * lp + j];
347 for (i = 1 - mh; i < lh; i += 2, j++)
348 l[i] = t[w * lp + j];
350 sr_1d53(line, mh, mh + lh);
352 for (i = 0; i < lh; i++)
353 t[w * lp + i] = l[i];
358 for (lp = 0; lp < lh; lp++) {
360 // copy with interleaving
361 for (i = mv; i < lv; i += 2, j++)
362 l[i] = t[w * j + lp];
363 for (i = 1 - mv; i < lv; i += 2, j++)
364 l[i] = t[w * j + lp];
366 sr_1d53(line, mv, mv + lv);
368 for (i = 0; i < lv; i++)
369 t[w * i + lp] = l[i];
374 static void sr_1d97_float(float *p, int i0, int i1)
386 extend97_float(p, i0, i1);
388 for (i = i0 / 2 - 1; i < i1 / 2 + 2; i++)
389 p[2 * i] -= F_LFTG_DELTA * (p[2 * i - 1] + p[2 * i + 1]);
391 for (i = i0 / 2 - 1; i < i1 / 2 + 1; i++)
392 p[2 * i + 1] -= F_LFTG_GAMMA * (p[2 * i] + p[2 * i + 2]);
394 for (i = i0 / 2; i < i1 / 2 + 1; i++)
395 p[2 * i] += F_LFTG_BETA * (p[2 * i - 1] + p[2 * i + 1]);
397 for (i = i0 / 2; i < i1 / 2; i++)
398 p[2 * i + 1] += F_LFTG_ALPHA * (p[2 * i] + p[2 * i + 2]);
401 static void dwt_decode97_float(DWTContext *s, float *t)
404 int w = s->linelen[s->ndeclevels - 1][0];
405 float *line = s->f_linebuf;
407 /* position at index O of line range [0-5,w+5] cf. extend function */
410 for (lev = 0; lev < s->ndeclevels; lev++) {
411 int lh = s->linelen[lev][0],
412 lv = s->linelen[lev][1],
419 for (lp = 0; lp < lv; lp++) {
421 // copy with interleaving
422 for (i = mh; i < lh; i += 2, j++)
423 l[i] = data[w * lp + j] * F_LFTG_K;
424 for (i = 1 - mh; i < lh; i += 2, j++)
425 l[i] = data[w * lp + j] * F_LFTG_X;
427 sr_1d97_float(line, mh, mh + lh);
429 for (i = 0; i < lh; i++)
430 data[w * lp + i] = l[i];
435 for (lp = 0; lp < lh; lp++) {
437 // copy with interleaving
438 for (i = mv; i < lv; i += 2, j++)
439 l[i] = data[w * j + lp] * F_LFTG_K;
440 for (i = 1 - mv; i < lv; i += 2, j++)
441 l[i] = data[w * j + lp] * F_LFTG_X;
443 sr_1d97_float(line, mv, mv + lv);
445 for (i = 0; i < lv; i++)
446 data[w * i + lp] = l[i];
451 static void sr_1d97_int(int32_t *p, int i0, int i1)
457 p[1] = (p[1] * I_LFTG_K + (1<<16)) >> 17;
459 p[0] = (p[0] * I_LFTG_X + (1<<16)) >> 17;
463 extend97_int(p, i0, i1);
465 for (i = i0 / 2 - 1; i < i1 / 2 + 2; i++)
466 p[2 * i] -= (I_LFTG_DELTA * (p[2 * i - 1] + p[2 * i + 1]) + (1 << 15)) >> 16;
468 for (i = i0 / 2 - 1; i < i1 / 2 + 1; i++)
469 p[2 * i + 1] -= (I_LFTG_GAMMA * (p[2 * i] + p[2 * i + 2]) + (1 << 15)) >> 16;
471 for (i = i0 / 2; i < i1 / 2 + 1; i++)
472 p[2 * i] += (I_LFTG_BETA * (p[2 * i - 1] + p[2 * i + 1]) + (1 << 15)) >> 16;
474 for (i = i0 / 2; i < i1 / 2; i++)
475 p[2 * i + 1] += (I_LFTG_ALPHA * (p[2 * i] + p[2 * i + 2]) + (1 << 15)) >> 16;
478 static void dwt_decode97_int(DWTContext *s, int32_t *t)
481 int w = s->linelen[s->ndeclevels - 1][0];
482 int32_t *line = s->i_linebuf;
484 /* position at index O of line range [0-5,w+5] cf. extend function */
487 for (lev = 0; lev < s->ndeclevels; lev++) {
488 int lh = s->linelen[lev][0],
489 lv = s->linelen[lev][1],
496 for (lp = 0; lp < lv; lp++) {
498 // rescale with interleaving
499 for (i = mh; i < lh; i += 2, j++)
500 l[i] = ((data[w * lp + j] * I_LFTG_K) + (1 << 15)) >> 16;
501 for (i = 1 - mh; i < lh; i += 2, j++)
502 l[i] = ((data[w * lp + j] * I_LFTG_X) + (1 << 15)) >> 16;
504 sr_1d97_int(line, mh, mh + lh);
506 for (i = 0; i < lh; i++)
507 data[w * lp + i] = l[i];
512 for (lp = 0; lp < lh; lp++) {
514 // rescale with interleaving
515 for (i = mv; i < lv; i += 2, j++)
516 l[i] = ((data[w * j + lp] * I_LFTG_K) + (1 << 15)) >> 16;
517 for (i = 1 - mv; i < lv; i += 2, j++)
518 l[i] = ((data[w * j + lp] * I_LFTG_X) + (1 << 15)) >> 16;
520 sr_1d97_int(line, mv, mv + lv);
522 for (i = 0; i < lv; i++)
523 data[w * i + lp] = l[i];
528 int ff_jpeg2000_dwt_init(DWTContext *s, uint16_t border[2][2],
529 int decomp_levels, int type)
531 int i, j, lev = decomp_levels, maxlen,
534 s->ndeclevels = decomp_levels;
537 for (i = 0; i < 2; i++)
538 for (j = 0; j < 2; j++)
539 b[i][j] = border[i][j];
541 maxlen = FFMAX(b[0][1] - b[0][0],
544 for (i = 0; i < 2; i++) {
545 s->linelen[lev][i] = b[i][1] - b[i][0];
546 s->mod[lev][i] = b[i][0] & 1;
547 for (j = 0; j < 2; j++)
548 b[i][j] = (b[i][j] + 1) >> 1;
552 s->f_linebuf = av_malloc_array((maxlen + 12), sizeof(*s->f_linebuf));
554 return AVERROR(ENOMEM);
557 s->i_linebuf = av_malloc_array((maxlen + 12), sizeof(*s->i_linebuf));
559 return AVERROR(ENOMEM);
562 s->i_linebuf = av_malloc_array((maxlen + 6), sizeof(*s->i_linebuf));
564 return AVERROR(ENOMEM);
572 int ff_dwt_encode(DWTContext *s, void *t)
576 dwt_encode97_float(s, t); break;
578 dwt_encode97_int(s, t); break;
580 dwt_encode53(s, t); break;
587 int ff_dwt_decode(DWTContext *s, void *t)
591 dwt_decode97_float(s, t);
594 dwt_decode97_int(s, t);
605 void ff_dwt_destroy(DWTContext *s)
607 av_freep(&s->f_linebuf);
608 av_freep(&s->i_linebuf);
613 #include "libavutil/lfg.h"
617 static int test_dwt(int *array, int *ref, uint16_t border[2][2], int decomp_levels, int type) {
619 DWTContext s1={{{0}}}, *s= &s1;
621 ret = ff_jpeg2000_dwt_init(s, border, decomp_levels, type);
623 fprintf(stderr, "ff_jpeg2000_dwt_init failed\n");
626 ret = ff_dwt_encode(s, array);
628 fprintf(stderr, "ff_dwt_encode failed\n");
631 ret = ff_dwt_decode(s, array);
633 fprintf(stderr, "ff_dwt_encode failed\n");
636 for (j = 0; j<MAX_W * MAX_W; j++)
637 if (array[j] != ref[j]) {
638 fprintf(stderr, "missmatch at %d (%d != %d) decomp:%d border %d %d %d %d\n",
639 j, array[j], ref[j],decomp_levels, border[0][0], border[0][1], border[1][0], border[1][1]);
648 int array[MAX_W * MAX_W];
649 int ref [MAX_W * MAX_W];
652 uint16_t border[2][2];
653 int ret, decomp_levels;
655 av_lfg_init(&prng, 1);
657 for (i = 0; i<MAX_W * MAX_W; i++)
658 array[i] = ref[i] = av_lfg_get(&prng) % 2048;
660 for (i = 0; i < 40; i++) {
662 border[j>>1][j&1] = av_lfg_get(&prng) % MAX_W;
663 if (border[0][0] >= border[0][1] || border[1][0] >= border[1][1])
665 decomp_levels = av_lfg_get(&prng) % FF_DWT_MAX_DECLVLS;
667 ret = test_dwt(array, ref, border, decomp_levels, FF_DWT53);