PSDファイルを使用してAPI経由でラスターレイヤーマスクを編集する

概要

Adobe® Photoshop®を使用せずにPSD形式の編集とPSDファイルの変更を自動化するには、以下で提供されるAspose.PSD APIを使用できます。PSDファイルを変更するのに役立つC#および.NETコードスニペットがあります。

Aspose.PSDでは、PSDのレイヤーマスクとベクトルマスクを使用して、レイヤーピクセルを永久的に削除することなく非表示および表示することができます。ラスターマスクはレイヤーマスクまたはユーザーマスクとも呼ばれます。Aspose.PSDでのラスターマスクとベクトルマスクの両方へのアクセスは、LayerMaskDataレイヤープロパティを介して提供され、これは’LayerMaskData’クラスの抽象クラスの子クラスである'LayerMaskDataShort‘および’LayerMaskDataFull‘クラスのインスタンスである可能性があります。レイヤーにラスターマスクとベクトルマスクの両方がある場合、LayerMaskDataFullインスタンスが提供されます。レイヤーにラスターマスクまたはベクトルマスクのみが含まれる場合、LayerMaskDataShortインスタンスが提供されます。LayerMaskDataプロパティがnullの場合、レイヤーにマスクがないか、無効になっているベクトルマスクのみがあります。

todo:image_alt_text

ラスターマスクおよび無効なベクトルマスク LayerMaskDataShort

無効なラスターマスク LayerMaskDataShort

ラスターマスクおよびベクトルマスク LayerMaskDataFull

ラスターマスク LayerMaskDataShort

ベクトルマスク LayerMaskDataShort

無効なベクトルマスク(ただし、ベクトルリソースが存在する)

PSDファイル内のレイヤーラスターマスクを取得する方法

まず、レイヤーがベクトルマスクとレイヤーマスクの両方を持っているかどうかを調べる必要があります。

以下に示すサンプルコードは、レイヤーラスターマスクを取得する方法を示しています。

それ以外の場合、LayerMaskDataレイヤープロパティのタイプはLayerMaskDataShortです。この場合、Flagsプロパティをチェックしてレイヤーにラスターマスクのみがあるかどうかを確認します。FlagsプロパティはLayerMaskFlagsを含んでいてはならず、そうでない場合はマスクがベクトルマスクキャッシュである可能性があります。

マスクコードスニペットの取得:

両方のマスクが存在する場合でも、LayerMaskDataFullを抽出し、LayerMaskDataShortに変換してラスターマスクを抽出する必要があります。次のコードはどちらの場合にも使用できます。

PSDからラスターマスクを抽出する

PSDファイル内のレイヤーにラスターマスクがあるかどうかを確認する方法

次のC#コードは、レイヤーにラスターマスクがあるかどうかを確認するのに役立つかもしれません:

ラスターマスクが適用されているかどうかを知る方法 PSDレイヤー

PSDファイル内のレイヤーラスターマスクを削除/追加/更新する方法

正しく保存するには、単にLayerMaskDataを削除/追加/更新しても十分ではありません。チャネルが更新されないため,正しいレンダリングは可能かもしれませんが,これによりマスクチャネルは変更されません。

削除/追加/更新するために、レイヤーにAddLayerMaskメソッドを使用する必要があります。

これにより、マスクとチャネルの両方が追加/更新されます。

これにより、マスクとチャネルの両方が削除されます。

これにより、マスクとチャネルの両方が削除されます。

PSDイメージ内のレイヤーラスターマスクを削除する

まず、マスクが短いフォーマットにあるかどうかをチェックし、ベクトルではない場合は、ラスターマスクを削除するためにnullを渡してAddLayerMaskメソッドを呼び出すことができます。ただし、フルフォーマットの場合は、フルフォーマットに変換してベクトルマスクのみを残す必要があります。このため、次のC# .NETコードスニペットを使用してレイヤーマスクを削除する方法を示します:

PSDファイルからレイヤーマスクを削除するコードスニペット。

PSDイメージ内のレイヤーラスターマスクを更新する

これは直接的です:マスクが短いフォーマットにある場合は、ImageDataとMaskRectangleを必要に応じて変更する必要があります。それ以外の場合は、UserMaskDataおよびUserMaskRectangleを変更する必要があります。次のC# .NETコードスニペットは、レイヤーマスクを更新するために使用できます:

C#でPSDレイヤーマスクを更新する

以下は、ラスターマスクを変更する可能性のある例です。これは、レイヤーユーザーマスクを反転させます。

C#でPSDレイヤーマスクを更新する

PSDファイル内のレイヤーラスターマスクが存在する場合のベクトルマスクの更新方法

ユーザーが既にベクトルパスリソースを変更していると想定されます。その後、AddLayerMaskレイヤーメソッドを呼び出すだけで、ベクトルマスクを更新することができます。

C#でPSDレイヤーのベクトルマスクを更新する

PSDファイルにレイヤーラスターマスクを追加する

マスクがない場合は、AddLayerMaskレイヤーメソッドを単純に呼び出すことで、指定されたラスターマスクを追加できます。

マスクにUserMaskFromRenderingOtherData**フラグがない場合、既にラスターマスクが含まれているため、上記のように更新する必要があります。そうでない場合は、短いフォーマットからフルフォーマットに変換します。そうでない場合はそのまま使用します。次のC# .NETコードスニペットは、レイヤーマスクを追加(更新)するために使用できます:

PSDに新しいレイヤーマスクを追加する

レイヤーマスクが有効かどうかを確認する方法

レイヤーラスターマスクの有効状態を見つけるには、LayerMaskDataShortのFlagsプロパティまたはLayerMaskDataFullのRealFlagsでLayerMaskFlags.Disabledフラグの状態をチェックすることができます。レイヤーマスクの有効状態を取得するために使用できる次のC# .NETコードスニペットは次のとおりです:

マスクが有効かどうかを確認する:

ラスターレイヤーマスクを有効または無効にする方法

レイヤーラスターマスクを有効または無効にするには、LayerMaskDataShortのFlagsプロパティまたはLayerMaskDataFullのRealFlagsでLayerMaskFlags.Disabledフラグの状態を変更することができます。次のC# .NETコードスニペットは、レイヤーマスクの有効状態を変更するために使用できます:

ラスターレイヤーマスクの有効または無効化: