psd-tools 技术文档

psd-tools 技术文档

psd-tools 项目地址: https://gitcode.com/gh_mirrors/ps/psd-tools

1. 安装指南

1.1 使用 pip 安装

psd-tools 是一个用于处理 Adobe Photoshop PSD 文件的 Python 包。您可以通过 pip 轻松安装该包。请在命令行中运行以下命令：

pip install psd-tools

1.2 验证安装

安装完成后，您可以通过以下 Python 代码验证安装是否成功：

import psd_tools
print(psd_tools.__version__)

如果成功输出版本号，则说明安装成功。

2. 项目使用说明

2.1 基本使用

psd-tools 提供了对 PSD 文件的基本读取和写入功能。以下是一个简单的示例，展示如何打开一个 PSD 文件并将其保存为 PNG 格式：

from psd_tools import PSDImage

# 打开 PSD 文件
psd = PSDImage.open('example.psd')

# 将 PSD 文件保存为 PNG 格式
psd.composite().save('example.png')

# 遍历 PSD 文件中的每一层
for layer in psd:
    print(layer)
    layer_image = layer.composite()
    layer_image.save(f'{layer.name}.png')

2.2 功能支持

psd-tools 支持以下功能：

• 读取和写入 PSD/PSB 文件结构：支持低级别的 PSD 和 PSB 文件结构读取和写入。
• 导出图层图像：支持将图层图像导出为 NumPy 和 PIL 格式。

此外，psd-tools 还提供了有限的支持：

• 图层合成：支持基本像素图层的合成。
• 填充层效果：支持填充层效果的合成。
• 矢量蒙版：支持矢量蒙版的处理。
• 图层属性编辑：支持编辑一些图层属性，如图层名称。

2.3 不支持的功能

psd-tools 目前不支持以下功能：

• 图层结构编辑：不支持添加或删除图层。
• 调整层合成：不支持调整层的合成。
• 图层效果合成：不支持许多图层效果的合成。
• 字体渲染：不支持字体渲染。

3. 项目 API 使用文档

3.1 PSDImage 类

PSDImage 类是 psd-tools 的核心类，用于处理 PSD 文件。

3.1.1 打开 PSD 文件

psd = PSDImage.open('example.psd')

3.1.2 保存为 PNG 文件

psd.composite().save('example.png')

3.1.3 遍历图层

for layer in psd:
    print(layer)
    layer_image = layer.composite()
    layer_image.save(f'{layer.name}.png')

3.2 其他 API

psd-tools 还提供了其他一些 API，用于处理 PSD 文件的不同部分，如 psd_tools.api.layers、psd_tools.api.mask 等。详细信息请参考官方文档。

4. 项目安装方式

psd-tools 可以通过 pip 进行安装。请在命令行中运行以下命令：

pip install psd-tools

安装完成后，您可以在 Python 代码中导入并使用该包。

---

通过以上文档，您应该能够顺利安装和使用 psd-tools 包来处理 Adobe Photoshop PSD 文件。如需更多详细信息，请参考官方文档：psd-tools 官方文档。

psd-tools 项目地址: https://gitcode.com/gh_mirrors/ps/psd-tools