TMSColor: Converter from BMP/PNG to TMS9928 format
3.1 May/14/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
    -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 May 14 22:21 TMSColor-master/.gitattributes
[generic]                   46      50  92.0% -lh5- 0430 May 14 22:21 TMSColor-master/.gitignore
[generic]                  757    1389  54.5% -lh5- f767 May 14 22:21 TMSColor-master/LICENSE.txt
[generic]                80232  311873  25.7% -lh5- d987 May 14 22:21 TMSColor-master/lodepng.c
[generic]                33604  107543  31.2% -lh5- bc9d May 14 22:21 TMSColor-master/lodepng.h
[generic]                  162     273  59.3% -lh5- 809f May 14 22:21 TMSColor-master/Makefile
[generic]                 3212   11277  28.5% -lh5- 9900 May 14 22:21 TMSColor-master/pletter.c
[generic]                 1244    2541  49.0% -lh5- eb14 May 14 22:21 TMSColor-master/README.md
[generic]                13125   73814  17.8% -lh5- 1840 May 14 22:21 TMSColor-master/tmscolor.c
[generic]                  158   12342   1.3% -lh5- 0323 May 14 22:21 TMSColor-master/vdp_colors.bmp
[generic]                98266  184904  53.1% -lh5- f0de May 24 22:50 TMSColor-master/tmscolor
[generic]                   98     114  86.0% -lh5- 95a8 May 24 23:39 TMSColor-master/SCOPTIONS
[generic]                72812  129416  56.3% -lh5- a922 May 24 23:40 TMSColor-master/tmscolor.68k
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        13 files  303741  835561  36.4%            May 24 23:48