Features

功能

Aspose.PSD 是针对 Python 的自由开源软件，能够加载、检查并保存 PSD 和 PSB 文档，而无需渲染像素数据。功能集被划分为多个领域，每个领域都有其专属指南。

文档加载、检查与保存

PsdImage.load() 从文件路径或流加载文档； PsdImage.save() 将其写回。 PsdImage 公开已解析的头部（width, height, color_mode, compression，以及更多）以及已解析的图像资源。参见 Core API 获取完整参考。

文档章节

在顶层标题之外， PsdImage 公开只读的颜色数据和图像数据部分摘要。参见 Sections 完整参考请参阅。

图层元数据

每个已解析的 Layer 公开其几何形状、可见性、不透明度、裁剪和混合模式，以及通道、蒙版和混合范围元数据。可以更改并保存部分图层属性；图层集合本身也可以重新分配。参见 Layers 完整参考请参阅。

图像资源

PsdImage 公开文档的图像资源块的两种形式，并提供索引颜色调色板的单独摘要。参见 Resources 完整参考请参阅。

错误处理

加载和保存失败通过以下方式报告 PsdLoadException and PsdSaveException，两者均扩展了标准 Exception 类。参见 核心异常 完整参考请参阅。

写回文档

PsdImage.save() 是用于将文档写入文件路径或流的唯一公开入口点。参见 写入描述符 完整参考请参阅。

原始字节转换

BigEndianBitConverter 从您自行获取的原始字节解码大端整数——例如，来自未识别的图像资源。参见 Conversion 完整参考请参阅。

不支持的内容

此库不渲染像素数据，也不将 PSD/PSB 转换为其他图像格式（如 PNG 或 JPEG）。它是面向元数据的 PSD/PSB 容器格式的读取器和写入器。

提示与最佳实践

• 从以下开始 核心 API 用于加载、检查和保存文档。
• 使用 Layers 当您需要读取或编辑单个层的元数据时。
• Wrap load()/save() 在所描述的异常处理中的调用 核心异常.

常见问题

FAQ

此库是否渲染或转换 PSD 文件？

不。它仅加载、检查并保存 PSD/PSB 文档——不渲染像素数据，也不转换为其他图像格式。

我该从哪里开始？

核心 API 对于 PsdImage 入口点，然后 Layers 用于图层级别的元数据，和 核心异常 用于错误处理。

API Reference 概述

另请参阅

• Aspose.PSD — Enterprise Documentation