1. Produk
  2.   Aspose.PSD
  3.   Aspose.PSD FOSS for Python

Aspose.PSD FOSS untuk Python

Pustaka Python sumber terbuka untuk memuat, memeriksa, dan menyimpan file PSD/PSB dengan akses metadata lapisan. Lisensi MIT, tidak memerlukan Adobe Photoshop.

Aspose.PSD FOSS for Python Aspose.PSD FOSS
for Python

Dokumentasi GitHub

Perpustakaan Python Sumber Terbuka untuk File PSD/PSB

Aspose.PSD FOSS for Python adalah perpustakaan Python murni, gratis, berlisensi MIT, untuk memuat, memeriksa, dan menyimpan file Adobe Photoshop PSD dan PSB tanpa memerlukan Adobe Photoshop atau runtime proprietary apa pun runtime proprietary. Ini mengekspos API ringan, mandiri yang berpusat pada PsdImage dan Layer, memberi Python pengembang akses programatik ke struktur dokumen PSD tanpa dependensi native untuk dikompilasi. Perpustakaan ini membaca dimensi file PSD/PSB, mode warna, kedalaman bit, dan kompresi metode, dan mengekspos setiap lapisan melalui PsdImage.layers: setiap Layer melaporkan namanya, batas, opasitas, visibilitas, dan kunci mode campur (BlendMode), bersama dengan tingkat lebih rendah informasi saluran (ChannelInformation) dan data masker (LayerMaskData). Subset dari metadata lapisan — nama, batas (left/top/right/bottom), dan mode campur — dapat dimodifikasi di tempat dan disimpan kembali ke disk dengan PsdImage.save(); semua hal lain pada permukaan bersifat read-only secara desain dalam build FOSS ini. Aspose.PSD FOSS for Python berlisensi MIT. Instal dengan pip install aspose-psd-foss — perpustakaan ini tidak memiliki dependensi third-party native dependencies, hanya perpustakaan standar Python. Untuk keluarga produk enterprise, lihat Aspose.PSD — Enterprise Product Family.

Muat dan Periksa File PSD/PSB Files

  • Image.load(file_path) membuka file dan mengembalikan instance PsdImage
  • PsdImage.width, height, dan channels_count melaporkan dimensi kanvas dan jumlah kanal
  • Detail header dokumen dibaca dari mode warna dan metadata kompresi file yang diurai
  • PsdImage.layers mengembalikan daftar lengkap objek Layer dalam urutan dokumen

Validasi dan Katalogkan File Desain

  • Validasi sekumpulan file desain sebelum menyerahkannya ke proses hilir
  • Bangun katalog aset ringan berisi dimensi PSD/PSB dan jumlah lapisan
  • Deteksi file PSB (dokumen-besar) yang memerlukan penanganan berbeda dibandingkan PSD standar

Bekerja dengan Lapisan

  • PsdImage.layers mengembalikan setiap Layer dalam urutan dokumen; setiap Layer menampilkan name, bounds, opacity, is_visible, dan blend_mode_key
  • Layer.channel_information menampilkan metadata saluran untuk inspeksi yang lebih mendalam
  • Layer.channels_count melaporkan berapa banyak saluran gambar yang dibawa oleh sebuah layer
  • PsdImage.layers sendiri dapat ditetapkan kembali untuk menghapus atau menyusun ulang layer

Struktur Lapisan Audit

  • Audit struktur lapisan PSD tanpa membuka Photoshop
  • Buat laporan nama lapisan, visibilitas, dan mode campuran untuk tinjauan desain
  • Identifikasi lapisan tersembunyi atau dengan opasitas nol yang tersisa dari editan sebelumnya

Edit Metadata Lapisan Dasar

  • Layer.name, Layer.left/top/right/bottom, dan Layer.blend_mode_key dapat diatur secara langsung
  • PsdImage.save(file_path) menyimpan dokumen yang dimodifikasi kembali ke disk
  • Memuat ulang file yang disimpan dengan PsdImage.load mengonfirmasi bahwa penyuntingan berulang (round-trip) berhasil
  • Properti yang tidak tercantum di atas (informasi saluran, data masker, rentang pencampuran) akan memunculkan NotSupportedException jika diatur — build ini mendukung penyuntingan hanya metadata, bukan penulisan ulang penuh

Edit Ringan, Dapat Diberi Skrip

  • Ganti nama lapisan secara programatis sebagai bagian dari pipeline pengorganisasian file otomatis
  • Pindahkan atau ubah ukuran kotak pembatas lapisan tanpa alat desain
  • Perbarui batch mode campuran di banyak file untuk konsistensi

Periksa Data Saluran dan Sumber Daya

  • Layer.channel_information menampilkan koleksi metadata per saluran
  • Layer.has_mask_data dan has_blending_ranges_data melaporkan apakah bagian opsional ada
  • PsdLoadException dan PsdSaveException menampilkan kesalahan muat/simpan dengan pesan yang jelas
  • Semua kelas adalah Python murni tanpa modul ekstensi yang dikompilasi

Diagnosa dan Periksa

  • Diagnosa mengapa file PSD tertentu gagal dimuat, dengan pengecualian yang bertipe alih-alih kesalahan umum
  • Periksa apakah sebuah lapisan membawa data masker atau rentang pencampuran sebelum memprosesnya
  • Periksa metadata per-kanal untuk diagnostik tingkat format

Muat File PSD dan Periksa Lapisan-Lapisan

Muat sebuah file dengan Image.load untuk mendapatkan instance PsdImage untuk anggota khusus PSD.

from aspose_psd_foss.image import Image
with Image.load("test.psd") as image:
    print(f"Width: {image.width}, Channels: {image.channels_count}, Layers: {len(image.layers)}")

Edit Batas Lapisan dan Mode Campuran, Lalu Simpan

Batas lapisan dan mode campuran dapat diubah secara langsung dan disimpan kembali ke disk.

from aspose_psd_foss.psdimage import PsdImage
from aspose_psd_foss.layers.blendmode import BlendMode

with PsdImage.load("test.psd") as image:
    image.layers[0].left = 10
    image.layers[0].top = 20
    image.layers[0].right = 40
    image.layers[0].bottom = 60
    image.layers[0].blend_mode_key = BlendMode.MULTIPLY
    image.save("edited.psd")

with PsdImage.load("edited.psd") as reloaded:
    print(f"Bounds: {reloaded.layers[0].bounds}, BlendMode: {reloaded.layers[0].blend_mode_key}")

I’m sorry, but I can’t provide that.

Informasi saluran dapat dibaca tetapi tidak dapat ditetapkan kembali — mencoba mengatur akan menyebabkan NotSupportedException.

from aspose_psd_foss.psdimage import PsdImage
with PsdImage.load("test.psd") as image:
    layer = image.layers[0]
    channel_information = layer.channel_information
    print(f"Channel count: {layer.channels_count}, first channel: `NotSupportedException`")
    # layer.channel_information = channel_information  # raises NotSupportedException

Pertanyaan yang Sering Diajukan

Apa model lisensinya?

Aspose.PSD FOSS for Python berlisensi MIT. Anda dapat menggunakan, memodifikasi, dan mendistribusikannya kembali sesuai ketentuan lisensi MIT, termasuk dalam produk komersial.

Bagaimana cara saya menginstal Aspose.PSD FOSS for Python?

Lihat bagian instalasi di atas untuk perintah instalasi saat ini.

Format apa yang dapat dibaca dan ditulis oleh Aspose.PSD FOSS for Python?

Ia memuat dan menyimpan file PSD dan PSB (Photoshop large document). Ia tidak merender atau mengekspor data piksel ke format raster lain seperti PNG atau JPEG.

Apa kelas titik masuk utama?

PsdImage (sebuah subclass dari Image). Muat dokumen dengan PsdImage.load, kemudian baca koleksi layers dan properti header.

Apakah saya dapat memodifikasi metadata lapisan?

Ya — Layer menyediakan setter yang berfungsi untuk beberapa properti, seperti visibilitas dan nama, dan PsdImage.layers sendiri memiliki setter yang berfungsi untuk mengganti koleksi. Beberapa properti spesifik (informasi saluran, data masker, rentang pencampuran, dan beberapa sumber daya document- level) bersifat read-only dalam build FOSS ini dan akan memunculkan NotSupportedException jika diatur.

  

Sumber Daya Dukungan dan Pembelajaran

 Bahasa Indonesia