Files
wuffs/lib/lowleveljpeg/quant.go
T

141 lines
4.0 KiB
Go
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
// Copyright 2025 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
package lowleveljpeg
// QuantizationStandardValuesType selects which table from the JPEG
// specification to use for SetToStandardValues.
type QuantizationStandardValuesType byte
const (
// QuantizationStandardValuesTypeLuma means to use table K.1 from the JPEG
// spec.
QuantizationStandardValuesTypeLuma = QuantizationStandardValuesType(0)
// QuantizationStandardValuesTypeChroma means to use table K.2 from the
// JPEG spec.
QuantizationStandardValuesTypeChroma = QuantizationStandardValuesType(1)
)
// 12-bit or 16-bit depth JPEGs can use more-than-8-bit quantization factors,
// but we only support 8-bit JPEGs and so we use 8-bit quantization factors.
// The QuantizationFactors element type is uint8.
// QuantizationFactors is an 8×8 block of uint8 values, used to quantize a
// BlockI16.
//
// It is indexed in DCT (not XY) space, like a Block16.
type QuantizationFactors [64]uint8
// String returns b in human-readable form.
func (b QuantizationFactors) String() string {
buf := [64 * 3]byte{}
for i, value := range b {
buf[(3*i)+0] = fmtHex[15&(value>>0x04)]
buf[(3*i)+1] = fmtHex[15&(value>>0x00)]
buf[(3*i)+2] = fmtSep[7&i]
}
return string(buf[:])
}
// IsValid returns whether b does not contain any zero-valued elements.
func (b *QuantizationFactors) IsValid() bool {
if b == nil {
return false
}
for _, v := range b {
if v == 0 {
return false
}
}
return true
}
const (
// MinimumQuality and MaximumQuality are the minimum and maximum
// (inclusive) values for SetToStandardValues' quality parameter.
MinimumQuality = 1
MaximumQuality = 100
// DefaultQuality is the default value used by EncoderOptions for
// SetToStandardValues' quality parameter. It matches libjpeg's default
// both in terms of numerical value and in behavior.
DefaultQuality = 75
)
// SetToStandardValues sets b to one of two standard quantization tables
// (Tables K.1 or K.2 in the JPEG spec, for Luma and Chroma respectively),
// scaled by a quality parameter with the same meaning as that used by
// libjpeg's encoder.
//
// The quality parameter ranges from 1 (low quality) to 100 (high quality),
// inclusive. Values outside of that range will be clamped to be in [1, 100].
//
// Passing quality = MinimumQuality will set every element of b to 0xFF.
//
// Passing quality = MaximumQuality will set every element of b to 0x01.
func (b *QuantizationFactors) SetToStandardValues(which QuantizationStandardValuesType, quality int) {
if b == nil {
return
}
// Follow the same algorithm as in libjpeg's jcparam.c.
if quality < 1 {
quality = 1
} else if quality > 100 {
quality = 100
}
q := 0
if quality < 50 {
q = 5000 / quality
} else {
q = 200 - (quality * 2)
}
std := &standardQuantizationFactors[which&1]
for i, v := range std {
scaled := ((int(v) * q) + 50) / 100
if scaled < 0x01 {
scaled = 0x01
} else if scaled > 0xFF {
scaled = 0xFF
}
b[i] = uint8(scaled)
}
}
var standardQuantizationFactors = [2]QuantizationFactors{
// Table K.1 from the JPEG spec.
QuantizationStandardValuesTypeLuma: {
16, 11, 10, 16, 24, 40, 51, 61,
12, 12, 14, 19, 26, 58, 60, 55,
14, 13, 16, 24, 40, 57, 69, 56,
14, 17, 22, 29, 51, 87, 80, 62,
18, 22, 37, 56, 68, 109, 103, 77,
24, 35, 55, 64, 81, 104, 113, 92,
49, 64, 78, 87, 103, 121, 120, 101,
72, 92, 95, 98, 112, 100, 103, 99,
},
// Table K.2 from the JPEG spec.
QuantizationStandardValuesTypeChroma: {
17, 18, 24, 47, 99, 99, 99, 99,
18, 21, 26, 66, 99, 99, 99, 99,
24, 26, 56, 99, 99, 99, 99, 99,
47, 66, 99, 99, 99, 99, 99, 99,
99, 99, 99, 99, 99, 99, 99, 99,
99, 99, 99, 99, 99, 99, 99, 99,
99, 99, 99, 99, 99, 99, 99, 99,
99, 99, 99, 99, 99, 99, 99, 99,
},
}