介绍
Aspose.PSD FOSS 用于 .NET 是一个新的开源库，用于在 .NET 代码中处理 PSD 和 PSB（Photoshop 大文档）文件。它在 MIT 许可证下发布，运行时仅需要 .NET 10.0，且没有其他第三方依赖。该包通过 using Aspose.PSD.FOSS; 导入。
该库围绕 PsdImage 类组织，该类继承自抽象的 Image 基类，以及 Layer 类。Image.Load() / PsdImage.Load() 从文件路径或流中加载文档，公开头部信息（Width、Height、ColorMode、Version、Compression）以及已解析的 Layers 集合；PsdImage.Save() 将文档写回文件或流。每个 Layer 都暴露其自身的元数据——Name、Bounds、IsVisible、Opacity、Clipping、BlendModeKey，以及通道/遮罩信息——其中一部分属性可以就地修改并保存回文件。
此版本面向需要在 .NET 代码库中检查或进行有限元数据编辑的开发者，且不具备商业许可证——例如用于报告图层结构的资产管线工具、在交付前重命名或切换图层可见性的构建脚本，或需要读取 PSD 头部和图层数据而无需完整渲染引擎的测试夹具。该库不渲染像素数据，也不将 PSD/PSB 转换为其他图像格式——它是针对 PSD/PSB 容器格式的元数据专注型读写器。
包含内容
文档检查
PsdImage.Load() 将 PSD 或 PSB 文件的头部解析为类型化属性——Width、Height、BitsPerChannel、ColorMode、Version、Compression、Size 和 IsFlatten——而不解码像素数据。
using var image = (PsdImage)Image.Load(inputPath);
Console.WriteLine($"Width: {image.Width}, Height: {image.Height}");
Console.WriteLine($"ColorMode: {image.ColorMode}, Version: {image.Version}");
Console.WriteLine($"Layers: {image.Layers.Length}, Compression: {image.Compression}");
图层元数据
在 PsdImage.Layers 中的每个条目都是一个 Layer，展示其自身的边界、可见性、不透明度、剪裁和混合模式元数据。
foreach (var layer in image.Layers)
{
Console.WriteLine($"{layer.Name}: {layer.Bounds}, Visible={layer.IsVisible}, Opacity={layer.Opacity}");
}
支持的元数据编辑
可以直接修改并使用 PsdImage.Save() 写回的图层属性子集包括：名称、可见性、不透明度、剪裁、混合模式键以及四个边界边。
Layer layer = image.Layers[0];
layer.Name = $"{layer.Name} (edited)";
layer.IsVisible = !layer.IsVisible;
layer.Opacity = 128;
layer.BlendModeKey = BlendMode.Multiply;
image.Save(outputPath);
快速入门
安装该软件包，然后加载 PSD 或 PSB 文件，检查其图层，并保存回去：
git clone https://github.com/aspose-psd-foss/Aspose.PSD-FOSS-for-.NET.git
cd Aspose.PSD-FOSS-for-.NET
dotnet buildusing Aspose.PSD.FileFormats.Psd;
using var image = (PsdImage)Image.Load("input.psd");
Console.WriteLine($"Width: {image.Width}, Height: {image.Height}, Layers: {image.Layers.Length}");
foreach (var layer in image.Layers)
{
Console.WriteLine($" {layer.Name}: {layer.Bounds}");
}
image.Save("output.psd");
支持的格式
| 格式 | 扩展名 | 读取 | 写入 |
|---|---|---|---|
| Photoshop 文档 | psd | ✓ | ✓ |
| Photoshop 大型文档 | psb | ✓ | ✓ |
开源与许可
Aspose.PSD FOSS for .NET 是 MIT 许可证，并可在商业产品中免费使用，无需版税，且没有评估水印或使用限制。
该软件包当前版本为 1.0.0，运行时仅需要 .NET 10.0 —— 并且没有其他第三方依赖。
