Escribir Descriptores

Descriptores de Escritura

PsdImage.save es el único punto de entrada público para escribir un documento de nuevo — acepta ya sea una ruta del archivo o un flujo writable ya abierto. El escritor de secciones de bajo nivel que realiza la codificación real de bytes es un detalle de implementación interno, no algo que invoques directamente.

Guardar en una ubicación de archivo o en un flujo

from aspose_psd_foss.psdimage import PsdImage

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

Pasar un flujo en lugar de una ruta mantiene el flujo abierto después — tú controlas cuándo cerrarlo:

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

Seleccionar un Formato Contenedor

No existe un API público para elegir el formato contenedor de salida al guardar — la acción de guardado siempre refleja el formato (is_large_document / is_psb) con el que se cargó el documento. No hay una vía de conversión soportada entre PSD y PSB en esta compilación FOSS.

Consejos y Mejores Prácticas

Llame a save antes de descartar la imagen — save en un PsdImage descartado genera RuntimeError.
El escritor interno a nivel de sección invocado por save no es un punto de entrada documentado ni compatible por sí mismo; siempre pásese por PsdImage.save.

Problemas comunes

Problema	Causa	Solución
`RuntimeError: PsdImage has been disposed.`	`save` se llamó después de `dispose()` (o después de que saliera un bloque `with`)	Llame a `save` antes de liberar la imagen
`PsdSaveException` sobre la longitud de una cadena Pascal	Un valor de cadena supera los 255 bytes	Ver Excepciones del núcleo

FAQ

¿Guardar en un stream cierra el stream después?

No — pasar un stream a save lo deja abierto después, por lo que usted controla su ciclo de vida. Guardar en una ruta de archivo, en cambio, abre y cierra el archivo internamente.

¿Puedo generar un archivo PSB a partir de un documento cargado como PSD?

No — no existe un API público para sobrescribir el formato del contenedor al guardar; siempre refleja el formato propio del documento cargado.

API Reference Resumen

Clase/Método	Descripción
`PsdImage.save(file_path)` / `PsdImage.save(stream)`	Guarda el documento