DB Analysis CL

A shim that allows use of DawnBringer's color analysis tool from the command-line via Lua-GD.

Requirements

• A Lua runtime
• Lua-GD
• DB's TOOLBOX

How to Use

• Move the appropriate files from DB's Toolbox into place:
  • ffonts/font_mini_3x4.lua
  • libs/dawnbringer_lib.lua
  • libs/db_text.lua
  • scripts/pic_db_AnalyzePalette18.lua
• Run analysis.lua, passing arguments in the following format: lua analysis.lua hex_color_1,hex_color_2,... [filename] [NOBG,CBW1,CBW2,dia_sat1,dia_sat2,dia_sat3,sat_mod1,sat_mod2,sat_mod3]

The arguments:

• Required, colors in hex format, separated by commas without spaces (this is the palette)
• Optionally, the location/name of the output file (default is out.png)
• Optionally, options to pass on to the analysis script, seperated by commas without spaces (default is 0,10,70,255,128,48,1,0,0)

The analysis options:

• (0 or 1) Exclude BG Color
• (0 to 100) CloseCols1 BriWeight %
• (0 to 100) CloseCols2 BriWeight %
• (0 to 255) HSB Diagram Hi Sat
• (0 to 255) HSB Diagram Med Sat
• (0 to 255) HSB Diagram Low Sat
• (0 or 1) Sat Mode: Purity
• (0 or 1) Sat Mode: HSV/HSB
• (0 or 1) Sat Mode: HSL

Notes for Linux users

Installing lua-gd

You may have trouble installing lua-gd. Here's how I was able to install luajit and lua-gd on Ubuntu:

sudo apt install git
sudo apt install make
sudo apt install luajit
sudo apt install luarocks
sudo apt install libgd-dev
git clone https://github.com/ittner/lua-gd.git
cd lua-gd
sed -i "s/LUABIN=lua5.1/LUABIN=luajit/" Makefile
sudo luarocks make
cd ..
rm -rf lua-gd

You'll then have to run the script with luajit analysis.lua ... instead of lua analysis.lua ....

The pound symbol

In Bash, you cannot prefix your colors with # because that character is used to denote comments. You'll need to remove it, escape it with a backslash ( \ ), or enclose the palette in quotes.

License

This code is made available under the MIT License (see LICENSE)

Attribution welcome, but not required