Features
機能
Aspose.PSD は Python 用のFOSSで、PSDおよびPSBドキュメントをピクセルデータをレンダリングせずに読み込み、検査し、保存します。機能セットは複数の領域に整理されており、それぞれが独自のガイドでカバーされています。
ドキュメントの読み込み、検査、保存
PsdImage.load() ファイルパスまたはストリームからドキュメントをロードします; PsdImage.save() それを書き戻します。 PsdImage 解析されたヘッダーを公開します (width, height, color_mode, compression, さらに) と解析された画像リソースを公開します。参照 Core API 完全なリファレンスをご参照ください。
ドキュメントセクション
トップレベルヘッダーの先に、 PsdImage カラー データと画像 データセクションの読み取り専用サマリーを公開します。参照 Sections 完全なリファレンスについては。
レイヤーメタデータ
各解析された Layer ジオメトリ、可視性、不透明度、クリッピング、ブレンドモードに加えて、チャンネル、マスク、ブレンド範囲メタデータを公開します。レイヤー属性のサブセットは変更して再保存でき、レイヤーコレクション自体を再割り当てできます。参照: Layers 完全なリファレンスについては。
画像リソース
PsdImage 文書の画像リソースブロックを2つの形式で公開し、インデックスカラー パレット用の別個のサマリーも提供します。参照: Resources 完全なリファレンスについては。
エラー処理
ロードおよび保存の失敗は、~を通じて報告されます PsdLoadException and PsdSaveException、どちらも標準を拡張します。 Exception クラスです。参照 コア例外 完全なリファレンスについては。
ドキュメントの書き戻し
PsdImage.save() は、ドキュメントをファイルパスまたはストリームに書き込むための唯一の公開エントリーポイントです。参照 書き込みディスクリプタ 完全なリファレンスについては。
生バイト変換
BigEndianBitConverter 取得した生バイトからビッグエンディアン整数をデコードします — たとえば、認識できない画像リソースからです。参照 Conversion 完全なリファレンスについては。
サポートされていない項目
このライブラリはピクセルデータをレンダリングせず、PSD/PSB を他の画像フォーマット(PNG や JPEG など)に変換もしません。PSD/PSB コンテナ形式のメタデータに特化したリーダー兼ライターです。
ヒントとベストプラクティス
- 最初に Core API ドキュメントの読み込み、検査、保存のために。
- 使用する Layers 個々のレイヤーメタデータを読み取ったり編集したりする必要がある場合に。
- Wrap
load()/save()例外処理で記述されている呼び出しは Core 例外.
一般的な問題
| 問題 | 原因 | 修正 |
|---|---|---|
| レンダリングされたピクセル出力を期待 | このライブラリはメタデータのみです | レンダリングには別のライブラリを使用してください。このライブラリは PSD/PSB メタデータの読み込み、検査、保存のみを行います |
FAQ
このライブラリは PSD ファイルをレンダリングまたは変換しますか?
いいえ。PSD/PSB ドキュメントのみをロード、検査、保存します — ピクセルデータをレンダリングしたり、他の画像形式に変換したりはしません。
どこから始めればよいですか?
コア API のための PsdImage エントリーポイント、次に Layers レイヤーレベルのメタデータ用、そして コア例外 エラー処理用。
API Reference 概要
| Area | 対象 |
|---|---|
| ドキュメントの読み込み、検査、保存 | コア API |
| ドキュメントセクション(ヘッダー、カラーデータ、イメージデータ) | Sections |
| レイヤーメタデータ | Layers |
| イメージリソース | Resources |
| ロード/保存エラー処理 | コア例外 |
| 文書の作成 | ディスクリプタの作成 |
| 生バイト変換 | Conversion |