PhotoCraft v0.7: näin testaat PSD-yhteensopivuutta ja rakennat nopean editorin

PSD-tiedosto voi avautua editorissa mutta näyttää silti erilaiselta: ero voi koskea maskia, tekstiä, tasotehostetta tai tasojen järjestystä. Yksi tapa testata tulosta on verrata uudelleen koottua kompositiota PSD-tiedoston sisään tallennettuun yhdistelmäkuvaan. 11. lokakuuta 2026 julkaistu PhotoCraft v0.7.0 tarjoaa tilaisuuden tarkastella tätä suunnitteluratkaisua Rustilla kirjoitetun avoimen grafiikkaeditorin esimerkin kautta.

Julkaisussa luetellaan muutoksia siveltimiin, valintaan, maskeihin, OpenRaster-tuontiin ja editorin muihin osiin. Kehittäjille erityisen kiinnostava on projektin julkaisema dokumentaatio: siinä kuvataan PSD-tuonnin testit, kompositoijien vertailu ja toistettaviin testeihin käytettävä tiedostokokoelma.

PSD sisältää vertailukuvan

Monitasoinen PSD sisältää tasorakenteen ja dokumentin yhdistelmäkuvan. PhotoCraft renderöi tasot ja vertaa tulosta tähän sisäänrakennettuun komposiittiin. Testillä arvioidaan, kuinka tarkasti ohjelma pystyy toistamaan dokumentin ulkoasun käsitellessään tekstiä, korjauksia, tehosteita ja muita tiedostomuodon ominaisuuksia.

PhotoCraftin arkkitehtuurikuvauksessa tätä lähestymistapaa kutsutaan ”kompositoijan oraakkeliksi”. Testausdokumentaatiossa luetellaan kolme PSD-tiedostokokoelmaa: 256 tiimin Photoshopissa luomaa tiedostoa, 170 psd-tools- ja ag-psd-kokoelmista peräisin olevaa tiedostoa sekä erillinen 309 tiedoston psd-tools-kokoelma. Kokoelmat ladataan kiinnitetyillä versioilla ja tarkistetaan tarkistussummien avulla.

Tiedostomuotojen kehittäjien kannattaa erottaa testit sen mukaan, mihin kysymykseen ne vastaavat. Rakennetesti osoittaa, onnistuiko dokumentin lukeminen; avaus- ja tallennuskierroksen testi kertoo, säilyivätkö tiedot; komposiitin vertailu mittaa, kuinka oikein visuaalinen tulos toistui. PhotoCraftin dokumentaatiossa mainitaan sekä muuttamattomien tiedostojen tavuvakauden testit että PSD:n sisäänrakennettuun komposiittiin tehtävät vertailut.

CPU-kompositoija toimii vertailutoteutuksena

Projekti kuvaa CPU-kompositoijan viennin ja testien vertailupoluksi; wgpu-pohjainen GPU-kompositoija toteuttaa kanvasta varten saman toimintosuunnitelman. Arkkitehtuuridokumentaatiossa kerrotaan, että tuloksia verrataan 8-bittisessä tulosteessa enintään 1\/255:n toleranssilla ja CPU:n ja GPU:n välinen tarkistus tehdään CI:ssä, myös ohjelmallisella grafiikkasovittimella.

GPU:ta tarvitaan vuorovaikutteiseen kanvaaseen, mutta laitteistopolkua voidaan käyttää vain dokumentin ja käyttöympäristön salliessa. Ohjeen mukaan monikanavaiset dokumentit ja tekstuurirajan ylittävät alueet käsitellään CPU-kompositoijalla; jos GPU-laite menetetään, kanvas siirtyy myös CPU:lle. Nämä ovat konkreettisia ehtoja siirtymiselle polusta toiseen, eivät väite tasaisesta nopeudesta kaikilla laitteilla.

Samaa yleistä mallia voi soveltaa muihinkin laskentajärjestelmiin: pidä testattava vertailutoteutus optimoidun polun rinnalla ja aja molempia samoilla syötteillä. Tietokannassa tämä voi tarkoittaa yksinkertaista tulkkia optimoidun moottorin rinnalla, median käsittelyssä taas ohjelmistopolkua laitteistokiihdytyksen rinnalla. Vertailu paljastaa tulosten erot; siitä tulee toistettava, kun syötteet ja hyväksyttävän eron kriteeri on määritelty.

Näin rakennat käytännön testit

1. Kokoa pieni mutta monipuolinen aineisto. Sisällytä tiedostoja, joissa on maskeja, tekstiä, ryhmiä, läpinäkyvyyttä, tehosteita ja väritiloja. Kirjaa tiedostojen alkuperä ja aineiston versiot, jotta myöhemmissä testeissä käytetään samoja syötteitä.
2. Valitse vertailukohta ja toleranssi. PSD-tiedostoissa tulosta voi verrata sisäänrakennettuun yhdistelmäkuvaan. Määritä sallittu virhe ja testaa erikseen mitat, väriprofiili ja alfakanava, jos niillä on sovelluksessasi merkitystä.
3. Erota tuonti, tallennus ja renderöinti toisistaan. Erillisillä testeillä voi tarkistaa tasojen jäsentämisen, tallennuksen jälkeisen uudelleenavauksen ja kuvan vastaavuuden vertailukuvaan. Näin virheen syntyvaihe on helpompi selvittää.
4. Aja samat testitapaukset eri taustajärjestelmillä. Vertaa CPU- ja GPU-tuloksia samoilla dokumenteilla, mukaan lukien laattojen reunoihin ja tehosteisiin liittyvät testit. Tallenna syöte ja visuaalinen ero, jotta regression voi toistaa.
5. Kirjaa suorituskykymittausten olosuhteet. Ilmoita dokumentin koko, tasojen määrä, laitteisto ja välimuistin tila. PhotoCraftin dokumentaatiossa on komentoja yksittäisten testien ja kompositoijien vertailuun; siinä esitetyt mittaustulokset koskevat tiettyjä kokoonpanoja ja tilanteita.

PhotoCraftin kehitysohjeessa kuvataan komentoja PSD-kokoelmien, visuaalisten erojen ja eri kompositiopolkujen toiminnan testaamiseen. Se tarjoaa konkreettisen lähtökohdan editorin testausinfrastruktuurin tutkimiseen; dokumentaation suorituskykylukuja kannattaa tarkastella yhdessä siinä ilmoitettujen syötteiden ja laitteistokokoonpanon kanssa.

Mitä PhotoCraftin esimerkki osoittaa

PhotoCraft v0.7.0 yhdistää editorin omat muutokset ja projektin dokumentaatiossa kuvatun erillisen suunnittelukäytännön: vertailu-PSD-tiedostoilla testataan kompositiota, ja GPU-polkua verrataan CPU-toteutukseen. Editoreita, muuntimia ja muita monimutkaisten tiedostojen työkaluja kehittäville johtopäätös on yksinkertainen: testaa lukeminen, tallentaminen ja visuaalinen tulos erikseen ja vertaa nopeutettuja toteutuksia vertailuversioon kiinnitetyillä syötteillä. Näin yhteensopivuudesta ja suorituskyvystä tulee ohjelman testattavia ominaisuuksia.