Color Cell image (.cc4) display code and encoding tool

Rayman · 2024-03-02 22:29

This is to wrap up discussion from this thread:
https://forums.parallax.com/discussion/171799/color-cell-compression

You can now display nearly fullscreen images with VGA at 1080p from HUB RAM (no external memory required)

The .cc4 image format uses a variation of color cell compression that leverages the existing 2bpp tile driver. A really nice feature of this approach is that decompression is not needed. Just need to point tile pointers to the right spot and set palette and you're done.

The encoding tool provided here takes 8bpp (256 color) images that has height and width that are multiples of 16 (due to the 16x16 cell size). The result can be saved as a .cc4 file.

Some possible resolutions with this example are:
1440x960
1424x1072
720x1088
1456x976
The actual limitation is that image must fit in HUB ram so .cc4 has a ~400kB size limit.

Several example .cc4 files are provided here.

The tool is too big to post here...
Download the encoding tool here: https://www.rayslogic.com/Propeller2/CC4/CC4.htm (source code posted a few posts down from here)

Note: The 1080p Tile Driver is rigged for a setup such as a P2 Eval Board with A/V Adapter on Basepin=8 or equivalent.

Rayman · 2024-03-02 22:30

This parrot comes out exceptionally well with .cc4 encoding. You have to look really close to find faults... The 8bpp source file is attached for comparison with the bmp version of the .cc4 file.

Rayman · 2024-03-02 23:00

I've tried just about all the images from here:
https://imagecompression.info/test_images/

They all generally come out really well.
There is only one that I'm disappointed with...
The tool does not work so good on this flower, around the edges.
Seems the tool could be improved perhaps...

Original 8bpp and bmp of the .cc4 version are attached.

Rayman · 2024-03-02 23:02

Here's the Visual Studio C++ source code for the encoder.
In case, someone can improve on it...

Wuerfel_21 · 2024-03-03 00:35

Hmm, I can't get it to totally break with any normal image, good job. Though it has issues with bright red. Doing color math in RGB space is just kinda broken and that's a symptom. Here's some ruby code I wrote for perceptual color distance computation in CIELAB or OKLAB color spaces. In either case the L component should be perceptual luminance, so try using that. I used to have a C++ version, but that is currently not accessible... (hard drive failed and not sure if that directory is in the backup).

Note for porting: the ** is the power operator

# Fix deeply stupid bug in some Ruby interpreters
if Math.cbrt(0.0).nan?
    Math.singleton_class.prepend(Module.new do
        def cbrt(x)
            x == 0.0 ? 0.0 : super
        end
    end)
end

class LABColor

    USE_OKLAB = true
    AB_WEIGHT = USE_OKLAB ? 1.8 : 1.0

    attr_accessor :l,:a,:b

    def initialize(l,a,b)
        @l,@a,@b = l,a,b
        freeze
    end

    def self.from_rgb(r,g,b)
        # Preprocess RGB
        r,g,b = *[r,g,b].map{|c|c/=255.0;(c>0.04045 ? ((c+0.055)/1.055)**2.4 : c/12.92)*100.0}

        if USE_OKLAB
            l_ = Math.cbrt(0.4122214708 * r + 0.5363325363 * g + 0.0514459929 * b)
            m_ = Math.cbrt(0.2119034982 * r + 0.6806995451 * g + 0.1073969566 * b)
            s_ = Math.cbrt(0.0883024619 * r + 0.2817188376 * g + 0.6299787005 * b)

            l = 0.2104542553*l_ + 0.7936177850*m_ - 0.0040720468*s_
            a = 1.9779984951*l_ - 2.4285922050*m_ + 0.4505937099*s_
            b = 0.0259040371*l_ + 0.7827717662*m_ - 0.8086757660*s_
        else
            # Convert to XYZ
            x = r*0.4124 + g*0.3576 + b*0.1805
            y = r*0.2126 + g*0.7152 + b*0.0722
            z = r*0.0193 + g*0.1192 + b*0.9505

            # Observer= 2°, Illuminant= D65
            x /= 95.047
            y /= 100.0
            z /= 108.883

            # Do something with XYZ
            x,y,z = *[x,y,z].map{|c|c>0.008856 ? c**(1/3.0) : 7.787*c+16.0/116.0}

            # Convert to LAB
            l = (116.0*y)-16
            a = 500.0*(x-y)
            b = 200.0*(y-z)
        end

        return self.new(l,a,b)
    end

    def to_rgb
        if USE_OKLAB
            l = (@l + 0.3963377774 * @a + 0.2158037573 * @b)**3;
            m = (@l - 0.1055613458 * @a - 0.0638541728 * @b)**3;
            s = (@l - 0.0894841775 * @a - 1.2914855480 * @b)**3;

            r = +4.0767416621 * l - 3.3077115913 * m + 0.2309699292 * s
            g = -1.2684380046 * l + 2.6097574011 * m - 0.3413193965 * s
            b = -0.0041960863 * l - 0.7034186147 * m + 1.7076147010 * s
        else
            y = (@l+16.0)/116.0
            x = @a/500.0 + y
            z = y - @b/200.0

            # Do something with XYZ
            x,y,z = *[x,y,z].map{|c|c**3>0.008856 ? c**3 : (c-(16.0/116.0))/7.787}

            # Observer= 2°, Illuminant= D65
            x *= 95.047
            y *= 100.0
            z *= 108.883

            r = x * +3.2406 + y * -1.5372 + z * -0.4986
            g = x * -0.9689 + y * +1.8758 + z * +0.0415
            b = x * +0.0557 + y * -0.2040 + z * +1.0570
        end

        r,g,b = *[r,g,b].map{|c|c/=100.0;((c>0.0031308 ? 1.055*(c**(1/2.4))-0.055 : c*12.92)*255.0).to_i.clamp(0,255)}

        return r,g,b
    end

    def distance(other)
        ((self.l-other.l)**2) + ((self.a-other.a)**2)*AB_WEIGHT + ((self.b-other.b)**2)*AB_WEIGHT
    end

    def interpolate_to(other,i)
        j = 1.0 - i
        return LABColor.new(
            @l * j + other.l * i,
            @a * j + other.a * i,
            @b * j + other.b * i
        )
    end

    def self.from_packed(c)
        self.from_rgb(*ChunkyPNG::Color.to_truecolor_bytes(c))
    end

end

MAElektronik · 2024-03-03 17:56

Interesting.
Hope I get time to test it some day

Rayman · 2024-03-08 00:18

Got slideshow working on SimpleP2 board, but FSRW is refusing to work on Eval board for some reason I don't understand...
I think it's my USB setup with the board being after 3 hubs... Have to figure that one out before I post it.

But, to make this useful in the tile driver for GUI use, have to see how good or bad the images look with a fixed palette (instead of optimized palette).
The palette usually used in the tile driver is described like this:

XTerm palette (to be slightly modified to avoid duplicate colors)
'from: https://jonasjacek.github.io/colors/
'Don't like that several of the first 16 are duplicated later...
'Going to make small changes to colors: 0,8,9,10,11,12,13,14,15 so they are distinct

Will be interesting to see what the parrot looks like with this...

Rayman · 2024-03-09 16:41

Got the slideshow working with Eval board with A/V on basepin P8.
Seems I had a "DRVNOT P58" in the VGA driver, which was messing up the uSD. All better now.
Needs these .cc4 images on uSD.
The transitions are interesting...

Rayman · 2024-03-09 21:52

Ok, last thing wanted to do here was try this with a fixed Palette.
This lets us keep the background color the same and print the filename on the screen.

The quality suffers a lot, but this is what can be integrated into the 2bpp Tiled GUI.
Could be useful to have smaller images in the screen along side or under dials, buttons, sliders, etc.

Rayman · 2024-03-10 00:46

@Wuerfel_21 I have luminance as:
PalLuma[i] = r * 0.30 + g * 0.59 + b * 0.11;

I can't really figure out what yours is doing...

But, including this luminance into the error when finding best palette index to use is probably a good idea...

Wuerfel_21 · 2024-03-10 01:31

@Rayman said:
@Wuerfel_21 I have luminance as:
PalLuma[i] = r * 0.30 + g * 0.59 + b * 0.11;

I can't really figure out what yours is doing...

Calculating luminance like that is a very, very rough approximation. First off, the RGB values in the image are not linear (that is, photon emission by the screen is not proportional to the number value). Instead, they are transformed by the sRGB transfer curve (unless the image contains color profile metadata, but that's another headache). This means there's more precision in darker shades, where your eyes are more sensitive.

This code converts sRGB values to linear floating point RGB in range 0 to 100 (IDK why, should really be 0 to 1.)

        r,g,b = *[r,g,b].map{|c|c/=255.0;(c>0.04045 ? ((c+0.055)/1.055)**2.4 : c/12.92)*100.0}

Conversely, this is the inverse (linear to sRGB):

        r,g,b = *[r,g,b].map{|c|c/=100.0;((c>0.0031308 ? 1.055*(c**(1/2.4))-0.055 : c*12.92)*255.0).to_i.clamp(0,255)}

Note that this can be approximated by taking the square (sRGB->linear) or square root (linear->sRGB) for real-time applications.

Also note that your monitor most likely sucks and doesn't quite adhere to sRGB (or any other specification) without calibration. You likely have a gamma lower than 2.4 in practice.

Linear RGB values allow some neat things and using these to calculate luminance is more accurate (when you then convert that linear value back into sRGB). But aha, we don't really perceive absolute counts of photons either. In the OKLAB version (just ignore the CIELAB version for now), the L,M,S variables refer to the response of the long, medium and short cone cells (under normal conditons).

            l_ = Math.cbrt(0.4122214708 * r + 0.5363325363 * g + 0.0514459929 * b)
            m_ = Math.cbrt(0.2119034982 * r + 0.6806995451 * g + 0.1073969566 * b)
            s_ = Math.cbrt(0.0883024619 * r + 0.2817188376 * g + 0.6299787005 * b)

The actual luminance you see from that is then a linear combination of these (L) and adding two more well-chosen orthagonal axes (A and B ) can then describe a color.

            l = 0.2104542553*l_ + 0.7936177850*m_ - 0.0040720468*s_
            a = 1.9779984951*l_ - 2.4285922050*m_ + 0.4505937099*s_
            b = 0.0259040371*l_ + 0.7827717662*m_ - 0.8086757660*s_

When you do math on these LAB values (such as calculating their euclidean distance), the result is more in line with how you actually perceive colors in relation to one another (notably not in line with how colors physically interact - that's what linear RGB is for). Note that LAB values do not have any particularly sensible range of valid values and it is easy to construct a color that doesn't really exist.

Color Cell image (.cc4) display code and encoding tool

Comments