Features
Funzionalità
Aspose.PSD FOSS per Python carica, ispeziona e salva documenti PSD e PSB senza renderizzare i dati pixel. Il set di funzionalità è organizzato in diverse aree, ognuna trattata nella propria guida.
Caricamento, Ispezione e Salvataggio del Documento
PsdImage.load() carica un documento da un percorso file o da uno stream; PsdImage.save() lo riscrive. PsdImage espone l’intestazione analizzata (width, height, color_mode, compression, e altro) e le risorse immagine analizzate. Vedi Core API per il riferimento completo.
Sezioni del Documento
Oltre all’intestazione di livello superiore, PsdImage espone riepiloghi di sola lettura per le sezioni dei dati colore e dei dati immagine. Vedi Sections per il riferimento completo.
Metadati del Livello
Ogni analizzato Layer espone la sua geometria, visibilità, opacità, ritaglio e modalità di fusione, oltre ai metadati di canale, maschera e intervallo di fusione. Un sottoinsieme delle proprietà del livello può essere modificato e salvato nuovamente; la collezione di livelli stessa può essere riassegnata. Vedi Layers per il riferimento completo.
Risorse immagine
PsdImage espone i blocchi di risorse immagine di un documento in due forme, oltre a un riepilogo separato per le tavolozze di colore indicizzate. Vedi Resources per il riferimento completo.
Gestione degli errori
I fallimenti di caricamento e salvataggio sono segnalati tramite PsdLoadException and PsdSaveException, entrambi estendono lo standard Exception classe. Vedi Eccezioni Core per il riferimento completo.
Scrittura dei documenti in uscita
PsdImage.save() è il singolo punto di ingresso pubblico per scrivere un documento su un percorso file o stream. Vedi Descrittori di scrittura per il riferimento completo.
Conversione di byte grezzi
BigEndianBitConverter decodifica interi big-endian da byte grezzi ottenuti da te — ad esempio, da una risorsa immagine non riconosciuta. Vedi Conversion per il riferimento completo.
Cosa non è supportato
Questa libreria non rende dati pixel e non converte PSD/PSB in altri formati immagine (come PNG o JPEG). È un lettore e scrittore incentrato sui metadati per il formato contenitore PSD/PSB.
Suggerimenti e migliori pratiche
- Inizia con Core API per caricare, ispezionare e salvare un documento.
- Usa Layers quando hai bisogno di leggere o modificare i metadati di singoli layer.
- Wrap
load()/save()chiamate nella gestione delle eccezioni descritta in Eccezioni Core.
Problemi comuni
| Problema | Causa | Correzione |
|---|---|---|
| Output pixel renderizzato atteso | Questa libreria è solo per metadati | Usa una libreria diversa per il rendering; questa carica, ispeziona e salva solo i metadati PSD/PSB |
FAQ
Questa libreria rende o converte file PSD?
No. Carica, ispeziona e salva solo documenti PSD/PSB — non rende i dati dei pixel né converte in altri formati immagine.
Da dove inizio?
Nucleo API per il PsdImage punto di ingresso, poi Layers per i metadati a livello di layer, e Eccezioni principali per la gestione degli errori.
API Reference Riepilogo
| Area | Coperto In |
|---|---|
| Caricamento, ispezione e salvataggio del documento | Core API |
| Sezioni del documento (intestazione, dati colore, dati immagine) | Sections |
| Metadati del layer | Layers |
| Risorse immagine | Resources |
| Gestione degli errori di caricamento/salvataggio | Eccezioni di base |
| Scrittura di documenti | Descrittori di scrittura |
| Conversione di byte grezzi | Conversion |
