TMSColor: Converter from BMP/PNG to TMS9928 format
3.2 Aug/26/2025  by Oscar Toledo G. http://nanochess.org

Usage:

    tmscolor [options] image.bmp image.asm [label]
        Creates image for use with assembler code

    -sms   Sega Master System mode.
           Allows up to 448 tiles using -t
    -nes   NES/Famicom mode.
           Allows up to 256 tiles using -t
    -b     Generates CVBasic source code.
    -n     Removes CVBasic stub code for displaying.
    -z     Output file is compressed with Pletter.
    -s     Process tiles in chunks of 16 pixels high (sprites).
    -sb    Same as above but generates BITMAP statements.
    -t     Generates minimum of tiles required.
    -t1    Same but starting at tile 1 (0-255).
    -e45d2 Replaces color 4 with 5 and d with 2 before processing.
    -fx    Flip image along the X-coordinate (mirror)
    -fy    Flip image along the Y-coordinate
    -i     Generates BITMAP statements instead of DATA
    -i2    Generates BITMAP statements using X and .
    -m     Generates magic sprites for areas with more than 2 colors
    -p1    Searches best color combination for photo (slow)
    -p2    Searches best color combination for photo (2x2 dither) (slow)
    -o result.bmp
           Outputs the final image, plus highlight of errors (if any).
    -d     Direct copy of binary input file to output (can compress).
           Useful for getting binary data in ASM or CVBasic code.

    Best photo conversion is generated by this command line:
      tmscolor -p2 photo.bmp photo.bin
    Photos will look better if the contrast is good.
    Magic sprites will work only with an image of 256x192 pixels.

Thanks to LeandroCorreia for ideas of color conversion.

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                   25      25 100.0% -lh0- bba9 Sep  6 02:26 TMSColor-master/.gitattributes
[generic]                   46      50  92.0% -lh5- 0430 Sep  6 02:26 TMSColor-master/.gitignore
[generic]                  757    1389  54.5% -lh5- f767 Sep  6 02:26 TMSColor-master/LICENSE.txt
[generic]                80232  311873  25.7% -lh5- d987 Sep  6 02:26 TMSColor-master/lodepng.c
[generic]                33604  107543  31.2% -lh5- bc9d Sep  6 02:26 TMSColor-master/lodepng.h
[generic]                  159     270  58.9% -lh5- 9a68 Sep  6 02:26 TMSColor-master/Makefile
[generic]                 3212   11277  28.5% -lh5- 9900 Sep  6 02:26 TMSColor-master/pletter.c
[generic]                 1456    3223  45.2% -lh5- 129f Sep  6 02:26 TMSColor-master/README.md
[generic]                13741   81651  16.8% -lh5- c47a Sep  6 02:26 TMSColor-master/tmscolor.c
[generic]                  158   12342   1.3% -lh5- 0323 Sep  6 02:26 TMSColor-master/vdp_colors.bmp
[generic]                90283  182036  49.6% -lh5- 7497 Sep 29 00:52 TMSColor-master/tmscolor
[generic]                72067  141020  51.1% -lh5- 7195 Sep 29 01:08 TMSColor-master/tmscolor.68k
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        12 files  295740  852699  34.7%            Sep 30 21:50