Michael JohnsonUn archivo PSD puede abrirse en un editor y, aun así, verse distinto: la diferencia puede afectar a una máscara, un texto, un efecto de capa o el orden de superposición. Una forma de comprobar el resultado es comparar la composición reconstruida con la imagen acoplada integrada en el propio PSD. La publicación, el 11 de octubre de 2026, de PhotoCraft v0.7.0 ofrece la oportunidad de examinar este método de ingeniería con el ejemplo de un editor gráfico de código abierto escrito en Rust.
La versión enumera cambios en los pinceles, la selección, las máscaras, la importación de OpenRaster y otras partes del editor. Para quienes desarrollan software, resulta especialmente interesante la documentación publicada por el proyecto: describe pruebas de importación de PSD, la comparación de compositores y un corpus de archivos utilizado para realizar comprobaciones reproducibles.
El PSD contiene una referencia para comparar
Un PSD con capas contiene la estructura de capas y una imagen acoplada del documento. PhotoCraft renderiza las capas y después compara el resultado con esa composición integrada. Esta prueba verifica hasta qué punto el programa reproduce la apariencia del documento al procesar texto, ajustes, efectos y otras funciones del formato.
En la descripción de la arquitectura de PhotoCraft, este método se denomina «oráculo del compositor». La documentación de pruebas enumera tres corpus de archivos PSD: 256 archivos creados por el equipo en Photoshop, 170 archivos procedentes de los conjuntos psd-tools y ag-psd, y otro conjunto de psd-tools con 309 archivos. Los corpus se descargan de versiones fijadas y se verifican mediante sumas de comprobación.
A quienes desarrollan formatos les conviene separar las pruebas según la pregunta que respondan. El análisis de la estructura muestra si se ha podido leer el documento; la prueba del ciclo de apertura y guardado, si se han conservado los datos; y la comparación de la composición, hasta qué punto se ha reproducido fielmente el resultado visual. La documentación de PhotoCraft también enumera pruebas de estabilidad de bytes para archivos que no se han modificado y comparaciones con la composición integrada en el PSD.
El compositor de CPU sirve como implementación de referencia
El proyecto describe el compositor de CPU como la ruta de referencia para exportaciones y pruebas; el compositor de GPU, basado en wgpu, ejecuta el mismo plan de operaciones en el lienzo. La documentación de arquitectura indica que los resultados se comparan con una tolerancia de hasta 1/255 para una salida de 8 bits, y que la comprobación entre CPU y GPU se ejecuta en CI, incluso con un adaptador gráfico por software.
La GPU es necesaria para el lienzo interactivo, pero la disponibilidad de la ruta por hardware depende del documento y del entorno. La guía indica que los documentos multicanal y las áreas que superan el límite de textura se procesan con el compositor de CPU; si se pierde el dispositivo GPU, el lienzo también cambia a CPU. Estas son condiciones concretas para alternar entre rutas, no una afirmación de que la velocidad sea uniforme en cualquier dispositivo.
El patrón general también sirve para otros sistemas de computación: mantener una implementación de referencia verificable junto a la ruta optimizada y ejecutarlas con las mismas entradas. En una base de datos, podría ser un intérprete sencillo junto a un motor optimizado; en el procesamiento multimedia, una ruta por software junto a la aceleración por hardware. La comparación revela discrepancias en los resultados; se vuelve reproducible cuando se fijan las entradas y el criterio de diferencia aceptable.
Cómo convertir el método en pruebas prácticas
- Reúne un corpus pequeño y variado. Incluye archivos con máscaras, texto, grupos, transparencia, efectos y modos de color. Registra el origen de los archivos y las versiones del corpus para que las ejecuciones posteriores utilicen las mismas entradas.
- Elige una referencia y una tolerancia. Para PSD, puedes comparar el resultado con la composición acoplada integrada. Define el margen de error aceptable y comprueba por separado las dimensiones, el perfil de color y el canal alfa si son importantes para tu aplicación.
- Separa la importación, el guardado y el renderizado. Las pruebas independientes pueden comprobar el análisis de las capas, la reapertura tras guardar y la coincidencia de la imagen con la referencia. Así es más fácil determinar en qué etapa se produjo un error.
- Ejecuta los mismos casos en distintos backends. Compara los resultados de CPU y GPU con los mismos documentos, incluidas pruebas en los límites de los mosaicos y con efectos. Guarda las entradas y las diferencias visuales para poder reproducir una regresión.
- Registra las condiciones de las mediciones de rendimiento. Indica el tamaño del documento, la cantidad de capas, el hardware y el estado de la caché. La documentación de PhotoCraft incluye comandos para pruebas individuales y para comparar compositores; las mediciones que presenta corresponden a configuraciones y escenarios concretos.
La guía de desarrollo de PhotoCraft describe comandos para comprobar los corpus PSD, las diferencias visuales y el comportamiento de las distintas rutas de composición. Puede servir como punto de partida concreto para explorar la infraestructura de pruebas del editor; las cifras de rendimiento de la documentación deben interpretarse junto con las entradas y la configuración de hardware que allí se indican.
Qué muestra el ejemplo de PhotoCraft
La versión PhotoCraft v0.7.0 reúne cambios en el propio editor, mientras que la documentación del proyecto revela una práctica de ingeniería concreta: usar PSD de referencia para comprobar la composición y una implementación de CPU con la que comparar la ruta de GPU. Para quienes desarrollan editores, conversores y otras herramientas para archivos complejos, la conclusión es sencilla: comprueba por separado la lectura, el guardado y el resultado visual, y compara las implementaciones aceleradas con una versión de referencia usando entradas fijadas. Así, la compatibilidad y el rendimiento se convierten en propiedades verificables del programa.