Skip to content

A tool which generates decision trees for accelerated string lookup.

License

Notifications You must be signed in to change notification settings

c0rp3n/colorlib-gen

Repository files navigation

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

About

A tool which generates decision trees for accelerated string lookup.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published