The colors file is a configuration file to define the different colors that the program with use to colorize the elements on the layout.
One important thing about the color file is that any animation using its color names, will be compatible only with that color file, so if you create your own custom file, any animation created will be compatible with only that color file.
The colors files are located inside /usr/shared/ledspicer/
LEDSpicer uses some color names to denote special colors or functionality, the list of pseudo colors is:
1. On This color means that the element will be on.
2. Off This color means that the element will be off.
3. Random This color means that the element color will be decided randomly based on the other colors of the list of random picks inside the ledspicer.conf.
The root node, like every other configuration file, is <LEDSpicer></LEDSpicer> with the following mandatory parameters: version, type, and format.
version leave it always to 1.0
type is Colors
format leave it as hex
* I do not support other formats right now.*
<?xml version="1.0" encoding="UTF-8"?>
<LEDSpicer
version="1.0"
type="Colors"
format="hex"
>
Inside the root you will find <color />
The color node have only two attributes: name and color.
name is a unique name identification, that represent the color name.
color Every color must be represented in six digits hexadecimal notation (like in HTML, but without the # in the front).
<color name="White" color="FFFFFF" />
And that is all for the color configuration file, all together will look like this (sample from basicColors.xml file):
<?xml version="1.0" encoding="UTF-8"?>
<LEDSpicer
version="1.0"
type="Colors"
format="hex"
>
<color name="White" color="FFFFFF" />
<color name="LightGray" color="D3D3D3" />
<color name="Gray" color="808080" />
<color name="DimGray" color="696969" />
<color name="AlmostBlack" color="050505" />
<color name="Black" color="000000" />
<color name="Red" color="FF0000" />
<color name="LightRed" color="F08080" />
<color name="DarkRed" color="8B0000" />
<color name="VeryDarkRed" color="0B0000" />
<color name="Green" color="00FF00" />
<color name="LightGreen" color="90EE90" />
<color name="DarkGreen" color="006400" />
<color name="VeryDarkGreen" color="000600" />
<color name="Blue" color="0000FF" />
<color name="LightBlue" color="ADD8E6" />
<color name="DarkBlue" color="00008B" />
<color name="VeryDarkBlue" color="00000B" />
<color name="Yellow" color="FFFF00" />
<color name="LightYellow" color="FFFFE0" />
<color name="Olive" color="808000" />
<color name="Gold" color="FFD700" />
<color name="VeryDarkYellow" color="0b0600" />
<color name="Magenta" color="FF00FF" />
<color name="Violet" color="EE82EE" />
<color name="DarkMagenta" color="8B008B" />
<color name="Pink" color="FFC0CB" />
<color name="HotPink" color="FF69B4" />
<color name="VeryDarkMagenta" color="0B000B" />
<color name="Cyan" color="00FFFF" />
<color name="LightCyan" color="E0FFFF" />
<color name="DarkCyan" color="008B8B" />
<color name="VeryDarkCyan" color="000B0B" />
</LEDSpicer>