Scrivi Descrittori

PsdImage.save è il singolo punto di ingresso pubblico per scrivere nuovamente un documento — accetta sia un percorso file sia un flusso scrivibile già aperto. Il writer di sezione a basso livello che esegue la codifica effettiva dei byte è un dettaglio di implementazione interno, non qualcosa che si chiama direttamente.

Salvataggio su un Percorso File o Stream

from aspose_psd_foss.psdimage import PsdImage

image = PsdImage.load(input_path)
image.save("output.psd")

Passare un flusso invece di un percorso lascia il flusso aperto successivamente — controlli tu quando chiuderlo:

with open("output.psd", "wb") as stream:
    image.save(stream)

Scelta del Formato Contenitore

Non esiste alcun API pubblico per scegliere il formato del contenitore di output al momento del salvataggio — un salvataggio rispecchia sempre il formato (is_large_document / is_psb) con cui il documento è stato caricato. Non esiste alcun percorso di conversione supportato tra PSD e PSB in questa build FOSS.

Suggerimenti e Buone Pratiche

Chiama save prima di eliminare l’immagine — save su un PsdImage eliminato genera RuntimeError.
Il writer interno a livello di sezione invocato da save non è un punto di ingresso documentato o supportato da solo; passa sempre attraverso PsdImage.save.

Problemi comuni

Problema	Causa	Correzione
`RuntimeError: PsdImage has been disposed.`	`save` è stato chiamato dopo `dispose()` (o dopo l’uscita da un blocco `with`)	Chiama `save` prima di rilasciare l’immagine
`PsdSaveException` sulla lunghezza di una stringa Pascal	Un valore di stringa supera i 255 byte	Vedi Core Eccezioni

FAQ

Il salvataggio su uno stream chiude lo stream successivamente?

No — passare uno stream a save lo lascia aperto successivamente, così ne controlli il ciclo di vita. Il salvataggio su un percorso file, al contrario, apre e chiude il file internamente.

Posso creare un file PSB da un documento caricato come PSD?

No — non esiste alcun API pubblico per sovrascrivere il formato del contenitore al salvataggio; rispecchia sempre il formato originale del documento caricato.

API Reference Riepilogo

Classe/Metodo	Descrizione
`PsdImage.save(file_path)` / `PsdImage.save(stream)`	Salva il documento

Scrivi Descrittori