Files
ofdgo/ofdgo_editor_image_binary.go
T
2026-10-19 08:43:50 +08:00

257 lines
7.0 KiB
Go

// Copyright 2025-2026 肖其顿 (XIAO QI DUN)
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
package ofdgo
import (
"bytes"
"compress/zlib"
"context"
"encoding/binary"
"image"
"io"
"github.com/xiaoqidun/jbig2"
)
// pngBinaryProbeLimit 限制黑白检查读取的压缩数据与块头总量
const pngBinaryProbeLimit = 4 << 20
// pngBinaryProbe 按需读取连续的IDAT块,不复制压缩数据
type pngBinaryProbe struct {
ctx context.Context
data []byte
payload []byte
remaining int
}
// editorBinaryImage 尝试纯黑白无损编码,不改变透明度,带附加信息或无体积收益时保留原图
// 入参: ctx 取消上下文, data PNG图片数据, img 已解码像素,为nil时读取原图
// 返回: []byte 更小的JBIG2数据,不适用时为nil, error 取消错误
func editorBinaryImage(ctx context.Context, data []byte, img image.Image) ([]byte, error) {
if err := ctx.Err(); err != nil {
return nil, err
}
if !pngBinarySource(ctx, data) {
return nil, ctx.Err()
}
if img == nil {
if pngNonBinaryImage(ctx, data) {
return nil, ctx.Err()
}
var err error
img, _, err = image.Decode(imageInput{ReadCloser: io.NopCloser(bytes.NewReader(data)), ctx: ctx})
if err != nil {
return nil, ctx.Err()
}
}
var output bytes.Buffer
if err := jbig2.EncodeContext(ctx, &output, img, &jbig2.Options{MaxPageBytes: uint64(len(data))}); err != nil || output.Len() >= len(data) {
return nil, ctx.Err()
}
if err := ctx.Err(); err != nil {
return nil, err
}
return output.Bytes(), nil
}
// pngBinarySource 检查PNG是否仅含图像与透明度数据,避免转为JBIG2时丢失附加信息
// 入参: ctx 取消上下文, data PNG编码数据
// 返回: bool 是否无需保留附加信息
func pngBinarySource(ctx context.Context, data []byte) bool {
if len(data) < 33 || string(data[:8]) != "\x89PNG\r\n\x1a\n" {
return false
}
for pos := 8; pos < len(data); {
if ctx.Err() != nil {
return false
}
if len(data)-pos < 12 {
return false
}
length := uint64(binary.BigEndian.Uint32(data[pos:])) + 12
if length > uint64(len(data)-pos) {
return false
}
switch string(data[pos+4 : pos+8]) {
case "IHDR", "PLTE", "IDAT", "tRNS":
case "IEND":
return length == 12 && pos+12 == len(data)
default:
return false
}
pos += int(length)
}
return false
}
// pngNonBinaryImage 检查PNG前部像素是否包含灰阶、彩色或透明度,仅用于排除黑白压缩
// 入参: ctx 取消上下文, data PNG图片数据
// 返回: bool 已发现非不透明黑白像素,无法判定时为false
func pngNonBinaryImage(ctx context.Context, data []byte) bool {
if len(data) < 33 || string(data[:8]) != "\x89PNG\r\n\x1a\n" || binary.BigEndian.Uint32(data[8:]) != 13 || string(data[12:16]) != "IHDR" {
return false
}
header := data[16:29]
width, height := binary.BigEndian.Uint32(header), binary.BigEndian.Uint32(header[4:])
depth, kind := header[8], header[9]
if width == 0 || height == 0 || (depth != 8 && depth != 16) || header[10] != 0 || header[11] != 0 || header[12] != 0 {
return false
}
colors, channels := 0, 0
switch kind {
case 0:
colors, channels = 1, 1
case 2:
colors, channels = 3, 3
case 4:
colors, channels = 1, 2
case 6:
colors, channels = 3, 4
default:
return false
}
colors *= int(depth / 8)
channels *= int(depth / 8)
size := uint64(width) * uint64(channels)
if size > 256<<10 {
return false
}
probe := pngBinaryProbe{ctx: ctx, data: data[33:], remaining: pngBinaryProbeLimit}
for len(probe.data) >= 12 && string(probe.data[4:8]) != "IDAT" {
if ctx.Err() != nil {
return false
}
length := uint64(binary.BigEndian.Uint32(probe.data)) + 12
if length > uint64(len(probe.data)) || length > uint64(probe.remaining) {
return false
}
probe.data = probe.data[int(length):]
probe.remaining -= int(length)
}
stream, err := zlib.NewReader(&probe)
if err != nil {
return false
}
defer stream.Close()
row := make([]byte, int(size)+1)
previous := make([]byte, int(size))
rows := min(int64(height), 64, (1<<20)/int64(len(row)))
for index := int64(0); index < rows; index++ {
if ctx.Err() != nil {
return false
}
if _, err := io.ReadFull(stream, row); err != nil || !pngBinaryProbeFilter(row[1:], previous, channels, row[0]) {
return false
}
for offset := 1; offset < len(row); offset += channels {
value := row[offset]
if value != 0 && value != 255 {
return true
}
for _, sample := range row[offset : offset+colors] {
if sample != value {
return true
}
}
for _, sample := range row[offset+colors : offset+channels] {
if sample != 255 {
return true
}
}
}
copy(previous, row[1:])
}
return false
}
// Read 读取有限的IDAT数据,边界或长度无效时停止检查
// 入参: output 读取缓冲区
// 返回: int 读取字节数, error 读取错误
func (p *pngBinaryProbe) Read(output []byte) (int, error) {
if len(output) == 0 {
return 0, nil
}
if err := p.ctx.Err(); err != nil {
return 0, err
}
for len(p.payload) == 0 {
if err := p.ctx.Err(); err != nil {
return 0, err
}
if len(p.data) < 12 || p.remaining < 12 || string(p.data[4:8]) != "IDAT" {
return 0, io.EOF
}
length := uint64(binary.BigEndian.Uint32(p.data))
if length > uint64(len(p.data)-12) {
return 0, io.ErrUnexpectedEOF
}
p.payload = p.data[8 : 8+int(length)]
p.data = p.data[12+int(length):]
p.remaining -= 12
}
if p.remaining == 0 {
return 0, io.EOF
}
count := copy(output[:min(len(output), p.remaining)], p.payload)
p.payload = p.payload[count:]
p.remaining -= count
return count, nil
}
// pngBinaryProbeFilter 还原黑白检查所需的扫描行
// 入参: row 当前行, previous 前一行, stride 像素字节数, filter PNG过滤方式
// 返回: bool 过滤方式有效
func pngBinaryProbeFilter(row, previous []byte, stride int, filter byte) bool {
if filter > 4 {
return false
}
for index := range row {
var left, upperLeft byte
if index >= stride {
left, upperLeft = row[index-stride], previous[index-stride]
}
up := previous[index]
switch filter {
case 1:
row[index] += left
case 2:
row[index] += up
case 3:
row[index] += byte((uint16(left) + uint16(up)) / 2)
case 4:
a, b := int(up)-int(upperLeft), int(left)-int(upperLeft)
c := a + b
if a < 0 {
a = -a
}
if b < 0 {
b = -b
}
if c < 0 {
c = -c
}
switch {
case a <= b && a <= c:
row[index] += left
case b <= c:
row[index] += up
default:
row[index] += upperLeft
}
}
}
return true
}