micheldebree/retrospex: Convert images to fit Commodore 64 graphic modes

retrospex

Converts an image to match Commodore 64 graphic modes specifications. Designed to be used as part of a development toolchain, for example together with other tools like:

ImageMagick

png2prg. retrospex is specifically designed for compatibility with png2prg

spot

Usage

Usage: retrospex [options] input.png Options: -o Output filename (default out.png) -m Graphics mode. (default koala), One of sccharset,mcibitmap,koala,hires,mixedcharset,mccharset -p Palette (default colodore). One of archmage,perplex_1,lenyn,colodore,vice_old_lum,vice_371_internal,electric,ste,perplex_2,pepto,vice,pantaloon -dm Dither matrix (default bayer4x4). One of bayer4x4,bayer8x8,none,bayer2x2 -dd Dither depth (default 25). 0-255

Example toolchain

graph TD image((image)) -- PNG --> ImageMagick ImageMagick -- color adjusted, resized, cropped PNG --> retrospex retrospex -- quantized PNG --> png2prg c64image((C64 executable)) png2prg -- koala --> c64image music((music)) -- SID --> png2prg

Create a c64 executable from madonna.png with music Whos_That_Girl.sid :