压缩器选项


【Compressor options】

Brotli 编码器可以设置多个选项,这些选项会影响压缩效率和速度。键和值都可以作为 zlib.constants 对象的属性进行访问。

【There are several options that can be set on Brotli encoders, affecting compression efficiency and speed. Both the keys and the values can be accessed as properties of the zlib.constants object.】

最重要的选项是:

【The most important options are:】

  • BROTLI_PARAM_MODE
    • BROTLI_MODE_GENERIC(默认)
    • BROTLI_MODE_TEXT,为 UTF-8 文本调整
    • BROTLI_MODE_FONT,为 WOFF 2.0 字体进行了调整
  • BROTLI_PARAM_QUALITY
    • 范围从 BROTLI_MIN_QUALITYBROTLI_MAX_QUALITY,默认值为 BROTLI_DEFAULT_QUALITY
  • BROTLI_PARAM_SIZE_HINT
    • 整数值,表示预期的输入大小;对于未知的输入大小,默认为 0

可以设置以下标志,以便对压缩算法和内存使用进行高级控制:

【The following flags can be set for advanced control over the compression algorithm and memory usage tuning:】

  • BROTLI_PARAM_LGWIN
    • 范围从 BROTLI_MIN_WINDOW_BITSBROTLI_MAX_WINDOW_BITS,默认值为 BROTLI_DEFAULT_WINDOW,如果设置了 BROTLI_PARAM_LARGE_WINDOW 标志,则最大可达 BROTLI_LARGE_MAX_WINDOW_BITS
  • BROTLI_PARAM_LGBLOCK
    • 范围从 BROTLI_MIN_INPUT_BLOCK_BITSBROTLI_MAX_INPUT_BLOCK_BITS
  • BROTLI_PARAM_DISABLE_LITERAL_CONTEXT_MODELING
    • 布尔标志,用于减少压缩比以提高解压速度。
  • BROTLI_PARAM_LARGE_WINDOW
    • 布尔标志,用于启用“Large Window Brotli”模式(与RFC 7932标准化的Brotli格式不兼容)。
  • BROTLI_PARAM_NPOSTFIX
    • 范围从 0BROTLI_MAX_NPOSTFIX
  • BROTLI_PARAM_NDIRECT
    • 范围从 015 << NPOSTFIX,步长为 1 << NPOSTFIX