Added a .wsa file reader

[Mailaender]

Closes #6781.

[pchote]

This appears to be a tweaked version of the D2 mod's wsa parser. Do you have @evgeniysergeev's permission to replace the copyright statement with OpenRA's standard header?

[Mailaender]

He is already listed at https://github.com/OpenRA/OpenRA/blob/bleed/AUTHORS#L62

I also rewrote a lot with information I found on the net. This includes https://github.com/ultraq/redhorizon/blob/master/redhorizon-classic/source/nz/net/ultraq/redhorizon/classic/filetypes/wsa/WsaFile.groovy and http://nyerguds.arsaneus-design.com/project_stuff/2018/EngieFileConverter/release/ and http://www.shikadi.net/moddingwiki/Westwood_WSA_Format and http://xhp.xwis.net/documents/ccfiles4.txt

[evgeniysergeev]

Is it possible to put it in common or something, because d2 mod will depend on cnc dll, right now it is not depend on it.

[Mailaender]

I think you don't want this for Dune 2. Sadly there is no version field. You will need to keep, but better rename your D2WsaReader. You may want to use parts of my code especially the IsWsa checks as yours was only guessing for large file sizes and maybe using the actual offsets to read the data. It was a requirement to get the cnc variant working. You only need to remove some fields:

• X and Y
• flags and the palette

You probably also need to keep the FrameOffsets can be set to 0 exception which I ripped out.

[pchote]

Is there any advantage to treating these as paletted sprites? We could parse them straight to RBGA and then treat them similarly to vqa.

[abcdefg30]

#17984 (comment) is unaddressed.

[Mailaender]

I agree. While this is something in between sprites and movies, it should be handled like we do .vqa movies. That depends on #12775 now which is a rather large refactor I am currently experimenting on.

[Mailaender]

Rebased and rewrote this using my new IVideo API.

[penev92]

I can verify that the implementation here is in line with the cited sources, as well as being in line with the current VqaLoader/Reader implementation.
Opened all available WSA files for TD and RA in the asset browser and didn't see any obvious issues.
Only thing I admittedly didn't look into is the palette reading segment, but the colors look OK ingame.

Of course my comments on WsaReader also apply to WsaLoader since they share a bunch of code.

[reaperrr]

https://github.com/OpenRA/OpenRA/wiki/Changelog-(bleed)/_compare/2cd5233586c99aadb5348fa6db0e8f9b198a09d2...c8905eee60878a0f272e6fd554e216731b430076