PNG / BMP 图像编解码器¶

cp png/png.py your_project/

from png import decode_png, encode_png, Image

from png import decode_png

img = decode_png("photo.png")
print(f"{img.width}x{img.height} {img.mode} {img.bit_depth}-bit")
print(f"像素数据: {len(img.data)} bytes")

from png import encode_png, Image

# 创建 2x2 红色图像
pixels = bytes([255, 0, 0, 255, 0, 0, 0, 255, 0, 0, 255, 0])
img = Image(width=2, height=2, data=pixels, mode="RGB")

# 保存到文件
encode_png(img, "output.png")

# 或获取字节
png_bytes = encode_png(img)

from png import decode_bmp, encode_bmp

# 解码 BMP
img = decode_bmp("image.bmp")

# PNG 转 BMP
from png import decode_png, encode_bmp
img = decode_png("input.png")
encode_bmp(img, "output.bmp")

from png import decode_png, convert

img = decode_png("color.png")  # RGBA
gray = convert(img, "L")       # 灰度
rgb = convert(img, "RGB")      # 去除透明度

import math
from png import matrix_to_png, png_to_matrix

# 将二维浮点矩阵压缩为 PNG
matrix = [[math.sin(x * 0.1 + y * 0.2) for x in range(256)]
          for y in range(256)]
matrix_to_png(matrix, "data.png", bit_depth=16)

# 还原（整数无损，浮点数量化）
restored = png_to_matrix("data.png")

from png import encode_png, Image

img = Image(width=100, height=100, data=pixels, mode="RGB")

# 自动选择每行最优滤波器（默认）
encode_png(img, filter_strategy="auto")

# 强制指定滤波器
encode_png(img, filter_strategy="sub")    # 适合照片
encode_png(img, filter_strategy="paeth")  # 适合渐变
encode_png(img, filter_strategy="none")   # 最快，体积最大