Unflatten function - create an alpha channel and make white pixels fully transparent

[antonmarsden]

@lovell A little something I'm working on. It creates a hard (0/255) alpha channel based on the pixel colour. Very keen to get your feedback on this. Note that it relates to #1648

It's currently limited to making lighter areas transparent (but easy enough to change how the threshold rules work). I'm still thinking about how to generalise it for mainstream use.

See provided images for example output (input was from the test image suite).

[lovell]

Thanks for the PR, I'll be able to take a closer look in a couple of weeks.

[lovell]

Thanks again for this PR, sorry it took me a while to get around to reviewing it properly. I've added a couple of questions/thoughts inline.

[antonmarsden]

@lovell Thanks for the feedback, I'll find some time to incorporate it over the next few weeks.

[antonmarsden]

@lovell Looks like prebuild is failing on arm64. I am doing an image compare with threshold=0. Not sure why it's breaking at this stage. Are there any platform-specific quirks to be aware of?

[lovell]

libspng uses a specific NEON (SIMD) code path on ARM64 to unpack palette entries so its possible there may be a small rounding/clipping difference. It's probably nothing to worry about in the context of this change so feel free to allow a threshold of 1.

[lovell]

Thank you for the updates Anton, this looks great.

Please can you add TypeScript definitions to index.d.ts then this is good to merge.

[antonmarsden]

Thank you for the updates Anton, this looks great.

Please can you add TypeScript definitions to index.d.ts then this is good to merge.

Done, good to go.

[lovell]

Thanks for the updates, looks great, I'll merge shortly.

[fyyyyy]

If there was a backgroundColor and threshold option for unflatten, it would be very useful. I.e. to remove background colors typically found in video game sprites.

[fyyyyy]

maybe a similar api to the trim function
#3332