Michael JohnsonUm PSD pode abrir em um editor e, ainda assim, ter uma aparência diferente: a divergência pode afetar uma máscara, o texto, um efeito de camada ou a ordem de sobreposição. Uma maneira de verificar o resultado é comparar a composição reconstruída com a imagem achatada incorporada no próprio PSD. Lançado em 11 de outubro de 2026, o PhotoCraft v0.7.0 permite examinar essa abordagem de engenharia usando como exemplo um editor gráfico de código aberto escrito em Rust.
O lançamento lista mudanças em pincéis, seleção, máscaras, importação de OpenRaster e outras partes do editor. Para quem desenvolve software, a documentação publicada pelo projeto é especialmente interessante: ela descreve testes de importação de PSD, comparações entre compositores e um conjunto de arquivos usado para verificações reproduzíveis.
O PSD contém uma referência para comparação
Um PSD em camadas contém a estrutura de camadas e uma imagem achatada do documento. O PhotoCraft renderiza as camadas e, em seguida, compara o resultado com essa composição incorporada. Esse teste verifica o quanto o programa reproduz fielmente a aparência do documento ao processar texto, ajustes, efeitos e outros recursos do formato.
Na descrição da arquitetura do PhotoCraft, essa abordagem é chamada de “oráculo do compositor”. A documentação de testes lista três conjuntos de arquivos PSD: 256 arquivos criados pela equipe no Photoshop, 170 arquivos dos conjuntos psd-tools e ag-psd, além de um conjunto separado de 309 arquivos do psd-tools. Os conjuntos são baixados em versões fixadas e verificados por somas de verificação.
Para quem desenvolve formatos, é útil separar os testes conforme a pergunta que respondem. A análise da estrutura mostra se o documento pôde ser lido; o teste de abrir e salvar verifica se os dados foram preservados; a comparação da composição avalia a precisão da reprodução visual. A documentação do PhotoCraft lista tanto verificações de estabilidade byte a byte para arquivos inalterados quanto comparações com a composição incorporada no PSD.
O compositor de CPU funciona como implementação de referência
O projeto descreve o compositor de CPU como o caminho de referência para exportações e testes; o compositor de GPU, baseado em wgpu, executa o mesmo plano de operações na tela de edição. A documentação da arquitetura afirma que os resultados são comparados com uma tolerância de até 1/255 para saída de 8 bits e que a verificação entre CPU e GPU é executada na CI, inclusive com um adaptador gráfico de software.
A GPU é necessária para a tela interativa, mas a disponibilidade do caminho de hardware depende do documento e do ambiente. O guia informa que documentos multicanais e áreas que excedem o limite de textura são processados pelo compositor de CPU; se o dispositivo de GPU falhar, a tela também passa a usar a CPU. Essas são condições concretas para alternar entre os caminhos, não uma afirmação de que a velocidade será a mesma em qualquer dispositivo.
Esse padrão geral também se aplica a outros sistemas computacionais: manter uma implementação de referência verificável ao lado do caminho otimizado e executá-los com as mesmas entradas. Em um banco de dados, isso pode significar um interpretador simples ao lado de um mecanismo otimizado; no processamento de mídia, um caminho de software ao lado da aceleração por hardware. A comparação revela divergências nos resultados; ela se torna reproduzível quando as entradas e o critério de diferença aceitável estão definidos.
Como transformar a abordagem em testes práticos
- Monte um conjunto pequeno e diversificado. Inclua arquivos com máscaras, texto, grupos, transparência, efeitos e modos de cor. Registre a origem dos arquivos e as versões do conjunto para que as execuções futuras usem as mesmas entradas.
- Escolha uma referência e uma tolerância. Para PSD, é possível comparar o resultado com a composição achatada incorporada. Defina a margem de erro aceitável e teste separadamente dimensões, perfil de cor e canal alfa, se forem importantes para seu aplicativo.
- Separe importação, salvamento e renderização. Testes independentes podem verificar a análise das camadas, a reabertura após salvar e a correspondência entre a imagem e a referência. Assim, fica mais fácil identificar em que etapa ocorreu o erro.
- Execute os mesmos casos em diferentes back-ends. Compare os resultados de CPU e GPU nos mesmos documentos, incluindo testes nos limites dos blocos e com efeitos. Guarde as entradas e as diferenças visuais para que seja possível reproduzir uma regressão.
- Registre as condições das medições de desempenho. Informe o tamanho do documento, o número de camadas, o hardware e o estado do cache. A documentação do PhotoCraft inclui comandos para testes específicos e para comparar compositores; as medições apresentadas correspondem a configurações e cenários concretos.
O guia de desenvolvimento do PhotoCraft descreve comandos para verificar conjuntos de PSD, diferenças visuais e o comportamento dos diferentes caminhos de composição. Ele pode servir como ponto de partida concreto para explorar a infraestrutura de testes do editor; os números de desempenho da documentação devem ser considerados junto com as entradas e a configuração de hardware ali especificadas.
O que o exemplo do PhotoCraft demonstra
O lançamento do PhotoCraft v0.7.0 reúne mudanças no próprio editor, enquanto a documentação do projeto revela uma prática de engenharia específica: usar PSDs de referência para verificar a composição e uma implementação de CPU para comparar com o caminho de GPU. Para quem desenvolve editores, conversores e outras ferramentas para arquivos complexos, a conclusão é simples: teste separadamente a leitura, o salvamento e o resultado visual; compare as implementações aceleradas com uma versão de referência usando entradas fixadas. Assim, compatibilidade e desempenho se tornam propriedades verificáveis do programa.