Skip to content

Balakov/GrdToAfpalette

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

GrdToAfpalette

Convert Adobe suite (Photoshop/Illustrator/InDesign) .grd gradient files to Affinity suite (Designer/Photo/Publisher) .afpalette files.

Although the Affinity suite can import Adobe .ase palettes already, gradients are not supported in .ase files.

The conversion is performed entirely in client-side Javascript. No files are uploaded to a server.

Limitations

Transparency is only partially supported. Adobe gradients have a separate track for transparency stops independent from the colours. This isn't something you can do in an Affinity gradient. The tool inserts an extra interpolated colour stop when it encounters a transparency stop that doesn't match the position of an existing colour stop. It seems to work ok, but it may not be a perfect match.

Only RGB and HSV gradients are supported. Both Adobe and Affinity gradients support many different colourspaces: CMYK, LAB, Greyscale etc. Supporting them all is a bunch of work and most of the gradients I've found are RGB or HSV.

The .afpalette format

The Affinity palette format is a standard chunk-based format with a header and footer, but there are still a lot of unknowns and a few unexpected features. It took a few days fiddling around in ImHex to make a file that Affinity Designer would load. Most of the time you get an "Invalid File Format" error if you make a bad file, but if you try really hard you can crash the whole thing. For example, importing a gradient that doesn't have a colour stop a location 1.0! Adobe gradients support that, they just continue the last colour stop until the end of the gradient. Affinity Designer displays garbage and then crashes after a few seconds. I apologise to the Affinity developer for probably sending quite a few automated crash reports to them!

One of the other weirdnesses I discovered is that if colours that appear more than once in the palette file they are replaced with a reference to the first instance of the colour. I don't support that in the files I write out, I just duplicate the colours as it was a lot easier, and Affinity Designer doesn't mind.

The code

The .grd file loader not exactly elegant. It ignores a lot of the file and just picks out the block names it needs. The format is documented, but you don't really need to parse out every little bit of data to get the essential information from a gradient (colours, colour stop locations and midpoints), and I don't have infinite time.

After parsing the .grd the code puts the information into a super-simple JSON intermediate format before passing it to the Affinity writer code. The idea is that the .grd loader and .afpalette writer are independent from each other. Anyone wanting to re-use the code could convert other gradient types to .afpalette, or use the .grd loader and output to another format.

There is a very basic .afpalette reader in the code that does nothing other than parse a .afpalette file and dump its findings to console.log. This was useful when reverse-engineering the format but isn't used in the converter.

Useful links

Description of .grd chunks

.grd file format description

Official Adobe file formats

Adobe

Affinity

Disclaimer

I am not affiliated with either Adobe or Affinity. This is a personal project that I am providing to the community and therefore take no responsibility for lost work due to crashes or malfunctions caused by the files this tool generates.

All trademarks and brand names are the property of their respective owners.

This project is provided under the MIT licence.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published