PSD レイヤーを .NET で操作する方法

このガイドでは、ドキュメントのレイヤーを一覧表示し、編集可能なレイヤーメタデータを読み取って変更し、レイヤーの位置を再設定し、コレクションからレイヤーを削除する方法を示します。ロードされた PsdImage の Layers プロパティは、その Layer オブジェクトのコレクションを返します。各 Layer は、名前、可視性、不透明度、クリッピング、ブレンドモード、位置（境界エッジ）— などの編集可能なメタデータを公開し、さらに読み取り専用の全体境界とチャンネル情報を提供します。

ステップバイステップガイド

git clone https://github.com/aspose-psd-foss/Aspose.PSD-FOSS-for-.NET.git
cd Aspose.PSD-FOSS-for-.NET
dotnet build

using System.Linq;
using Aspose.PSD.FileFormats.Psd;
using Aspose.PSD.FileFormats.Core.Blending;

using var image = PsdImage.Load("input.psd");

foreach (var layer in image.Layers)
{
    Console.WriteLine($"{layer.Name}: {layer.Width}x{layer.Height} at ({layer.Left},{layer.Top})");
}

var layer = image.Layers[0];

layer.IsVisible = false;          // hide the layer
layer.Opacity = 200;              // ~78% opacity
layer.BlendModeKey = BlendMode.Multiply;
layer.Name = "Renamed Layer";

Console.WriteLine($"Bounds: {layer.Bounds}");
Console.WriteLine($"Channels: {layer.ChannelsCount}");

layer.Left = 10;
layer.Top = 20;
layer.Right = 40;
layer.Bottom = 60;

image.Layers = image.Layers.Where(l => l.Name != "Renamed Layer").ToArray();

image.Save("output.psd");

一般的な問題と修正方法

NotSupportedException 設定するとき ChannelInformation, LayerMaskData, または LayerBlendingRangesData. これらの3つ Layer setterはこのFOSSビルドではサポートされていません — 読み取り専用として扱ってください。

不透明度の値が設定後に正しくないようです。 Opacity は byte (0-255)、0.0-1.0 の小数やパーセンテージではありません — layer.Opacity = 200 約78%不透明 (200/255) を意味します。

レイヤーへの変更が保存後に反映されません。 変更しているのが Layer から取得したインスタンス image.Layers、そして呼び出していることを image.Save 編集を行った後に。

よくある質問

ドキュメントからレイヤーを削除できますか？

はい — PsdImage.Layers には機能するセッターがあるので、フィルタ済み配列を割り当ててレイヤーを削除できます（ステップ 6 を参照）。

利用可能なブレンドモードは何ですか？

BlendMode には Normal、Multiply、Screen、Overlay、Darken などの値が含まれます — Layer.BlendModeKey で設定します。

レイヤーマスクデータは利用可能ですか？

Layer.LayerMaskData には機能するゲッターがありますが、この FOSS ビルドではセッターが NotSupportedException をスローします。

参照

• Core API の操作
• Aspose.PSD FOSS for .NET — よくある質問
• Aspose.PSD FOSS for .NET 開発者ガイド
• Aspose.PSD for .NET — Enterprise Knowledge Base