Files
wuffs/doc/changelog.md
T
Nigel Tao 829519880a Drop unnecessary memcpy in do_bench_image_decode
This doesn't affect the std/bmp or std/gif implementations per se, only
the code that benches them. Prior to this commit, the source file was
first decoded into a pixel buffer and then always copied from the
(2-dimensional) wuffs_base__pixel_buffer to a (1-dimensional)
wuffs_base_io_buffer. That copy is useful for *tests*, which compare
that io_buffer's contents to a known good result (i.e. a separate I/O
buffer filled with the contents of a golden file), but it isn't
necessary for *benches*. Dropping that unnecessary copy reduces the
total time per iteration, and therefore increases the reported speed.

name                                        old speed      new speed       delta

wuffs_bmp_decode_40k/clang5                 2.09GB/s ± 2%   2.48GB/s ± 0%  +18.78%  (p=0.008 n=5+5)

wuffs_bmp_decode_40k/gcc7                   1.73GB/s ± 1%   1.93GB/s ± 0%  +11.54%  (p=0.008 n=5+5)

wuffs_gif_decode_1k_bw/clang5                291MB/s ± 0%    376MB/s ± 1%  +29.14%  (p=0.008 n=5+5)
wuffs_gif_decode_1k_color_full_init/clang5  95.3MB/s ± 1%  103.2MB/s ± 1%   +8.37%  (p=0.008 n=5+5)
wuffs_gif_decode_1k_color_part_init/clang5   117MB/s ± 0%    130MB/s ± 0%  +10.68%  (p=0.008 n=5+5)
wuffs_gif_decode_10k_bgra/clang5             469MB/s ± 0%    489MB/s ± 1%   +4.39%  (p=0.008 n=5+5)
wuffs_gif_decode_10k_indexed/clang5          126MB/s ± 1%    130MB/s ± 1%   +3.50%  (p=0.008 n=5+5)
wuffs_gif_decode_20k/clang5                  152MB/s ± 0%    156MB/s ± 1%   +2.77%  (p=0.008 n=5+5)
wuffs_gif_decode_100k_artificial/clang5      318MB/s ± 0%    329MB/s ± 0%   +3.53%  (p=0.008 n=5+5)
wuffs_gif_decode_100k_realistic/clang5       137MB/s ± 0%    139MB/s ± 0%   +1.40%  (p=0.008 n=5+5)
wuffs_gif_decode_1000k_full_init/clang5      138MB/s ± 0%    140MB/s ± 1%   +1.45%  (p=0.008 n=5+5)
wuffs_gif_decode_1000k_part_init/clang5      139MB/s ± 0%    140MB/s ± 1%   +1.03%  (p=0.008 n=5+5)
wuffs_gif_decode_anim_screencap/clang5       661MB/s ± 0%    747MB/s ± 1%  +13.08%  (p=0.008 n=5+5)

mimic_gif_decode_1k_bw/clang5               92.0MB/s ± 0%   91.9MB/s ± 1%     ~     (p=0.841 n=5+5)
mimic_gif_decode_1k_color/clang5            45.5MB/s ± 0%   45.7MB/s ± 0%   +0.45%  (p=0.032 n=5+4)
mimic_gif_decode_10k_indexed/clang5         53.5MB/s ± 0%   53.7MB/s ± 0%   +0.31%  (p=0.032 n=5+4)
mimic_gif_decode_20k/clang5                 55.5MB/s ± 0%   55.1MB/s ± 2%     ~     (p=0.690 n=5+5)
mimic_gif_decode_100k_artificial/clang5     88.8MB/s ± 0%   89.0MB/s ± 1%     ~     (p=0.151 n=5+5)
mimic_gif_decode_100k_realistic/clang5      53.5MB/s ± 1%   53.7MB/s ± 0%   +0.31%  (p=0.024 n=5+5)
mimic_gif_decode_1000k/clang5               54.6MB/s ± 0%   54.6MB/s ± 1%     ~     (p=0.222 n=5+5)
mimic_gif_decode_anim_screencap/clang5       106MB/s ± 0%    109MB/s ± 0%   +2.59%  (p=0.008 n=5+5)

wuffs_gif_decode_1k_bw/gcc7                  284MB/s ± 0%    356MB/s ± 0%  +25.33%  (p=0.016 n=4+5)
wuffs_gif_decode_1k_color_full_init/gcc7    82.1MB/s ± 0%   95.3MB/s ± 0%  +16.08%  (p=0.008 n=5+5)
wuffs_gif_decode_1k_color_part_init/gcc7    97.5MB/s ± 0%  117.4MB/s ± 0%  +20.39%  (p=0.008 n=5+5)
wuffs_gif_decode_10k_bgra/gcc7               345MB/s ± 0%    396MB/s ± 0%  +14.71%  (p=0.016 n=4+5)
wuffs_gif_decode_10k_indexed/gcc7            104MB/s ± 0%    121MB/s ± 0%  +16.38%  (p=0.008 n=5+5)
wuffs_gif_decode_20k/gcc7                    131MB/s ± 0%    149MB/s ± 0%  +13.55%  (p=0.008 n=5+5)
wuffs_gif_decode_100k_artificial/gcc7        293MB/s ± 0%    321MB/s ± 1%   +9.77%  (p=0.008 n=5+5)
wuffs_gif_decode_100k_realistic/gcc7         116MB/s ± 1%    130MB/s ± 1%  +12.10%  (p=0.008 n=5+5)
wuffs_gif_decode_1000k_full_init/gcc7        117MB/s ± 1%    132MB/s ± 1%  +12.53%  (p=0.008 n=5+5)
wuffs_gif_decode_1000k_part_init/gcc7        117MB/s ± 0%    132MB/s ± 1%  +12.20%  (p=0.008 n=5+5)
wuffs_gif_decode_anim_screencap/gcc7         615MB/s ± 2%    711MB/s ± 2%  +15.53%  (p=0.008 n=5+5)

mimic_gif_decode_1k_bw/gcc7                 91.4MB/s ± 0%   91.7MB/s ± 1%     ~     (p=0.095 n=5+5)
mimic_gif_decode_1k_color/gcc7              46.3MB/s ± 0%   46.2MB/s ± 2%     ~     (p=0.841 n=5+5)
mimic_gif_decode_10k_indexed/gcc7           51.9MB/s ± 1%   51.7MB/s ± 1%     ~     (p=0.310 n=5+5)
mimic_gif_decode_20k/gcc7                   54.2MB/s ± 0%   54.2MB/s ± 1%     ~     (p=0.421 n=5+5)
mimic_gif_decode_100k_artificial/gcc7       88.4MB/s ± 1%   88.7MB/s ± 1%     ~     (p=0.222 n=5+5)
mimic_gif_decode_100k_realistic/gcc7        53.7MB/s ± 0%   53.7MB/s ± 0%     ~     (p=0.206 n=5+5)
mimic_gif_decode_1000k/gcc7                 53.8MB/s ± 2%   54.0MB/s ± 2%     ~     (p=0.690 n=5+5)
mimic_gif_decode_anim_screencap/gcc7         106MB/s ± 0%    109MB/s ± 0%   +2.79%  (p=0.008 n=5+5)
2020-06-01 13:59:50 +10:00

5.3 KiB

Changelog

Work In Progress

  • Added WUFFS_CONFIG__MODULE__BASE__ETC sub-modules.
  • Added WUFFS_BASE__PIXEL_BLEND__SRC_OVER.
  • Added WUFFS_BASE__PIXEL_FORMAT__BGR_565.
  • Added base library support for UTF-8.
  • Added base library support for atoi-like string conversion.
  • Added endwhile syntax.
  • Added example/convert-to-nia.
  • Added example/imageviewer.
  • Added example/jsonptr.
  • Added std/bmp.
  • Added std/gif.config_decoder.
  • Added std/json.
  • Added std/wbmp.
  • Added tell_me_more? mechanism.
  • Added alloc functions.
  • Added colons to const syntax.
  • Added double-curly blocks.
  • Added interfaces.
  • Added preprocessor.
  • Added single-quoted strings.
  • Added tokens.
  • Changed gif.decoder_workbuf_len_max_incl_worst_case from 1 to 0.
  • Changed what the std/gif benchmarks actually measure.
  • Made wuffs_base__pixel_format a struct.
  • Made wuffs_base__pixel_subsampling a struct.
  • Made wuffs_base__status a struct.
  • Removed ack_metadata_chunk?.
  • Removed wuffs_base__frame_config__blend.
  • Renamed decode_io_writer? methods to transform_io?.
  • Renamed swizzle_interleaved! to swizzle_interleaved_from_slice!.
  • Renamed warnings to notes.

2019-12-19 version 0.2.0

The headline feature is that the GIF decoder is now of production quality. There is now API for overall metadata (e.g. ICCP color profiles) and to recreate each frame (width, height, BGRA pixels, timing, etc.) of a GIF animation, instead of version 0.1's proof-of-concept GIF decoder API, which just gave you a one-dimensional stream of palette indexes. It also now accepts a variety of GIF images that are invalid, when strictly following the GIF specifiction, but are nonetheless accepted by other real world GIF implementations. The Wuffs GIF decoder has also been optimized to be about 1.5x faster than Wuffs version 0.1 and about 2x faster than giflib (the C library).

The Wuffs GIF decoder is being trialled by Skia, the 2-D graphics library used by both the Android operating system and the Chromium web browser.

Work also proceeds on the NIE and RAC file formats, but both are still experimental and may change later in backwards incompatible ways.

The dot points below probably aren't of interest unless you're upgrading from Wuffs version 0.1.

  • Renamed Puffs to Wuffs.
  • Ship as a "single file C library"
  • Added a skipgendeps flag.
  • Added a nullptr literal and nptr T type.
  • Added io_bind and io_limit keywords.
  • Added a use keyword.
  • Added a yield keyword.
  • Made the return value mandatory; added ok literal.
  • Restricted var statements to the top of functions.
  • Dropped the = RHS out of var x T = RHS.
  • Changed func out-type from struct to bare type.
  • Renamed the implicit in variable to args.
  • Added an implicit coroutine_resumed variable.
  • Added std/adler32, std/crc32 and std/gzip.
  • Added std/gif quirks.
  • Spun std/lzw out of std/gif.
  • Spun std/zlib out of std/flate.
  • Let the std/gzip and std/zlib decoder ignore checksums.
  • Renamed std/flate to std/deflate.
  • Renamed != to <>; ! is now only for impure functions.
  • Renamed ~+ to ~mod+; added ~mod-, ~sat+ and ~sat-.
  • Removed &^.
  • Renamed $(etc) to [etc].
  • Renamed [i..j] to [i ..= j], consistent with Rust syntax.
  • Renamed [i:j] to [i .. j], consistent with Rust syntax.
  • Renamed x T to x: T, consistent with Rust syntax.
  • Renamed [N] T and [] T types to array[N] T and slice T.
  • Renamed while:label to while.label.
  • Renamed u32, buf1, etc to base.u32, base.io_buffer, etc.
  • Renamed unread_u8? to undo_byte!; added can_undo_byte.
  • Renamed some decode? methods to decode_io_writer?.
  • Replaced = try foo with =? foo.
  • Prohibited effect-ful subexpressions.
  • Redesigned iterate blocks.
  • Added {frame,image,pixel}_config and pixel_buffer types.
  • Added a reset method.
  • Added peek_uxx, skip_fast and write_fast_uxx methods.
  • Renamed some read_uxx methods as read_uxx_as_uyy.
  • Report image metadata such as ICCP and XMP.
  • Added I/O positions.
  • Tweaked how I/O marks and limits work.
  • Tweaked io_buffer / io_reader distinction in C and Wuffs.
  • Added extra fields (uninitialized internal buffers) to structs.
  • Supported animated (not just single frame) and interlaced GIFs.
  • Marked some internal status codes as private.
  • Removed closed-for-read/write built-in status codes.
  • Changed the string messages for built-in status codes.
  • Changed error "foo" to "#foo" or base."#bar".
  • Added warnings as another status code category.
  • Made the status type a const char *, not an int32_t.
  • Disallowed __double_underscore prefixed names.
  • Added fuzz tests.
  • Added WUFFS_CONFIG__MODULES.
  • Added WUFFS_CONFIG__STATIC_FUNCTIONS.
  • Added some C++ convenience methods.
  • Added some Go and Rust benchmarks.
  • Made struct implementations private (opaque pointers).
  • Sped up the mimic_deflate_xxx benchmarks.
  • Fix compile errors under MSVC (Microsoft Visual C/C++).
  • Moved the base38 package from lang/base38 to lib/base38.
  • Added a stand-alone lib/interval package.
  • Added NIE file format spec.
  • Added RAC file format spec and Go implementation.

2017-11-16 version 0.1.0


Updated on January 2020.