pecet / analogue_pal_tool

Analogue Pal Tool

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Analogue Pal Tool

Simple over-engineered tool for generating PAL color palettes from images.

Usage examples

Prebuilt binaries are TODO. For now use cargo from Rust to build and run.

  • Display full help:
    cargo run -- --help
    
  • Display palette from .pal file in terminal (it must support 24-bit color obviously, use good terminal emulator like Kitty or Alacritty)
    cargo run -- display palette.pal
    
    example of display command
  • Create template .pal file:
    cargo run -- create-template-pal -o template.pal
    
    Use generate .pal file while taking screenshots on Analogue Pocket (Analogue + Start button combination). This palette does not look good, but will allow you to use next option
  • Colorize and scale (x3) .png image created using template .pal file:
     cargo run -- colorize-image -s 3 --pal example.pal --output output.png 20240105_212250.png 
    
    It will generate file similar to this: example of single image colorization, Super Mario Land 2 by Nintendo
  • Colorize multiple images using multiple .pal files and generate HTML summary file:
cargo run -- colorize-image -t -m -s 3 -o 'dev_assets/output/test2.png' -p '/Users/pecet/dev/analogue_pal_tool/dev_assets/Trashuncle/GBP/**/*.pal' '/Users/pecet/dev/analogue_pal_tool/dev_assets/ScreenShots/*.png'

It will generate output.html (currently not configurable) in current directory containing all images and palette combinations. So basically you can preview any palettes you have using this. Example part of output from this command (html): example of multiple image colorization, Super Mario Land 1, 2 and Tetris by Nintendo

TODO

  • Add prebuilt binaries
    • Linux and MacOS should be easy, but I currently do not have Windows machine / VM
  • Add option to use convert images back to palettes (images are already generated as PNG files with 8-bit palette so this should be easy)
  • Add LUA scripting support for palette manipulation because why not

About

Analogue Pal Tool

License:MIT License


Languages

Language:Rust 94.6%Language:HTML 5.4%