Files
wuffs/release/c
Nigel Tao 92ecd0a901 Use a table, not a formula, to get low bits mask
It's not an optimization per se. It addresses the fact that, in the C
programming language, if u is an uint32_t value, then (u<<32) is
undefined behavior, so ((1<<32)-1) isn't necessarily 0xFFFFFFFF:

https://stackoverflow.com/questions/7401888/why-doesnt-left-bit-shift-for-32-bit-integers-work-as-expected-when-used

name                                    old speed      new speed      delta

wuffs_deflate_decode_1k/clang            147MB/s ± 1%   147MB/s ± 0%     ~     (p=0.206 n=49+5)
wuffs_deflate_decode_10k/clang           234MB/s ± 1%   239MB/s ± 0%   +2.24%  (p=0.000 n=49+5)
wuffs_deflate_decode_100k/clang          261MB/s ± 0%   270MB/s ± 0%   +3.38%  (p=0.000 n=48+5)

wuffs_deflate_decode_1k/gcc              160MB/s ± 1%   160MB/s ± 0%     ~     (p=0.322 n=43+5)
wuffs_deflate_decode_10k/gcc             270MB/s ± 1%   272MB/s ± 0%   +0.93%  (p=0.000 n=46+5)
wuffs_deflate_decode_100k/gcc            313MB/s ± 1%   322MB/s ± 0%   +2.97%  (p=0.000 n=42+5)

wuffs_gif_decode_1k_bw/clang             253MB/s ± 1%   259MB/s ± 1%   +2.28%  (p=0.000 n=45+5)
wuffs_gif_decode_1k_color/clang          116MB/s ± 1%   128MB/s ± 0%  +11.20%  (p=0.000 n=45+5)
wuffs_gif_decode_10k/clang               135MB/s ± 1%   154MB/s ± 1%  +14.39%  (p=0.000 n=44+5)
wuffs_gif_decode_100k_artificial/clang   429MB/s ± 1%   426MB/s ± 0%   -0.70%  (p=0.000 n=48+5)
wuffs_gif_decode_100k_realistic/clang    162MB/s ± 0%   171MB/s ± 0%   +6.13%  (p=0.000 n=43+5)
wuffs_gif_decode_1000k/clang             163MB/s ± 1%   172MB/s ± 0%   +6.04%  (p=0.000 n=50+5)
wuffs_gif_decode_anim_screencap/clang    900MB/s ± 0%   909MB/s ± 0%   +1.06%  (p=0.000 n=45+5)

wuffs_gif_decode_1k_bw/gcc               268MB/s ± 1%   269MB/s ± 0%   +0.63%  (p=0.000 n=49+5)
wuffs_gif_decode_1k_color/gcc            133MB/s ± 1%   135MB/s ± 1%   +1.45%  (p=0.000 n=50+5)
wuffs_gif_decode_10k/gcc                 160MB/s ± 1%   158MB/s ± 0%   -1.24%  (p=0.000 n=48+5)
wuffs_gif_decode_100k_artificial/gcc     448MB/s ± 1%   446MB/s ± 0%   -0.40%  (p=0.039 n=50+5)
wuffs_gif_decode_100k_realistic/gcc      180MB/s ± 1%   177MB/s ± 0%   -1.48%  (p=0.000 n=50+5)
wuffs_gif_decode_1000k/gcc               182MB/s ± 1%   179MB/s ± 0%   -1.39%  (p=0.000 n=48+5)
wuffs_gif_decode_anim_screencap/gcc      963MB/s ± 1%   960MB/s ± 0%   -0.33%  (p=0.022 n=47+5)

wuffs_gzip_decode_10k/clang              215MB/s ± 1%   221MB/s ± 0%   +2.46%  (p=0.000 n=49+5)
wuffs_gzip_decode_100k/clang             239MB/s ± 1%   246MB/s ± 0%   +3.03%  (p=0.000 n=47+5)

wuffs_gzip_decode_10k/gcc                248MB/s ± 0%   248MB/s ± 0%     ~     (p=0.469 n=45+5)
wuffs_gzip_decode_100k/gcc               290MB/s ± 1%   291MB/s ± 0%   +0.34%  (p=0.007 n=49+5)

wuffs_lzw_decode_20k/clang               187MB/s ± 0%   199MB/s ± 2%   +6.45%  (p=0.000 n=49+5)
wuffs_lzw_decode_100k/clang              304MB/s ± 1%   329MB/s ± 1%   +8.44%  (p=0.000 n=46+5)

wuffs_lzw_decode_20k/gcc                 223MB/s ± 1%   208MB/s ± 2%   -6.78%  (p=0.000 n=46+5)
wuffs_lzw_decode_100k/gcc                364MB/s ± 1%   352MB/s ± 0%   -3.39%  (p=0.000 n=49+5)

wuffs_zlib_decode_10k/clang              214MB/s ± 0%   216MB/s ± 1%   +0.69%  (p=0.026 n=49+5)
wuffs_zlib_decode_100k/clang             237MB/s ± 0%   242MB/s ± 0%   +2.37%  (p=0.000 n=48+5)

wuffs_zlib_decode_10k/gcc                247MB/s ± 1%   245MB/s ± 1%   -0.69%  (p=0.001 n=44+5)
wuffs_zlib_decode_100k/gcc               288MB/s ± 1%   288MB/s ± 1%     ~     (p=0.629 n=47+5)
2018-10-28 17:14:49 +11:00
..
2018-07-21 09:28:48 +10:00
2018-10-21 16:12:50 +11:00

Wuffs ships as a "single file C library", also known as a "header file library".

To use Wuffs in your C/C++ project, you just need to copy one file from this directory, or otherwise integrate that one file into your build system. Typically, pick the latest version (but not the unsupported snapshot), with a filename like wuffs-vMAJOR.MINOR.h for version MAJOR.MINOR.

To use that single file as a "foo.c"-like implementation, instead of a "foo.h"-like header, #define WUFFS_IMPLEMENTATION before #include'ing or compiling it.