Python通过psd-tools解析PSD文件——简介

最近碰到事务需要依据PSD文件实现PSD文件解析图层功用，搜到了Python的一个解析PSD的库。这个库就是psd-tools，psd-tools是一个Python软件包，用于处理Adobe Photoshop PSD文件。以下就是psd-tools的根本介绍。

特色

支撑:

• 读取和写入初级的PSD/PSB文件结构
• 以NumPy和PIL格局导出原始图层图画

有限的支撑：

• 基于像素的根本图层的结构
• 填充层作用的结构
• 矢量面具
• 修改一些图层特点，如图层称号
• 除溶解外的混合形式
• 制作贝塞尔曲线

不支撑：

• 修改图层结构，如增加或删除一个图层
• 调整层的结构
• 许多层作用的结构
• 字体渲染

装置

运用pip来装置该软件包。

pip install psd-tools

为了用完整的图层图画组成功用，也能够装置NumPy/SciPy:

pip install numpy scipy

运用

简单的比如

from psd_tools import PSDImage
psd = PSDImage.open('example.psd')
psd.composite().save('example.png')
for layer in psd:
    print(layer)
    layer_image = layer.composite()
    layer_image.save('%s.png' % layer.name)

命令行

该软件包供给命令行工具来处理PSD文件。

psd-tools export <input_file> <output_file> [options]
psd-tools show <input_file> [options]
psd-tools debug <input_file> [options]
psd-tools -h | --help
psd-tools --version

比如:

psd-tools show example.psd  # 显示文件内容
psd-tools export example.psd example.png  # 导出为PNG
psd-tools export example.psd[0] example-0.png  # 将图层导出为PNG

操作PSD文件

psd_tools.api 包供给了用户友好的API来处理PSD文件。

翻开一个图画:

from psd_tools import PSDImage
psd = PSDImage.open('my_image.psd')

psd-tools中的大部分数据结构都支撑在IPython环境下的打印：

In [1]: PSDImage.open('example.psd')
Out[1]:
PSDImage(mode=RGB size=101x55 depth=8 channels=3)
  [0] PixelLayer('Background' size=101x55)
  [1] PixelLayer('Layer 1' size=85x46)

内部层能够经过迭代器或索引进行拜访：

for layer in psd:
    print(layer)
    if layer.is_group():
        for child in layer:
            print(child)
child = psd[0][0]

翻开的PSD文件能够保存:

psd.save('output.psd')

操作运用层

在Photoshop中，有各种层的种类。

最根本的图层类型是PixelLayer:

print(layer.name)
layer.kind == 'pixel'

有些图层特点是可修改的，如图层称号:

layer.name = 'Updated layer 1'

组里有内部层:

for layer in group:
    print(layer)
first_layer = group[0]

TypeLayer 是一个带有文本的层:

print(layer.text)

ShapeLayer 制作一个矢量形状，形状信息存储在vector_mask和origination特点中。其他层也能够有形状信息作为遮罩:

print(layer.vector_mask)
for shape in layer.origination:
    print(shape)

SmartObjectLayer 嵌入或链接一个外部文件，用于非破坏性修改。文件内容能够经过smart_object特点拜访:

import io
if layer.smart_object.filetype in ('jpg', 'png'):
    image = Image.open(io.BytesIO(layer.smart_object.data))

SolidColorFill, PatternFill, 和 GradientFill 是填充图层，假如没有相关的遮罩，它们会制作整个区域。 AdjustmentLayer 的子类表明应用于组成图画的层调整。拜见 Adjustment layers.

将数据导出到 PIL

将整个文件导出为 PIL.Image:

image = psd.composite()
image.save('exported.png')

导出单一图层，包括遮罩和取舍层:

image = layer.composite()

分别导出图层和蒙版，不需要组成:

image = layer.topil()
mask = layer.mask.topil()

要组成特定的图层，如除文本外的图层，请运用layer_filter选项:

image = psd.composite(
    layer_filter=lambda layer: layer.is_visible() and layer.kind != 'type')

请注意，大多数图层作用和调整层不被支撑。组成的结果或许看起来与Photoshop不同。

将数据导出到NumPy

PSDImage或图层能够经过 numpy() 方法导出为NumPy数组:

image = psd.numpy()
layer_image = layer.numpy()

更多操作

1.操作一个PSD文件

#可在源码的psd_image.py中看到PSDImage类
1. 翻开一个文件
from psd_tools import PSDImage
psd = PSDImage.open('my_image.psd')
#回来一个PSDImage类型的目标
#psd_tools中的大多数数据结构都支撑在IPython环境中进行美丽的打印。
#  In [1]: PSDImage.open('example.psd')
#  Out[1]:
#  PSDImage(mode=RGB size=101x55 depth=8 channels=3)
#    [0] PixelLayer('Background' size=101x55)
#    [1] PixelLayer('Layer 1' size=85x46)
##############################################################
2. psd的特点(可在源码的psd_image.py中看到PSDImage类)
有些无意义的特点也定义了，为了和layer一样能够，如：visible直接回来Ture。
这里列出一些有意义，一般会用到的特点：
psd.width #宽
psd.height #高
psd.size #(width, height) tuple
psd.offset #(left, top) tuple
psd.left #0
psd.right #self.width
psd.top #0
psd.bottom #self.height
psd.viewbox #(left, top, right, bottom) `tuple`
psd.bbox #能包围住一切可见的层的最小的方框（x,y,z,w）
psd.color_mode #色彩形式，如RGB，GRAYSCALE
psd.channels #色彩通道数量
psd.depth #像素深度位数
psd.version #文件版本 psd是1，psb是2.
psd.has_preview #Returns if the document has real merged data. When True, `topil()`returns pre-composed data.
psd.has_thumbnail #是否有缩略图
psd.thumbnail #回来	PIL.Image格局的缩略图
这里列出一些无意义的为了能够和layer一样操作的特点：
psd.is_visible() #True
psd.visible #True
psd.parent #None
psd.name   #'Root'
psd.kind #'psdimage'
print(str(psd.is_group()))#是否是组 psd文件直接传进去也是组
psd文件的层能够遍历：
for layer in psd:
print(layer)
if layer.is_group():
    for child in layer:
        print(child)
child = psd[0][0]
#迭代顺序是从背景到前景，与1.7.x之前的版本相反。运用reverse (list(psd))从前台到后台进行迭代。
##############################################################
3. 保存psd文件：
psd.save('output.psd')
4. 用psd文件获取PIL Image.
psd.topil(channel=None, **kwargs)
#channel:0为R，1为G，2为B，-1为A，依据constants.py中ChannelID类。
5. 合并psd文件.
psd.compose(force = False,bbox=None,**kwargs)
6. 用PIL Image生成一个PSDImage目标
from psd_tools import PSDImage
psd = PSDImage.frompilfrompil(image,compression=<Compression.PACK_BITS: 1>)

2.操作一个PSD图层

#可在源码的layers.py中看到Layer类
##############################################################
1.Layer的特点(可在源码的layers.py中看到Layer类)
layer.name #层的名字(可写)
layer.kind #层的类别(字符串)
#(group(图层组), pixel(一般图层), shape, type(文本图层), smartobject,or psdimage(psd自身))
#shape制作矢量形状，形状信息存储在vector_mask和origination特点中。其他图层也能够有形状信息作为蒙版:
#smartobject为非破坏性修改嵌入或链接外部文件。文件内容能够经过smart_object特点拜访。
layer.layer_id #Layer ID.
layer.visible #层自身是否勾选可见(可写)
layer.is_visible() #层是否可见，受父物体影响。(父物体不可见，这个层就算勾选了可见这个也是False)
layer.opacity #透明度 [0,255](可写)
layer.parent #Parent of this layer.
layer.is_group #是否是个组
layer.blend_mode #混合形式(可写)，回来Constants.py中的BlendMode
layer.has_mask #是否有mask
layer.left #左坐标(可写)
layer.top  #顶坐标(可写)
layer.right #右坐标
layer.bottom #底坐标
layer.width #层的宽
layer.height #层的高
layer.offset #(left, top) tuple. (可写)
layer.size #(width, height) tuple.
layer.bbox #(left, top, right, bottom) tuple.
layer.has_pixels() #是否有像素
layer.has_mask() #是否有蒙板
layer.has_vector_mask() #是否有矢量蒙板
layer.mask #层相关的蒙版 return: :py:class:`~psd_tools.api.mask.Mask` or `None`
layer.vector_mask #层相关的矢量蒙版 return: :py:class:`~psd_tools.api.shape.VectorMask` or `None`
layer.has_origination() #是否有实时形状特点
layer.origination #实时形状特点
layer.has_stroke() #是否有比画
layer.stroke #比画
layer.has_clip_layers() #是否有裁剪
layer.clip_layers #裁剪，Clip layers associated with this layer.
layer.has_effects() #是否有作用处理
layer.effects #作用处理 return: :py:class:`~psd_tools.api.effects.Effects`
layer.tagged_blocks #Layer tagged blocks that is a dict-like container of settings.
##############################################################
2. 获得图层的pil图，Get PIL Image of the layer.(回来PIL.Image目标或没像素时回来`None`)
layer.topil(channel=None, **kwargs)
e.g.
from psd_tools.constants import ChannelID
image = layer.topil()
red = layer.topil(ChannelID.CHANNEL_0)
alpha = layer.topil(ChannelID.TRANSPARENCY_MASK)
##############################################################
3. 合并图层和其蒙版(mask, vector mask, and clipping layers)(回来PIL.Image目标或没像素时回来`None`)
layer.compose(bbox=None, **kwargs)
不合并，单独获取：
image = layer.topil()
mask = layer.mask.topil()
from psd_tools import compose
clip_image = compose(layer.clip_layers)

参考资料

• [python库]psd文件操作库–psd_tools
• psd-tools文档