FFmpeg
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
faxcompr.c
Go to the documentation of this file.
1 /*
2  * CCITT Fax Group 3 and 4 decompression
3  * Copyright (c) 2008 Konstantin Shishkov
4  *
5  * This file is part of FFmpeg.
6  *
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.
11  *
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.
16  *
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
20  */
21 
22 /**
23  * @file
24  * CCITT Fax Group 3 and 4 decompression
25  * @author Konstantin Shishkov
26  */
27 #include "avcodec.h"
28 #include "get_bits.h"
29 #include "put_bits.h"
30 #include "faxcompr.h"
31 
32 #define CCITT_SYMS 104
33 
34 static const uint16_t ccitt_syms[CCITT_SYMS] = {
35  0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12,
36  13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25,
37  26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38,
38  39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51,
39  52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64,
40  128, 192, 256, 320, 384, 448, 512, 576, 640, 704, 768, 832, 896,
41  960, 1024, 1088, 1152, 1216, 1280, 1344, 1408, 1472, 1536, 1600, 1664, 1728,
42  1792, 1856, 1920, 1984, 2048, 2112, 2176, 2240, 2304, 2368, 2432, 2496, 2560
43 };
44 
46 {
47  {
48  0x35, 0x07, 0x07, 0x08, 0x0B, 0x0C, 0x0E, 0x0F, 0x13, 0x14, 0x07, 0x08, 0x08,
49  0x03, 0x34, 0x35, 0x2A, 0x2B, 0x27, 0x0C, 0x08, 0x17, 0x03, 0x04, 0x28, 0x2B,
50  0x13, 0x24, 0x18, 0x02, 0x03, 0x1A, 0x1B, 0x12, 0x13, 0x14, 0x15, 0x16, 0x17,
51  0x28, 0x29, 0x2A, 0x2B, 0x2C, 0x2D, 0x04, 0x05, 0x0A, 0x0B, 0x52, 0x53, 0x54,
52  0x55, 0x24, 0x25, 0x58, 0x59, 0x5A, 0x5B, 0x4A, 0x4B, 0x32, 0x33, 0x34, 0x1B,
53  0x12, 0x17, 0x37, 0x36, 0x37, 0x64, 0x65, 0x68, 0x67, 0xCC, 0xCD, 0xD2, 0xD3,
54  0xD4, 0xD5, 0xD6, 0xD7, 0xD8, 0xD9, 0xDA, 0xDB, 0x98, 0x99, 0x9A, 0x18, 0x9B,
55  0x08, 0x0C, 0x0D, 0x12, 0x13, 0x14, 0x15, 0x16, 0x17, 0x1C, 0x1D, 0x1E, 0x1F
56  },
57  {
58  0x37, 0x02, 0x03, 0x02, 0x03, 0x03, 0x02, 0x03, 0x05, 0x04, 0x04, 0x05, 0x07,
59  0x04, 0x07, 0x18, 0x17, 0x18, 0x08, 0x67, 0x68, 0x6C, 0x37, 0x28, 0x17, 0x18,
60  0xCA, 0xCB, 0xCC, 0xCD, 0x68, 0x69, 0x6A, 0x6B, 0xD2, 0xD3, 0xD4, 0xD5, 0xD6,
61  0xD7, 0x6C, 0x6D, 0xDA, 0xDB, 0x54, 0x55, 0x56, 0x57, 0x64, 0x65, 0x52, 0x53,
62  0x24, 0x37, 0x38, 0x27, 0x28, 0x58, 0x59, 0x2B, 0x2C, 0x5A, 0x66, 0x67, 0x0F,
63  0xC8, 0xC9, 0x5B, 0x33, 0x34, 0x35, 0x6C, 0x6D, 0x4A, 0x4B, 0x4C, 0x4D, 0x72,
64  0x73, 0x74, 0x75, 0x76, 0x77, 0x52, 0x53, 0x54, 0x55, 0x5A, 0x5B, 0x64, 0x65,
65  0x08, 0x0C, 0x0D, 0x12, 0x13, 0x14, 0x15, 0x16, 0x17, 0x1C, 0x1D, 0x1E, 0x1F
66  }
67 };
68 
70 {
71  {
72  8, 6, 4, 4, 4, 4, 4, 4, 5, 5, 5, 5, 6, 6, 6, 6, 6, 6, 7, 7,
73  7, 7, 7, 7, 7, 7, 7, 7, 7, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8,
74  8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8,
75  8, 8, 8, 8, 5, 5, 6, 7, 8, 8, 8, 8, 8, 8, 9, 9, 9, 9, 9, 9,
76  9, 9, 9, 9, 9, 9, 9, 9, 9, 6, 9, 11, 11, 11, 12, 12, 12, 12, 12, 12,
77  12, 12, 12, 12
78  },
79  {
80  10, 3, 2, 2, 3, 4, 4, 5, 6, 6, 7, 7, 7, 8, 8, 9, 10, 10, 10, 11,
81  11, 11, 11, 11, 11, 11, 12, 12, 12, 12, 12, 12, 12, 12, 12, 12, 12, 12, 12, 12,
82  12, 12, 12, 12, 12, 12, 12, 12, 12, 12, 12, 12, 12, 12, 12, 12, 12, 12, 12, 12,
83  12, 12, 12, 12, 10, 12, 12, 12, 12, 12, 12, 13, 13, 13, 13, 13, 13, 13, 13, 13,
84  13, 13, 13, 13, 13, 13, 13, 13, 13, 13, 13, 11, 11, 11, 12, 12, 12, 12, 12, 12,
85  12, 12, 12, 12
86  }
87 };
88 
89 static const uint8_t ccitt_group3_2d_bits[11] = {
90  1, 1, 2, 2, 2, 1, 3, 3, 3, 1, 1
91 };
92 
93 static const uint8_t ccitt_group3_2d_lens[11] = {
94  4, 3, 7, 6, 3, 1, 3, 6, 7, 7, 9
95 };
96 
98 
100 {
101  static VLC_TYPE code_table1[528][2];
102  static VLC_TYPE code_table2[648][2];
103  int i;
104  static int initialized = 0;
105 
106  if (initialized)
107  return;
108  ccitt_vlc[0].table = code_table1;
109  ccitt_vlc[0].table_allocated = 528;
110  ccitt_vlc[1].table = code_table2;
111  ccitt_vlc[1].table_allocated = 648;
112  for (i = 0; i < 2; i++) {
113  ff_init_vlc_sparse(&ccitt_vlc[i], 9, CCITT_SYMS,
114  ccitt_codes_lens[i], 1, 1,
115  ccitt_codes_bits[i], 1, 1,
116  ccitt_syms, 2, 2,
118  }
119  INIT_VLC_STATIC(&ccitt_group3_2d_vlc, 9, 11,
120  ccitt_group3_2d_lens, 1, 1,
121  ccitt_group3_2d_bits, 1, 1, 512);
122  initialized = 1;
123 }
124 
126  unsigned int *pix_left, int **runs,
127  const int *runend, int *mode)
128 {
129  int eob = 0;
130  int newmode;
131  int saved_run = 0;
132 
133  do {
134  int cwi, k;
135  int cw = 0;
136  int codes[2];
137  do {
138  cwi = show_bits(gb, 11);
139  if (!cwi) {
140  av_log(avctx, AV_LOG_ERROR, "Invalid uncompressed codeword\n");
141  return AVERROR_INVALIDDATA;
142  }
143  cwi = 10 - av_log2(cwi);
144  skip_bits(gb, cwi + 1);
145  if (cwi > 5) {
146  newmode = get_bits1(gb);
147  eob = 1;
148  cwi -= 6;
149  }
150  cw += cwi;
151  } while(cwi == 5);
152 
153  codes[0] = cw;
154  codes[1] = !eob;
155 
156  for (k = 0; k < 2; k++) {
157  if (codes[k]) {
158  if (*mode == !k) {
159  *(*runs)++ = saved_run;
160  if (*runs >= runend) {
161  av_log(avctx, AV_LOG_ERROR, "uncompressed run overrun\n");
162  return AVERROR_INVALIDDATA;
163  }
164  if (*pix_left <= saved_run) {
165  av_log(avctx, AV_LOG_ERROR, "uncompressed run went out of bounds\n");
166  return AVERROR_INVALIDDATA;
167  }
168  *pix_left -= saved_run;
169  saved_run = 0;
170  *mode = !*mode;
171  }
172  saved_run += codes[k];
173  }
174  }
175  } while (!eob);
176  *(*runs)++ = saved_run;
177  if (*runs >= runend) {
178  av_log(avctx, AV_LOG_ERROR, "uncompressed run overrun\n");
179  return AVERROR_INVALIDDATA;
180  }
181  if (*pix_left <= saved_run) {
182  if (*pix_left == saved_run)
183  return 1;
184  av_log(avctx, AV_LOG_ERROR, "uncompressed run went out of boundsE\n");
185  return AVERROR_INVALIDDATA;
186  }
187  *pix_left -= saved_run;
188  saved_run = 0;
189  *mode = !*mode;
190  if (newmode != *mode) { //FIXME CHECK
191  *(*runs)++ = 0;
192  *mode = newmode;
193  }
194  return 0;
195 }
196 
198  unsigned int pix_left, int *runs,
199  const int *runend)
200 {
201  int mode = 0;
202  unsigned int run = 0;
203  unsigned int t;
204  for (;;) {
205  t = get_vlc2(gb, ccitt_vlc[mode].table, 9, 2);
206  run += t;
207  if (t < 64) {
208  *runs++ = run;
209  if (runs >= runend) {
210  av_log(avctx, AV_LOG_ERROR, "Run overrun\n");
211  return AVERROR_INVALIDDATA;
212  }
213  if (pix_left <= run) {
214  if (pix_left == run)
215  break;
216  av_log(avctx, AV_LOG_ERROR, "Run went out of bounds\n");
217  return AVERROR_INVALIDDATA;
218  }
219  pix_left -= run;
220  run = 0;
221  mode = !mode;
222  } else if ((int)t == -1) {
223  if (show_bits(gb, 12) == 15) {
224  int ret;
225  skip_bits(gb, 12);
226  ret = decode_uncompressed(avctx, gb, &pix_left, &runs, runend, &mode);
227  if (ret < 0) {
228  return ret;
229  } else if (ret)
230  break;
231  } else {
232  av_log(avctx, AV_LOG_ERROR, "Incorrect code\n");
233  return AVERROR_INVALIDDATA;
234  }
235  }
236  }
237  *runs++ = 0;
238  return 0;
239 }
240 
242  unsigned int width, int *runs,
243  const int *runend, const int *ref)
244 {
245  int mode = 0, saved_run = 0, t;
246  int run_off = *ref++;
247  unsigned int offs = 0, run = 0;
248 
249  while (offs < width) {
250  int cmode = get_vlc2(gb, ccitt_group3_2d_vlc.table, 9, 1);
251  if (cmode == -1) {
252  av_log(avctx, AV_LOG_ERROR, "Incorrect mode VLC\n");
253  return AVERROR_INVALIDDATA;
254  }
255  if (!cmode) { //pass mode
256  if (run_off < width)
257  run_off += *ref++;
258  run = run_off - offs;
259  offs = run_off;
260  if (run_off < width)
261  run_off += *ref++;
262  if (offs > width) {
263  av_log(avctx, AV_LOG_ERROR, "Run went out of bounds\n");
264  return AVERROR_INVALIDDATA;
265  }
266  saved_run += run;
267  } else if (cmode == 1) { //horizontal mode
268  int k;
269  for (k = 0; k < 2; k++) {
270  run = 0;
271  for (;;) {
272  t = get_vlc2(gb, ccitt_vlc[mode].table, 9, 2);
273  if (t == -1) {
274  av_log(avctx, AV_LOG_ERROR, "Incorrect code\n");
275  return AVERROR_INVALIDDATA;
276  }
277  run += t;
278  if (t < 64)
279  break;
280  }
281  *runs++ = run + saved_run;
282  if (runs >= runend) {
283  av_log(avctx, AV_LOG_ERROR, "Run overrun\n");
284  return AVERROR_INVALIDDATA;
285  }
286  saved_run = 0;
287  offs += run;
288  if (offs > width || run > width) {
289  av_log(avctx, AV_LOG_ERROR, "Run went out of bounds\n");
290  return AVERROR_INVALIDDATA;
291  }
292  mode = !mode;
293  }
294  } else if (cmode == 9 || cmode == 10) {
295  int xxx = get_bits(gb, 3);
296  if (cmode == 9 && xxx == 7) {
297  int ret;
298  int pix_left = width - offs;
299 
300  if (saved_run) {
301  av_log(avctx, AV_LOG_ERROR, "saved run %d on entering uncompressed mode\n", saved_run);
302  return AVERROR_INVALIDDATA;
303  }
304  ret = decode_uncompressed(avctx, gb, &pix_left, &runs, runend, &mode);
305  offs = width - pix_left;
306  if (ret < 0) {
307  return ret;
308  } else if (ret)
309  break;
310  } else {
311  avpriv_report_missing_feature(avctx, "Special mode %d xxx=%d support", cmode, xxx);
312  return AVERROR_PATCHWELCOME;
313  }
314  } else { //vertical mode
315  run = run_off - offs + (cmode - 5);
316  run_off -= *--ref;
317  offs += run;
318  if (offs > width || run > width) {
319  av_log(avctx, AV_LOG_ERROR, "Run went out of bounds\n");
320  return AVERROR_INVALIDDATA;
321  }
322  *runs++ = run + saved_run;
323  if (runs >= runend) {
324  av_log(avctx, AV_LOG_ERROR, "Run overrun\n");
325  return AVERROR_INVALIDDATA;
326  }
327  saved_run = 0;
328  mode = !mode;
329  }
330  //sync line pointers
331  while (offs < width && run_off <= offs) {
332  run_off += *ref++;
333  run_off += *ref++;
334  }
335  }
336  *runs++ = saved_run;
337  if (saved_run) {
338  if (runs >= runend) {
339  av_log(avctx, AV_LOG_ERROR, "Run overrun\n");
340  return -1;
341  }
342  *runs++ = 0;
343  }
344  return 0;
345 }
346 
347 static void put_line(uint8_t *dst, int size, int width, const int *runs)
348 {
349  PutBitContext pb;
350  int run, mode = ~0, pix_left = width, run_idx = 0;
351 
352  init_put_bits(&pb, dst, size);
353  while (pix_left > 0) {
354  run = runs[run_idx++];
355  mode = ~mode;
356  pix_left -= run;
357  for (; run > 16; run -= 16)
358  put_sbits(&pb, 16, mode);
359  if (run)
360  put_sbits(&pb, run, mode);
361  }
362  flush_put_bits(&pb);
363 }
364 
365 static int find_group3_syncmarker(GetBitContext *gb, int srcsize)
366 {
367  unsigned int state = -1;
368  srcsize -= get_bits_count(gb);
369  while (srcsize-- > 0) {
370  state += state + get_bits1(gb);
371  if ((state & 0xFFF) == 1)
372  return 0;
373  }
374  return -1;
375 }
376 
377 int ff_ccitt_unpack(AVCodecContext *avctx, const uint8_t *src, int srcsize,
378  uint8_t *dst, int height, int stride,
379  enum TiffCompr compr, int opts)
380 {
381  int j;
382  GetBitContext gb;
383  int *runs, *ref = NULL, *runend;
384  int ret;
385  int runsize = avctx->width + 2;
386  int has_eol;
387 
388  runs = av_malloc_array(runsize, sizeof(runs[0]));
389  ref = av_malloc_array(runsize, sizeof(ref[0]));
390  if (!runs || !ref) {
391  ret = AVERROR(ENOMEM);
392  goto fail;
393  }
394  ref[0] = avctx->width;
395  ref[1] = 0;
396  ref[2] = 0;
397  if ((ret = init_get_bits8(&gb, src, srcsize)) < 0)
398  goto fail;
399  has_eol = show_bits(&gb, 12) == 1 || show_bits(&gb, 16) == 1;
400 
401  for (j = 0; j < height; j++) {
402  runend = runs + runsize;
403  if (compr == TIFF_G4) {
404  ret = decode_group3_2d_line(avctx, &gb, avctx->width, runs, runend,
405  ref);
406  if (ret < 0)
407  goto fail;
408  } else {
409  int g3d1 = (compr == TIFF_G3) && !(opts & 1);
410  if (compr != TIFF_CCITT_RLE &&
411  has_eol &&
412  find_group3_syncmarker(&gb, srcsize * 8) < 0)
413  break;
414  if (compr == TIFF_CCITT_RLE || g3d1 || get_bits1(&gb))
415  ret = decode_group3_1d_line(avctx, &gb, avctx->width, runs,
416  runend);
417  else
418  ret = decode_group3_2d_line(avctx, &gb, avctx->width, runs,
419  runend, ref);
420  if (compr == TIFF_CCITT_RLE)
421  align_get_bits(&gb);
422  }
423  if (avctx->err_recognition & AV_EF_EXPLODE && ret < 0)
424  goto fail;
425 
426  if (ret < 0) {
427  put_line(dst, stride, avctx->width, ref);
428  } else {
429  put_line(dst, stride, avctx->width, runs);
430  FFSWAP(int *, runs, ref);
431  }
432  dst += stride;
433  }
434  ret = 0;
435 fail:
436  av_free(runs);
437  av_free(ref);
438  return ret;
439 }
#define CCITT_SYMS
Definition: faxcompr.c:32
#define NULL
Definition: coverity.c:32
static int find_group3_syncmarker(GetBitContext *gb, int srcsize)
Definition: faxcompr.c:365
#define AVERROR_INVALIDDATA
Invalid data found when processing input.
Definition: error.h:59
static int decode_group3_1d_line(AVCodecContext *avctx, GetBitContext *gb, unsigned int pix_left, int *runs, const int *runend)
Definition: faxcompr.c:197
static void put_sbits(PutBitContext *pb, int n, int32_t value)
Definition: put_bits.h:192
static unsigned int get_bits(GetBitContext *s, int n)
Read 1-25 bits.
Definition: get_bits.h:260
int ff_init_vlc_sparse(VLC *vlc_arg, int nb_bits, int nb_codes, const void *bits, int bits_wrap, int bits_size, const void *codes, int codes_wrap, int codes_size, const void *symbols, int symbols_wrap, int symbols_size, int flags)
Definition: bitstream.c:274
static void put_line(uint8_t *dst, int size, int width, const int *runs)
Definition: faxcompr.c:347
#define VLC_TYPE
Definition: get_bits.h:61
uint8_t run
Definition: svq3.c:149
static int decode_group3_2d_line(AVCodecContext *avctx, GetBitContext *gb, unsigned int width, int *runs, const int *runend, const int *ref)
Definition: faxcompr.c:241
Definition: tiff.h:92
static const uint8_t ccitt_group3_2d_bits[11]
Definition: faxcompr.c:89
av_cold void ff_ccitt_unpack_init(void)
initialize upacker code
Definition: faxcompr.c:99
uint8_t
#define av_cold
Definition: attributes.h:74
mode
Definition: f_perms.c:27
#define INIT_VLC_STATIC(vlc, bits, a, b, c, d, e, f, g, static_size)
Definition: get_bits.h:476
static int get_bits_count(const GetBitContext *s)
Definition: get_bits.h:212
bitstream reader API header.
ptrdiff_t size
Definition: opengl_enc.c:101
#define av_log(a,...)
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
Definition: log.h:176
static const uint16_t ccitt_syms[CCITT_SYMS]
Definition: faxcompr.c:34
#define AV_EF_EXPLODE
abort decoding on minor error detection
Definition: avcodec.h:2901
#define AVERROR(e)
Definition: error.h:43
static const struct endianess table[]
static const uint8_t ccitt_codes_bits[2][CCITT_SYMS]
Definition: faxcompr.c:45
int ff_ccitt_unpack(AVCodecContext *avctx, const uint8_t *src, int srcsize, uint8_t *dst, int height, int stride, enum TiffCompr compr, int opts)
unpack data compressed with CCITT Group 3 1/2-D or Group 4 method
Definition: faxcompr.c:377
Libavcodec external API header.
#define fail()
Definition: checkasm.h:57
Definition: get_bits.h:63
int err_recognition
Error recognition; may misdetect some more or less valid parts as errors.
Definition: avcodec.h:2890
int width
picture width / height.
Definition: avcodec.h:1681
static struct @197 state
static int decode_uncompressed(AVCodecContext *avctx, GetBitContext *gb, unsigned int *pix_left, int **runs, const int *runend, int *mode)
Definition: faxcompr.c:125
static unsigned int show_bits(GetBitContext *s, int n)
Show 1-25 bits.
Definition: get_bits.h:287
static av_always_inline int get_vlc2(GetBitContext *s, VLC_TYPE(*table)[2], int bits, int max_depth)
Parse a vlc code.
Definition: get_bits.h:555
uint32_t i
Definition: intfloat.h:28
#define INIT_VLC_USE_NEW_STATIC
Definition: get_bits.h:474
#define av_log2
Definition: intmath.h:100
static VLC ccitt_group3_2d_vlc
Definition: faxcompr.c:97
#define AVERROR_PATCHWELCOME
Not yet implemented in FFmpeg, patches welcome.
Definition: error.h:62
int table_allocated
Definition: get_bits.h:66
TiffCompr
list of TIFF compression types
Definition: tiff.h:88
AVS_Value src
Definition: avisynth_c.h:482
static int init_get_bits8(GetBitContext *s, const uint8_t *buffer, int byte_size)
Initialize GetBitContext.
Definition: get_bits.h:441
main external API structure.
Definition: avcodec.h:1502
Definition: tiff.h:91
static unsigned int get_bits1(GetBitContext *s)
Definition: get_bits.h:304
BYTE int const BYTE int int int height
Definition: avisynth_c.h:676
static void skip_bits(GetBitContext *s, int n)
Definition: get_bits.h:297
static const uint8_t ccitt_group3_2d_lens[11]
Definition: faxcompr.c:93
void avpriv_report_missing_feature(void *avc, const char *msg,...) av_printf_format(2
Log a generic warning message about a missing feature.
GLint GLenum GLboolean GLsizei stride
Definition: opengl_enc.c:105
static VLC ccitt_vlc[2]
Definition: faxcompr.c:97
static const uint8_t ccitt_codes_lens[2][CCITT_SYMS]
Definition: faxcompr.c:69
static void flush_put_bits(PutBitContext *s)
Pad the end of the output stream with zeros.
Definition: put_bits.h:101
static void init_put_bits(PutBitContext *s, uint8_t *buffer, int buffer_size)
Initialize the PutBitContext s.
Definition: put_bits.h:48
#define av_free(p)
VLC_TYPE(* table)[2]
code, bits
Definition: get_bits.h:65
static const uint8_t * align_get_bits(GetBitContext *s)
Definition: get_bits.h:449
#define av_malloc_array(a, b)
#define FFSWAP(type, a, b)
Definition: common.h:84
#define stride
CCITT Fax Group 3 and 4 decompression.
static int width
bitstream writer API