Files
wuffs/std/lzw
Nigel Tao 4e27b1280e Write LZW decoder output in batches
name                             old speed     new speed     delta

wuffs_gif_decode_1k_bw/clang     309MB/s ± 0%  306MB/s ± 0%   -0.93%  (p=0.008 n=5+5)
wuffs_gif_decode_1k_color/clang  160MB/s ± 0%  156MB/s ± 0%   -2.26%  (p=0.008 n=5+5)
wuffs_gif_decode_10k/clang       145MB/s ± 0%  153MB/s ± 0%   +5.21%  (p=0.008 n=5+5)
wuffs_gif_decode_100k/clang      131MB/s ± 1%  147MB/s ± 0%  +12.15%  (p=0.008 n=5+5)
wuffs_gif_decode_1000k/clang     134MB/s ± 0%  151MB/s ± 1%  +12.83%  (p=0.008 n=5+5)

wuffs_gif_decode_1k_bw/gcc       339MB/s ± 0%  319MB/s ± 0%   -5.99%  (p=0.008 n=5+5)
wuffs_gif_decode_1k_color/gcc    186MB/s ± 0%  165MB/s ± 0%  -10.93%  (p=0.008 n=5+5)
wuffs_gif_decode_10k/gcc         164MB/s ± 0%  171MB/s ± 1%   +4.19%  (p=0.008 n=5+5)
wuffs_gif_decode_100k/gcc        143MB/s ± 0%  161MB/s ± 1%  +12.32%  (p=0.008 n=5+5)
wuffs_gif_decode_1000k/gcc       146MB/s ± 0%  166MB/s ± 0%  +13.61%  (p=0.008 n=5+5)

wuffs_lzw_decode_20k/clang       142MB/s ± 0%  167MB/s ± 0%  +17.51%  (p=0.008 n=5+5)
wuffs_lzw_decode_100k/clang      186MB/s ± 1%  239MB/s ± 0%  +28.68%  (p=0.008 n=5+5)

wuffs_lzw_decode_20k/gcc         162MB/s ± 0%  192MB/s ± 0%  +18.63%  (p=0.008 n=5+5)
wuffs_lzw_decode_100k/gcc        235MB/s ± 1%  295MB/s ± 0%  +25.59%  (p=0.008 n=5+5)
2018-10-14 17:53:20 +11:00
..
2018-06-02 14:15:09 +10:00

LZW (Lempel Ziv Welch) Compression

LZW is a general purpose compression algorithm, not specific to GIF, PDF, TIFF or even to graphics. In practice, there are two incompatible implementations, LSB (Least Significant Bits) and MSB (Most Significant Bits) first.

The GIF format uses LSB first. The literal width can vary between 2 and 8 bits, inclusive. There is no EarlyChange option.

The PDF and TIFF formats use MSB first. The literal width is fixed at 8 bits. There is an EarlyChange option that PDF sometimes uses (see Table 3.7 in the PDF 1.4 spec) and TIFF always uses.

TODO: refactor this README.md file and std/gif's one.