mirror of
https://github.com/ddidderr/wuffs.git
synced 2026-11-18 08:32:11 +01:00
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
33 lines
1.3 KiB
Plaintext
33 lines
1.3 KiB
Plaintext
// Copyright 2026 The Wuffs Authors.
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
|
|
// https://www.apache.org/licenses/LICENSE-2.0> or the MIT license
|
|
// <LICENSE-MIT or https://opensource.org/licenses/MIT>, at your
|
|
// option. This file may not be copied, modified, or distributed
|
|
// except according to those terms.
|
|
//
|
|
// SPDX-License-Identifier: Apache-2.0 OR MIT
|
|
|
|
// --------
|
|
|
|
// Quirks are discussed in (/doc/note/quirks.md).
|
|
//
|
|
// The base38 encoding of "brot" is 0x0A_ADE4. Left shifting by 10 gives
|
|
// 0x2AB7_9000.
|
|
pri const QUIRKS_BASE : base.u32 = 0x2AB7_9000
|
|
|
|
// --------
|
|
|
|
// When this quirk is set, a positive value enables large-window brotli
|
|
// (https://datatracker.ietf.org/doc/draft-vandevenne-shared-brotli-format/),
|
|
// with window sizes up to (1 << 30) bytes. Zero means standard (RFC 7932)
|
|
// brotli. It mirrors the C code's BROTLI_DECODER_PARAM_LARGE_WINDOW.
|
|
//
|
|
// It must be set before decoding starts. Setting it also increases the
|
|
// workbuf_len.
|
|
//
|
|
// Without this quirk, a stream that starts with the large-window WBITS escape
|
|
// is rejected with "#unsupported large window". With this quirk, a stream that
|
|
// does not start with that escape is decoded as standard brotli.
|
|
pub const QUIRK_LARGE_WINDOW : base.u32 = 0x2AB7_9000 | 0x00
|