CLSEncoderDecoder 1.0.0

A simple Encoder/Decoder for Color Set files from Clip Studio Paint (.cls)

Examples

Saving

ClsColorSet set = new(
    new List<ClsColor>()
    {
        new ClsColor(123, 234, 243, 255),
        new ClsColor(123, 234, 243, 0),
    },
    "Color Set Name");
set.Save("TwoColors.cls");

Loading

ClsColorSet set = ClsColorSet.Load(@"LightGrayish.cls");

.cls file format

I reverse-engineered the format myself, so this is not a complete spec. I don't know if the values are signed or unsigned, but it shouldn't matter for any reasonable color set. I assume unsigned in the code.

CSP seems to treat any colors with non-zero alpha as fully opaque, so the only alpha values you should use are 0 and 255.

Types

File sections

Signature

I put 256 as a part of the signature, but it could also be an indication of the version

Header

CSP ignored the ASCII name.

The zero in the middle seems to be useless, changing it to any other value doesn't prevent CSP from loading the file.

Colors

"4" might be the number of channels, values above 4 prevent CSP from loading the file. 0-3 are treated the same as 4.

The next section contains all colors written one after another in the following format:

The 0 in the end doesn't do anything as far as I can tell, but it has to be a zero. Curiously, you can omit the 0 and set the length to 4, and the file loads just fine. Increasing the length and appending more zeros also doesn't break the file. I don't recommend doing any of that though, as CSP itself outputs colors with length 8 and a trailing 0.