Skip to content

Latest commit

 

History

History
60 lines (48 loc) · 1.75 KB

README.md

File metadata and controls

60 lines (48 loc) · 1.75 KB
Raw

ColorLib - Color Generator

A tool which generates decision trees for accelerated string lookup in ColorLib.

ColorLib - Color Generator creates accelerated string lookup functions for ColorLib from a set of input colors, it creates a minimum spanning decision tree to identify any color in the input set.

The decision tree is then converted into the neccesary source code for the use case and included in one of the ColorLibs implementations.

Usage

First you need to install colorlib_gen with py ./setup.py install.

To change the output colors you first need to create a new or edit your config file.

There is an example config file provided that it is recommended you copy from it can be seen here.

Then you can rerun colorlib_gen to generate a new file containing a lookup function for your colors.

Example

# for more info use ./color_gen.py -h
colorlib_gen -re --target "sourcepawn" --config "./example_conf.yaml" colorlib_map.inc

Example GitHub workflow for SourcePawn

Note: This must executed before the plugins will be compiled.

- name: Set up Python
  uses: actions/setup-python@v2
  with:
    python-version: '3.x'

- name: Install dependencies
  run: python3 -m pip install --upgrade pip setuptools wheel

- name: Download colorlib-gen
  run: |
    cd tools
    git clone https://github.com/c0rp3n/colorlib-gen.git

- name: Install colorlib-gen
  run: |
    cd tools/colorlib-gen
    pip install -r ./requirements.txt
    python3 ./setup.py install
- name: Generate colorlib_map.inc
  run: colorlib_gen -re --target "sourcepawn" --config "./example_conf.yaml" colorlib_map.inc

Download