Features
Características
Aspose.PSD FOSS para Python carga, inspecciona y guarda documentos PSD y PSB sin renderizar datos de píxeles. El conjunto de características está organizado en varias áreas, cada una cubierta en su propia guía.
Carga, inspección y guardado de documentos
PsdImage.load() carga un documento desde una ruta de archivo o flujo; PsdImage.save() lo escribe de nuevo. PsdImage expone el encabezado analizado (width, height, color_mode, compression, y más) y los recursos de imagen analizados. Ver Core API para la referencia completa.
Secciones del documento
Más allá del encabezado de nivel superior, PsdImage expone resúmenes de solo lectura para las secciones de datos de color y datos de imagen. Ver Sections para la referencia completa.
Metadatos de capa
Cada analizado Layer expone su geometría, visibilidad, opacidad, recorte y modo de fusión, además de los metadatos de canal, máscara y rango de fusión. Un subconjunto de propiedades de capa puede modificarse y guardarse nuevamente; la propia colección de capas puede reasignarse. Ver Layers para la referencia completa.
Recursos de imagen
PsdImage expone los bloques de recursos de imagen de un documento en dos formas, además de un resumen separado para paletas de colores indexados. Ver Resources para la referencia completa.
Manejo de errores
Los fallos de carga y guardado se informan a través de PsdLoadException and PsdSaveException, ambos extendiendo el estándar Exception clase. Ver Excepciones principales para la referencia completa.
Escritura de documentos de salida
PsdImage.save() es el único punto de entrada público para escribir un documento en una ruta de archivo o flujo. Ver Descriptores de escritura para la referencia completa.
Conversión de bytes crudos
BigEndianBitConverter decodifica enteros big-endian a partir de bytes crudos que has obtenido tú mismo — por ejemplo, de un recurso de imagen no reconocido. Ver Conversion para la referencia completa.
Qué no se admite
Esta biblioteca no renderiza datos de píxeles y no convierte PSD/PSB a otros formatos de imagen (como PNG o JPEG). Es un lector y escritor centrado en los metadatos para el formato contenedor PSD/PSB.
Consejos y buenas prácticas
- Comienza con Core API para cargar, inspeccionar y guardar un documento.
- Usar Layers una vez que necesites leer o editar los metadatos de capas individuales.
- Wrap
load()/save()llamadas en el manejo de excepciones descrito en Excepciones principales.
Problemas comunes
| Problema | Causa | Corrección |
|---|---|---|
| Esperando salida de píxeles renderizada | Esta biblioteca es solo de metadatos | Utiliza una biblioteca diferente para renderizar; esta solo carga, inspecciona y guarda los metadatos de PSD/PSB metadata |
FAQ
¿Esta biblioteca renderiza o convierte archivos PSD?
No. Sólo carga, inspecciona y guarda documentos PSD/PSB — no renderiza datos de píxeles ni convierte a otros formatos de imagen.
¿Por dónde empiezo?
Núcleo API para el PsdImage punto de entrada, luego Layers para metadatos a nivel de capa, y Excepciones del Núcleo para el manejo de errores.
API Reference Resumen
| Area | Cubierto en |
|---|---|
| Carga, inspección y guardado de documentos | Núcleo API |
| Secciones del documento (encabezado, datos de color, datos de imagen) | Sections |
| Metadatos de capa | Layers |
| Recursos de imagen | Resources |
| Manejo de errores de carga/guardado | Excepciones del núcleo |
| Escritura de documentos | Escribir Descriptores |
| Conversión de Bytes Crudos | Conversion |
