PythonでPSDをPNGに変換する方法｜psd-toolsの使い方と合成の限界

pip install psd-tools

pip install 'psd-tools[composite]'

# Ubuntu/Debian
apt-get install liblcms2-2

# macOS
brew install little-cms2

from psd_tools import PSDImage

# PSDファイルを開く
psd = PSDImage.open('example.psd')

# ファイル情報を表示
print(psd)  # PSDImage(mode=RGB size=101x55 depth=8 channels=3)

# 全レイヤーを合成してPNG出力
image = psd.composite()
image.save('output.png')

# 全レイヤーをループ
for layer in psd:
    print(f"レイヤー名: {layer.name}")
    print(f"レイヤータイプ: {layer.kind}")
    print(f"サイズ: {layer.width}x{layer.height}")
    print(f"可視性: {layer.visible}")
    print("---")

# 最初のレイヤーを取得
first_layer = psd[0]

# ネストしたレイヤーにアクセス
nested_layer = psd[0][0]

# ピクセルレイヤーの確認
if layer.kind == 'pixel':
    # レイヤーを画像として出力
    layer_image = layer.composite()
    layer_image.save(f'{layer.name}.png')
    
    # NumPy配列として取得
    pixels = layer.numpy()
    print(pixels.shape)  # (height, width, channels)
    
    # PIL Imageとして取得
    pil_image = layer.topil()

# グループ内のレイヤーを反復処理
for layer in psd:
    if layer.is_group():
        print(f"グループ: {layer.name}")
        for child in layer:
            print(f"  - {child.name}")

if layer.kind == 'type':
    # テキスト内容を取得
    print(f"テキスト: {layer.text}")
    
    # スタイル情報（読み取り専用）
    print(f"エンジン辞書: {layer.engine_dict}")
    print(f"リソース辞書: {layer.resource_dict}")

if layer.kind == 'shape':
    # ベクターマスク情報
    print(layer.vector_mask)
    
    # ライブシェイププロパティ
    for shape in layer.origination:
        print(shape)

import io
from PIL import Image

if layer.kind == 'smartobject':
    # スマートオブジェクトデータにアクセス
    smart_obj = layer.smart_object
    
    if smart_obj.filetype in ('jpg', 'png'):
        image = Image.open(io.BytesIO(smart_obj.data))
        image.save(f'{layer.name}_embedded.{smart_obj.filetype}')

# SolidColorFill（ベタ塗り）
# PatternFill（パターン）
# GradientFill（グラデーション）

# レイヤー情報の取得
print(f"名前: {layer.name}")
print(f"可視性: {layer.visible}")
print(f"不透明度: {layer.opacity}")  # 0-255
print(f"位置: ({layer.left}, {layer.top})")
print(f"サイズ: {layer.width}x{layer.height}")
print(f"バウンディングボックス: {layer.bbox}")  # (left, top, right, bottom)

# レイヤー属性の編集（書き込み可能）
layer.name = "新しい名前"
layer.visible = False
layer.opacity = 128
layer.left = 100
layer.top = 50

from psd_tools.constants import BlendMode

# ブレンドモードの確認
print(layer.blend_mode)

# ブレンドモードの変更
if layer.blend_mode == BlendMode.NORMAL:
    layer.blend_mode = BlendMode.SCREEN

from psd_tools.constants import ProtectedFlags

# レイヤーのピクセルと位置をロック
layer.lock(ProtectedFlags.COMPOSITE | ProtectedFlags.POSITION)

# マスクの有無を確認
if layer.has_mask():
    # マスクを取得
    mask = layer.mask
    
    # マスクを画像として出力
    mask_image = mask.topil()
    mask_image.save('mask.png')

# ベクターマスクの確認
if layer.has_vector_mask():
    print(layer.vector_mask)

# 名前でレイヤーを検索
def find_layer_by_name(psd, name):
    for layer in psd.descendants():
        if layer.name == name:
            return layer
    return None

target_layer = find_layer_by_name(psd, "背景")

# レイヤーを上に移動
layer.move_up()

# レイヤーを下に移動
layer.move_down()

# レイヤーをグループに追加
group = psd[0]
group.append(layer)

# レイヤーを削除
layer.remove()

# グループをクリア
group.clear()

from PIL import Image
from psd_tools import PSDImage

# 新しいPSDを作成
psd = PSDImage.new(mode='RGB', size=(640, 480), depth=8)

# PIL画像からレイヤーを作成
pil_image = Image.open('input.png')
layer = psd.create_pixel_layer(
    pil_image,
    name="Layer 1",
    top=0,
    left=0,
    opacity=255
)

# グループを作成
group = psd.create_group(name="Group 1")
group.append(layer)

# 保存
psd.save('new_image.psd')

# 複数のレイヤーを新しいグループにまとめる
layer1 = psd[0]
layer2 = psd[1]

group = psd.create_group(
    layer_list=[layer1, layer2],
    name="New Group"
)

# PSD全体を合成
image = psd.composite()
image.save('output.png')

# 特定のビューポートで合成
viewport = (0, 0, 300, 300)  # (x1, y1, x2, y2)
image = psd.composite(viewport=viewport)

# テキストレイヤーを除外して合成
image = psd.composite(
    layer_filter=lambda layer: layer.is_visible() and layer.kind != 'type'
)

for layer in psd:
    if layer.kind == 'pixel':
        # レイヤーを合成して出力（マスクとクリッピングレイヤーを含む）
        layer_image = layer.composite()
        layer_image.save(f'{layer.name}.png')

# レイヤーとマスクを別々にエクスポート（合成なし）
layer_image = layer.topil()
layer_image.save('layer_no_mask.png')

if layer.has_mask():
    mask_image = layer.mask.topil()
    mask_image.save('mask.png')

from psd_tools.constants import ChannelID

# RGB個別チャンネル
red = layer.topil(ChannelID.CHANNEL_0)
green = layer.topil(ChannelID.CHANNEL_1)
blue = layer.topil(ChannelID.CHANNEL_2)

# アルファチャンネル
alpha = layer.topil(ChannelID.TRANSPARENCY_MASK)

import numpy as np

# PSD全体をNumPy配列として取得
array = psd.numpy()
print(array.shape)  # (height, width, channels)

# レイヤーをNumPy配列として取得
layer_array = layer.numpy()

# 特定のチャンネルのみ取得
color_only = layer.numpy(channel='color')
alpha_only = layer.numpy(channel='alpha')
mask_only = layer.numpy(channel='mask')
shape_only = layer.numpy(channel='shape')

psd-tools show example.psd

# PSD全体をエクスポート
psd-tools export example.psd output.png

# 特定のレイヤーをエクスポート（インデックス指定）
psd-tools export example.psd[0] layer0.png

psd-tools debug example.psd

# レイヤーエフェクトの有無を確認
if layer.has_effects():
    # エフェクト情報にアクセス
    effects = layer.effects

# ベクターマスク情報
if layer.has_vector_mask():
    vector_mask = layer.vector_mask
    print(vector_mask)

# ライブシェイププロパティ
if layer.has_origination():
    for shape in layer.origination:
        # Rectangle, RoundedRectangle, Ellipse, Line など
        print(type(shape).__name__)

# クリッピングフラグ
print(layer.clipping)
layer.clipping = 1  # クリッピングマスクとして設定

from psd_tools.constants import Tag

# タグ付きブロックにアクセス
tagged_blocks = layer.tagged_blocks

# 特定のタグの情報を取得
if Tag.LAYER_ID in tagged_blocks:
    layer_id = tagged_blocks[Tag.LAYER_ID]

from pathlib import Path
from psd_tools import PSDImage

def export_all_layers(psd_path, output_dir):
    """PSDファイルの全レイヤーを個別の画像ファイルとして出力"""
    psd = PSDImage.open(psd_path)
    output_path = Path(output_dir)
    output_path.mkdir(exist_ok=True)
    
    for i, layer in enumerate(psd.descendants()):
        if layer.kind in ('pixel', 'shape'):
            try:
                image = layer.composite()
                # ファイル名をサニタイズ
                safe_name = "".join(c for c in layer.name if c.isalnum() or c in (' ', '-', '_'))
                image.save(output_path / f"{i:03d}_{safe_name}.png")
                print(f"Exported: {layer.name}")
            except Exception as e:
                print(f"Error exporting {layer.name}: {e}")

# 使用例
export_all_layers('example.psd', 'output_layers')

import json
from psd_tools import PSDImage

def extract_layer_info(psd_path):
    """レイヤー情報を辞書形式で抽出"""
    psd = PSDImage.open(psd_path)
    
    def layer_to_dict(layer):
        info = {
            'name': layer.name,
            'kind': layer.kind,
            'visible': layer.visible,
            'opacity': layer.opacity,
            'blend_mode': str(layer.blend_mode),
            'bbox': layer.bbox,
            'has_mask': layer.has_mask(),
        }
        
        if layer.is_group():
            info['children'] = [layer_to_dict(child) for child in layer]
        
        return info
    
    result = {
        'mode': psd.mode,
        'size': (psd.width, psd.height),
        'depth': psd.depth,
        'layers': [layer_to_dict(layer) for layer in psd]
    }
    
    return result

# 使用例
info = extract_layer_info('example.psd')
print(json.dumps(info, indent=2, ensure_ascii=False))

from pathlib import Path
from psd_tools import PSDImage

def batch_convert_psd_to_png(input_dir, output_dir):
    """ディレクトリ内の全PSDファイルをPNGに変換"""
    input_path = Path(input_dir)
    output_path = Path(output_dir)
    output_path.mkdir(exist_ok=True)
    
    for psd_file in input_path.glob('*.psd'):
        try:
            psd = PSDImage.open(psd_file)
            image = psd.composite()
            
            output_file = output_path / f"{psd_file.stem}.png"
            image.save(output_file)
            print(f"Converted: {psd_file.name} -> {output_file.name}")
        except Exception as e:
            print(f"Error converting {psd_file.name}: {e}")

# 使用例
batch_convert_psd_to_png('input_psds', 'output_pngs')

# 低レベルデータ構造にアクセス
psd._record  # 低レベルPSDレコード

pip install 'psd-tools[composite]'

# Ubuntu/Debian
apt-get install liblcms2-2

# macOS
brew install little-cms2

# Pillowを再インストール
pip uninstall Pillow
pip install Pillow