vivid.lua -- No longer crutch on RGB

[WetDesertRock]

Just released my simple library for color conversion and manipulation. It is a step at relieving the crutch most developers (at least that I see) have on RGB. But before I say much more, have a picture of my example program:


Github


While RGB is good and has its uses, it isn't very good at giving you a lot of control over colors. This is where vivid comes in, it gives you the chance to use 6 other color spaces instead of RGB. It provides functions to convert to and from these colorspaces, as well as wrapper functions to magically do it for you. For example, want to do love.graphics.setColor, but with HSL?

Code: Select all

setHSL = vivid.wrapHSL(love.graphics.setColor)
setHSL(0.3,0.5,0.5)

It also has simple color math to make your life easier. Want rgb(10,20,10), but lighter?

Code: Select all

r,g,b = vivid.lighten(0.1,10,20,10) -- Lightens by 0.1 using the HSL colorspace

It also introduces the ability to easily create color spreads. What about if you want 4 different random player colors?

Code: Select all

playerColors  = vivid.HSLSpread(4, math.random(), 0.3, 0.5) -- 4 colors, random hue offset, 0.3 saturation, 0.5 lightness

My curent plans for this library include making the internal mathy stuff use a more consistent style. I also plan on implementing some gamma correction and sRGB support, however I'm not familiar with that. Any pull requests, feature requests, or such are appreciated.

[BOT-Brad]

Very nice, thanks for posting this. Will make nice transitional colour tweens much easier with HSL rather than RGB which can be tricky at times.

[airstruck]

Interesting, I like it. Just some random thoughts:

• Why are the lighten/darken/saturate/desaturate buttons necessary? Wouldn't adjusting the HSL sliders do the same thing?
• Ten color swatches seems like a strange choice, aren't most (harmonic) color schemes based on a 12-hue color wheel?
• Any plans to export palettes from color swatches? Personally I'd be interested in support for Inkscape, Gimp, and GrafX2 formats.

[qubodup]

What a nice tool!


http://youtu.be/LSCN1atNIXg


Could use a randomize button (proof: https://www.youtube.com/watch?v=7sa7ROSygZc | https://www.youtube.com/watch?v=YM3yDaNLZgU )

[WetDesertRock]

Interesting, I like it. Just some random thoughts:

• Why are the lighten/darken/saturate/desaturate buttons necessary? Wouldn't adjusting the HSL sliders do the same thing?
• Ten color swatches seems like a strange choice, aren't most (harmonic) color schemes based on a 12-hue color wheel?
• Any plans to export palettes from color swatches? Personally I'd be interested in support for Inkscape, Gimp, and GrafX2 formats.

I'll go in order, but it all boils down to the example being a simple tool rather than a extensive program. The main feature is the library. All the example does is show what you can do with the library.

• They aren't, but they show that the library can lighten and darken.
• Random number, should I change it to 12? Ok, I'll change it to 12. Again, it just shows the vivid.HSL/HSV/LCHSpread functions.
• I could, but its not made to be a fully featured palette creation tool. Maybe in the future I'll do research and make a library to make palettes. The most this library will ever do is calculate color harmonies.

Thanks for the video by the way. Not sure the random button is necessary. There are only three components to randomize. Its kinda like adding a random function to just a wave generator, it could only randomize the wave type, amplitude, and frequency.

[Positive07]

Just one question that is decisive!
if I pass 1023 to R, G or B:

• Does it clamp the numbers to a number between 0 and 255?
• Does it make the function return weird results for the Hue Saturation and Value numbers?

When I pass 1.5 to the Hue:

• Does it make 1?
• Does it make it return weird numbers on my RGB values?
• Does it wrap for example to 0.5 instead of clamping the value to 1?
• Does the function error when the value is greater than 1or less than 0?

The library looks pretty neat and has more functionality than I could ask for!

Would probably add (but maybe not as part of this lib, dont know) an hex string to RGB converter with the #FFF, #FFFFFF, #FFFF, #FFFFFF formats plus the same ones with "0x" instead of "#"

[WetDesertRock]

Good question, I will check, and then fix if it is wrong. I know that some weirdness may come with the CIE colorspaces. But honestly I don't know much about them.