TMSColor: Converter from BMP to TMS9928 format
3.0 Apr/27/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.
    -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 Apr 27 20:43 TMSColor-master/.gitattributes
[generic]                   24      24 100.0% -lh0- 98f3 Apr 27 20:43 TMSColor-master/.gitignore
[generic]                  757    1389  54.5% -lh5- f767 Apr 27 20:43 TMSColor-master/LICENSE.txt
[generic]                  153     243  63.0% -lh5- 9a2b Apr 27 20:43 TMSColor-master/Makefile
[generic]                 3212   11277  28.5% -lh5- 9900 Apr 27 20:43 TMSColor-master/pletter.c
[generic]                 1240    2537  48.9% -lh5- 48da Apr 27 20:43 TMSColor-master/README.md
[generic]                12586   71491  17.6% -lh5- 3721 Apr 27 20:43 TMSColor-master/tmscolor.c
[generic]                  158   12342   1.3% -lh5- 0323 Apr 27 20:43 TMSColor-master/vdp_colors.bmp
[generic]                   94     105  89.5% -lh5- d73b Jul 14  2024 TMSColor-master/SCOPTIONS
[generic]                30907   56080  55.1% -lh5- 0641 May  3 18:32 TMSColor-master/tmscolor.68k
[generic]                51245   95036  53.9% -lh5- 6370 May  4 01:06 TMSColor-master/tmscolor
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        11 files  100401  250549  40.1%            May  5 15:01