Adds a brotli encoder (std/brotli's encoder struct, a base.io_transformer) whose output is byte-identical to libbrotlienc v1.2.1 for quality levels 0 and 1, mirroring encode.c's BrotliEncoderCompressStream(Fast), compress_fragment.c and compress_fragment_two_pass.c, plus the entropy coding and bit stream helpers they need. Every double operation goes through std/softfloat, following the C evaluation order exactly. Parameters are quirks (encode_quirks.wuffs) that mirror BrotliEncoderSetParameter, sanitized at the first transform_io call. Each transform_io resumption corresponds to one C call with available_in equal to the readable src length; a closed src is FINISH; request_flush! and request_emit_metadata! make the next resumption a FLUSH or EMIT_METADATA call. Qualities 2 to 11 return "#unsupported encoder quality" for now. Encoder tables are generated by script/print-brotli-tables.go -encoder. Tests: round trips through the Wuffs decoder over the corpus and synthetic inputs; with -mimic, byte-exact comparisons against libbrotlienc over quality × window × mode × input chunking × flush schedule × metadata × size hint. script/manual-test-brotli-encoder-parity.c runs the full grid: 86,268 configurations, zero mismatches. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_011NoosQNe7DKWnqDCBeqw1p
2.7 KiB
Standard Library
Wuffs' standard library consists of multiple packages, each implementing a particular file format or algorithm. Those packages can be grouped into several categories:
Other packages include std/softfloat, which implements bit-exact IEEE 754 floating point arithmetic using only integers.
The general pattern is that a package foo (e.g. jpeg, png) contains a
struct bar (e.g. hasher, decoder, etc) that implements a
package-independent interface. For example, every compression decoder struct
would have a transform_io method. In C, this would be invoked as
// Allocate and initialize the struct.
wuffs_foo__decoder* dec = etc;
// Do the work. Error checking is not shown, for brevity.
wuffs_base__status status = wuffs_foo__decoder__transform_io(dec, etc);
When that C library is used as C++, that last line can be shortened:
wuffs_base__status status = dec->transform_io(etc);
See also the glossary, as well as the notes on:
Modules and Dependencies
By default, building Wuffs' standard library builds the entire thing (provided
that you've defined the WUFFS_IMPLEMENTATION C macro), implementing a variety
of codecs and file formats.
Packages can be individually allow-listed, for smaller binaries and faster
compiles. Opt in by also defining WUFFS_CONFIG__MODULES and then also
WUFFS_CONFIG__MODULE__ETC for each ETC (and its dependencies, listed below)
to enable.
ADLER32: BASEBMP: BASEBZIP2: BASECBOR: BASECRC32: BASECRC64: BASEDEFLATE: BASEETC2: BASEGIF: BASEGZIP: BASE, CRC32, DEFLATEHANDSUM: BASEJPEG: BASEJSON: BASELZIP: BASE, CRC32, LZMALZMA: BASELZW: BASENETPBM: BASENIE: BASEPNG: BASE, ADLER32, CRC32, DEFLATE, ZLIBQOI: BASESHA256: BASESOFTFLOAT: BASETGA: BASETHUMBHASH: BASEVP8: BASEWBMP: BASEWEBP: BASE, VP8XXHASH32: BASEXXHASH64: BASEXZ: BASE, CRC32, CRC64, LZMA, SHA256ZLIB: BASE, ADLER32, DEFLATE
For the auxiliary modules:
AUX_CBOR: AUX_BASE, BASE, CBORAUX_IMAGE: AUX_BASE, BASEand whichever image-related modules (and their dependencies) you want, e.g.GIF,PNG, etc.AUX_JSON: AUX_BASE, BASE, JSON