Features
Recursos
Aspose.PSD FOSS para Python carrega, inspeciona e salva documentos PSD e PSB sem renderizar dados de pixel. O conjunto de recursos está organizado em várias áreas, cada uma abordada em seu próprio guia.
Carregamento, Inspeção e Salvamento de Documentos
PsdImage.load() carrega um documento a partir de um caminho de arquivo ou fluxo; PsdImage.save() escreve-o de volta. PsdImage expõe o cabeçalho analisado (width, height, color_mode, compression, e mais) e os recursos de imagem analisados. Veja Core API para a referência completa.
Seções do Documento
Além do cabeçalho de nível superior, PsdImage expõe resumos somente leitura para as seções de dados de cor e de dados de imagem. Veja Sections para a referência completa.
Metadados da Camada
Cada analisado Layer expondo sua geometria, visibilidade, opacidade, recorte e modo de mesclagem, além de metadados de canal, máscara e intervalo de mesclagem. Um subconjunto das propriedades da camada pode ser alterado e salvo novamente; a própria coleção de camadas pode ser reatribuída. Veja Layers para a referência completa.
Recursos de Imagem
PsdImage expondo os blocos de recursos de imagem de um documento em duas formas, além de um resumo separado para paletas de cores indexadas. Veja Resources para a referência completa.
Tratamento de Erros
Falhas ao carregar e salvar são relatadas através de PsdLoadException and PsdSaveException, ambos estendendo o padrão Exception classe. Veja Exceções Principais para a referência completa.
Gravando Documentos de Volta
PsdImage.save() é o único ponto de entrada público para gravar um documento em um caminho de arquivo ou fluxo. Veja Descritores de Escrita para a referência completa.
Conversão de Bytes Brutos
BigEndianBitConverter decodifica inteiros big-endian a partir de bytes brutos que você mesmo obteve — por exemplo, de um recurso de imagem não reconhecido. Veja Conversion para a referência completa.
O que não é suportado
Esta biblioteca não renderiza dados de pixels e não converte PSD/PSB para outros formatos de imagem (como PNG ou JPEG). É um leitor e gravador focado em metadados para o formato de contêiner PSD/PSB.
Dicas e Melhores Práticas
- Comece com Core API para carregar, inspecionar e salvar um documento.
- Use Layers quando precisar ler ou editar metadados de camada individuais.
- Wrap
load()/save()chamadas no tratamento de exceções descrito em Core Exceptions.
Problemas comuns
| Problema | Causa | Correção |
|---|---|---|
| Esperando saída de pixel renderizada | Esta biblioteca é apenas de metadados | Use uma biblioteca diferente para renderização; esta apenas carrega, inspeciona e salva metadados PSD/PSB |
FAQ
Esta biblioteca renderiza ou converte arquivos PSD?
Não. Ela carrega, inspeciona e salva apenas documentos PSD/PSB — não renderiza dados de pixel nem converte para outros formatos de imagem.
Por onde eu começo?
Núcleo API para o PsdImage ponto de entrada, então Layers para metadados em nível de camada, e Exceções Principais para tratamento de erros.
API Reference Resumo
| Area | Coberto em |
|---|---|
| Carregamento, inspeção e salvamento de documentos | Núcleo API |
| Seções do documento (cabeçalho, dados de cor, dados de imagem) | Sections |
| Metadados da camada | Layers |
| Recursos de imagem | Resources |
| Manipulação de erros de carregamento/salvamento | Exceções do Núcleo |
| Escrevendo documentos | Escreva descritores |
| Conversão de bytes bruta | Conversion |
