如何使用imageio调整图像尺寸生成合规ICO文件？横图导出报错如何解决

报错根因 #

ICO格式存在强制格式校验规则：

• 强制要求所有可存储的图像为等宽高的正方形画布，不支持横向、纵向的非正方形图像写入
• 全场景兼容的有效尺寸为固定正方形值：16x16、32x32、48x48、64x64、128x128、256x256
  原实现未对图像做正方形适配，输入为正方形常规图像时可正常写入，输入横向非正方形图像时即触发格式校验报错。

具体实现步骤 #

调整流程全程可通过imageio原生能力完成，无需引入第三方图像处理库，核心操作分为三步：

• 读取原始输入图像
• 将非正方形的原始图像缩放适配为ICO兼容的标准正方形尺寸
• 将处理后的正方形图像写入为ICO格式文件

可直接运行的实现代码 #

import imageio.v2 as imageio
from imageio.transform import resize

# 读取原始图像
raw_image = imageio.imread('image.png')

# 选用256x256作为目标尺寸，该尺寸为Windows系统ICO文件的通用兼容尺寸，可自动向下适配小尺寸渲染场景
target_square_size = (256, 256)

# 对原始图像做尺寸适配，强制输出正方形画布，解决横向图像触发的格式报错
processed_image = resize(raw_image, target_square_size)

# 生成可正常使用的ICO文件
imageio.imwrite("image.ico", processed_image)

注意事项 #

• 建议统一使用imageio.v2接口读写图像，老版本v1接口对ICO格式的校验逻辑较松，生成的ICO文件可能出现部分系统无法识别的兼容性问题
• 写入ICO文件时，传入的图像宽高必须完全相等，哪怕选择的尺寸数值在ICO支持的取值范围内，只要宽高不匹配就会触发报错
• 处理带透明通道的PNG源图时，resize操作会完整保留alpha通道，不会出现透明背景丢失的问题
• 如需生成多尺寸内嵌的通用ICO文件，可将多个不同正方形尺寸的图像组成列表传入imwrite的写入参数，生成的单个ICO文件可适配系统不同场景的图标显示需求

内容的提问来源于stack exchange，提问作者Eklavya Chandra