Features
Fonctionnalités
Aspose.PSD FOSS for Python charge, inspecte et enregistre les documents PSD et PSB sans rendre les données de pixels. L’ensemble des fonctionnalités est organisé en plusieurs domaines, chacun couvert dans son propre guide.
Chargement, inspection et enregistrement du document
PsdImage.load() charge un document depuis un chemin de fichier ou un flux; PsdImage.save() le réécrit. PsdImage expose l’en-tête analysé (width, height, color_mode, compression, et plus) et les ressources d’image analysées. Voir Core API pour la référence complète.
Sections du document
Au-delà de l’en-tête de niveau supérieur, PsdImage expose des résumés en lecture seule pour les sections de données couleur et de données image. Voir Sections pour la référence complète.
Métadonnées de calque
Chaque analysé Layer expose sa géométrie, sa visibilité, son opacité, son découpage et son mode de fusion, ainsi que les métadonnées de canal, de masque et de plage de fusion. Un sous-ensemble des propriétés du calque peut être modifié et enregistré à nouveau ; la collection de calques elle-même peut être réassignée. Voir Layers pour la référence complète.
Ressources d’image
PsdImage expose les blocs de ressources d’image d’un document sous deux formes, ainsi qu’un résumé séparé des palettes de couleurs indexées. Voir Resources pour la référence complète.
Gestion des erreurs
Les échecs de chargement et d’enregistrement sont signalés via PsdLoadException and PsdSaveException, tous deux étendant la norme Exception classe. Voir Exceptions de base pour la référence complète.
Écriture des documents en sortie
PsdImage.save() est le point d’entrée public unique pour écrire un document vers un chemin de fichier ou un flux. Voir Descripteurs d’écriture pour la référence complète.
Conversion d’octets bruts
BigEndianBitConverter décode les entiers big-endian à partir d’octets bruts que vous avez obtenus vous-même — par exemple, à partir d’une ressource d’image non reconnue. Voir Conversion pour la référence complète.
Ce qui n’est pas pris en charge
Cette bibliothèque ne rend pas les données de pixels et ne convertit pas PSD/PSB en d’autres formats d’image (comme PNG ou JPEG). C’est un lecteur et un écrivain axés sur les métadonnées pour le format de conteneur PSD/PSB.
Conseils et bonnes pratiques
- Commencez par Core API pour charger, inspecter et enregistrer un document.
- Utilisez Layers lorsque vous devez lire ou modifier les métadonnées d’une couche individuelle.
- Wrap
load()/save()appels dans la gestion des exceptions décrite dans Exceptions du noyau.
Problèmes courants
| Problème | Cause | Correction |
|---|---|---|
| Attente d’une sortie pixel rendue | Cette bibliothèque ne contient que des métadonnées | Utilisez une autre bibliothèque pour le rendu ; celle-ci se contente de charger, inspecter et enregistrer les métadonnées PSD/PSB |
FAQ
Cette bibliothèque rend-elle ou convertit-elle les fichiers PSD?
Non. Elle charge, inspecte et enregistre uniquement les documents PSD/PSB — elle ne rend pas les données pixels ni ne convertit vers d’autres formats d’image.
Par où commencer?
Core API pour le PsdImage point d’entrée, puis Layers pour les métadonnées au niveau de la couche, et Exceptions de base pour la gestion des erreurs.
API Reference Résumé
| Area | Couvert dans |
|---|---|
| Chargement, inspection et enregistrement du document | Core API |
| Sections du document (en-tête, données de couleur, données d’image) | Sections |
| Métadonnées de calque | Layers |
| Ressources d’image | Resources |
| Gestion des erreurs de chargement/enregistrement | Exceptions du noyau |
| Écriture de documents | Écrire des descripteurs |
| Conversion d’octets bruts | Conversion |
