PhotoCraft 图片格式完整指南:16 种格式读写能力、PSD 无损往返与 RAW 开发清单
【免费下载链接】photocraftPhotoCraft: An open-source, photo editor written by scratch in pure Rust项目地址: https://gitcode.com/gh_mirrors/pho/photocraft
PhotoCraft 是一个用纯 Rust 从零实现的开源 Photoshop 重新实现项目。它的图片格式能力由三条互不依赖的路径承担:crates/psd/ 负责 PSD/PSB 工程文件,crates/codecs/ 负责平面位图的解码与编码,crates/format/ 负责原生 .pcraft 存档。下文按"文件能不能打开、导出时怎么选、RAW 能开发到什么程度"这三个实际使用问题展开,最后汇总识别机制与安全限制,读完即可判断自己的文件是否被支持。
16 种图片格式按用途分组:先判断你的文件属于哪一类
16 种格式中 14 种同时可读可写;AVIF 只编码、不解码(需开启 avif feature);相机 RAW 只读。按用途分组后的能力总表如下:
| 分组 | 格式 | 支持程度 | 典型场景 / 关键限制 |
|---|---|---|---|
| Photoshop 文档 | PSD / PSB | 可读可写 | PSD 版本 1、PSB 版本 2;未知块原样保留 |
| 原生文档 | .pcraft | 可读可写 | ZIP 容器 + zstd 瓦片;无损,适合日常保存 |
| 平面位图 | PNG | 可读可写 | 16-bit + alpha;保留 ICC/EXIF/XMP/DPI;APNG 取首帧 |
| JPEG | 可读可写 | 有损压缩,无 alpha 通道;保留 ICC/EXIF/XMP | |
| TIFF | 可读可写 | 8/16-bit 与 32-bit 浮点;CMYK 全通道布局 | |
| WebP | 可读可写 | 支持动画容器,解码取首帧 | |
| GIF | 可读可写 | 最多 256 色;尺寸上限 65535×65535 | |
| BMP | 可读可写 | 经典 DIB 位图 | |
| TGA | 可读可写 | 灰度与灰度 + alpha | |
| ICO | 可读可写 | 编码上限 256×256 | |
| Netpbm / PFM | 可读可写 | PBM、PGM、PPM、PAM、PFM 系列 | |
| QOI | 可读可写 | 快速无损压缩 | |
| HDR 与 32-bit | OpenEXR | 可读可写 | 16/32-bit 浮点,HDR 工作流 |
| Radiance HDR | 可读可写 | 32-bit 浮点 RGB,有损 | |
| AVIF | 仅编码 | 需开启 avif feature,不解码 | |
| RAW | 相机 RAW | 仅读取 | DNG、CR2、NEF、ARW 等,见下文 |
每种格式的位深、通道布局、Alpha、ICC、EXIF 等完整能力声明,以 crates/codecs/src/format.rs 中的能力表为准;格式文档汇总在 book/src/formats/。
打开 PSD/PSB 工程文件:往返保存会不会丢信息
设计目标就是不丢:读写对象是 Adobe 公开规范,不被识别的内容一律原样带回。
- 版本覆盖:PSD 版本 1 与 PSB 版本 2,PSB 面向超大画布文档。
- 未知块保留:图层特效等不被识别的块,在"打开→另存"的往返中按原始字节写回,保证 round-trip 保真。
- 惰性解码:通道数据按需解码,打开大文件时不额外占用内存。
- 解析器硬性保护:宽高各 ≤300,000 像素、文档通道 ≤56、单层通道 ≤64,越界即拒绝解析,畸形文件不会导致崩溃。
实现位于 crates/psd/,限制与细节见 book/src/formats/psd-psb.md。
导出时怎么选图片格式:透明、印刷与网络场景的能力边界
先给选择规则:需要透明背景选 PNG、WebP 或 TIFF;CMYK 印刷或 32-bit 浮点选 TIFF;网络分发选 JPEG,但它没有 alpha 通道,透明内容必须换格式。
- PNG:16-bit 位深,灰度、灰度+alpha、RGB、RGBA 全布局;保留 ICC 配置文件、EXIF、XMP、DPI;动画 APNG 解码取首帧。
- TIFF:平面格式中能力最全,8/16-bit 整数与 32-bit 浮点通吃,支持 CMYK 及 CMYK+alpha 的完整通道布局。
- JPEG:有损压缩,元数据(ICC/EXIF/XMP/DPI)完整保留;透明内容导出应改用 PNG 或 WebP。
- AVIF:只有编码入口,需开启 avif feature,解码暂不可用。
- 尺寸硬上限:JPEG 与 GIF 最大 65535×65535 像素,WebP 最大 16384×16384,ICO 最大 256×256,其余平面格式无格式级尺寸限制。
📷 相机 RAW 支持:DNG、CR2、NEF、ARW 的完整开发与回退策略
RAW 解码由 crates/raw/(纯 Rust 实现)承担;RAW 文件的解码输出是一张 16-bit 文档,色彩标签为 ProPhoto。
- 完整支持:DNG(含无损 JPEG 编码)、Canon CR2、Nikon NEF/NRW、Sony ARW(含压缩 cRAW)、Pentax PEF、Panasonic RW2、Olympus ORF。
- 回退策略:压缩 NEF、PEF 等缺少公开文档的格式,改走文件内嵌的 JPEG 预览,保证至少能打开。
- 暂不支持:CR3 与 RAF;若文件带预览则使用预览。
.pcraft 原生文档格式:日常保存工程的无损选择
.pcraft 是 PhotoCraft 自己的文档格式,无损,反复保存不会像 JPEG 那样逐次降质,适合作为日常工程存档。
- ZIP 容器内部包含版本化 manifest.json、内容寻址的 zstd 压缩瓦片、缩略图与合成预览。
- 所有条目带 CRC 校验和哈希,损坏会被显式检出,而不是静默打开一个坏文件。
- 格式说明见 book/src/formats/pcraft.md。
🛡️ 坏文件会不会拖垮软件:magic number 识别与解码资源限制
PhotoCraft 把文件解析当作安全边界处理:解码前检查尺寸,格式判定看文件头。
- 识别机制:按 magic number 判定格式(如 PNG 的 8 字节签名、TIFF 的 II*/MM* 头),改扩展名不影响识别结果。
- 默认解码限制:
- 最大宽 / 高:262,144 像素
- 最大总像素数:约 2.68 亿
- 最大解码内存:2 GiB
- 实际效果:一个声明"解压后 100 GB"的几 KB 恶意文件,会在真正分配内存之前被限制拦截,不会拖垮软件。
限制定义见 book/src/formats/raster-formats.md。
自查三个问题:
- 扩展名在
.psd/.psb/.png/.jpg/.tif/.webp/.gif/.bmp/.tga/.ico/.qoi/.exr/.hdr/.pcraft之内 → 在上表中找对应行确认读写能力; - 不确定格式归属 → 直接打开即可,程序依据文件头判定;
- 要确认某平面格式的位深、Alpha、动画能力 → 查 crates/codecs/src/format.rs 的能力表。
【免费下载链接】photocraftPhotoCraft: An open-source, photo editor written by scratch in pure Rust项目地址: https://gitcode.com/gh_mirrors/pho/photocraft
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考