Features
Fitur
Aspose.PSD FOSS untuk Python memuat, memeriksa, dan menyimpan dokumen PSD dan PSB tanpa merender data piksel. Set fitur ini diatur ke dalam beberapa area, masing-masing dibahas dalam panduannya sendiri.
Memuat Dokumen, Pemeriksaan, dan Penyimpanan
PsdImage.load() memuat dokumen dari jalur file atau aliran; PsdImage.save() menuliskannya kembali. PsdImage menyajikan header yang diurai (width, height, color_mode, compression, dan lainnya) serta sumber daya gambar yang diurai. Lihat Core API untuk referensi lengkap.
Bagian Dokumen
Di luar header tingkat atas, PsdImage menyajikan ringkasan hanya-baca untuk bagian data warna dan data gambar. Lihat Sections untuk referensi lengkap.
Metadata Lapisan
Setiap yang diparsing Layer mengekspos geometri, visibilitas, opasitas, pemotongan, dan mode campur, serta metadata saluran, masker, dan rentang pencampuran. Subset properti lapisan dapat diubah dan disimpan kembali; koleksi lapisan itu sendiri dapat ditetapkan ulang. Lihat Layers untuk referensi lengkap.
Sumber Daya Gambar
PsdImage mengekspos blok sumber daya gambar dokumen dalam dua bentuk, serta ringkasan terpisah untuk palet warna terindeks. Lihat Resources untuk referensi lengkap.
Penanganan Kesalahan
Kegagalan memuat dan menyimpan dilaporkan melalui PsdLoadException and PsdSaveException, keduanya memperluas standar Exception kelas. Lihat Pengecualian Inti untuk referensi lengkap.
Menulis Kembali Dokumen
PsdImage.save() adalah satu-satunya titik masuk publik untuk menulis dokumen ke jalur file atau aliran. Lihat Tulis Deskriptor untuk referensi lengkap.
Konversi Byte Mentah
BigEndianBitConverter mendekode integer big-endian dari byte mentah yang Anda peroleh sendiri — misalnya, dari sumber daya gambar yang tidak dikenali. Lihat Conversion untuk referensi lengkap.
Apa yang Tidak Didukung
Pustaka ini tidak merender data piksel dan tidak mengonversi PSD/PSB ke format gambar lain (seperti PNG atau JPEG). Ini adalah pembaca dan penulis yang berfokus pada metadata untuk format wadah PSD/PSB.
Tips dan Praktik Terbaik
- Mulai dengan Core API untuk memuat, memeriksa, dan menyimpan dokumen.
- Gunakan Layers setelah Anda perlu membaca atau mengedit metadata lapisan individu.
- Wrap
load()/save()panggilan dalam penanganan pengecualian yang dijelaskan dalam Pengecualian Inti.
Masalah Umum
| Masalah | Penyebab | Perbaikan |
|---|---|---|
| Mengharapkan output piksel yang di-render | Pustaka ini hanya metadata | Gunakan pustaka lain untuk rendering; yang satu ini hanya memuat, memeriksa, dan menyimpan metadata PSD/PSB |
FAQ
Apakah perpustakaan ini merender atau mengonversi file PSD?
Tidak. Ia memuat, memeriksa, dan menyimpan dokumen PSD/PSB saja — tidak merender data piksel atau mengonversi ke format gambar lain.
Di mana saya mulai?
Inti API untuk PsdImage titik masuk, kemudian Layers untuk metadata tingkat lapisan, dan Pengecualian Inti untuk penanganan kesalahan.
Ringkasan API Reference
| Area | Dicakup Dalam |
|---|---|
| Pemuatan dokumen, inspeksi, dan penyimpanan | Inti API |
| Bagian dokumen (header, data warna, data gambar) | Sections |
| Metadata lapisan | Layers |
| Sumber daya gambar | Resources |
| Penanganan kesalahan muat/simpan | Pengecualian Inti |
| Menulis dokumen | Tulis Deskriptor |
| Konversi byte mentah | Conversion |