https://github.com/micheldebree/retrospex

Skip to content

Navigation Menu

Toggle navigation
 
Sign in

  * Product
      +  
        Actions
        Automate any workflow
      +  
        Packages
        Host and manage packages
      +  
        Security
        Find and fix vulnerabilities
      +  
        Codespaces
        Instant dev environments
      +  
        Copilot
        Write better code with AI
      +  
        Code review
        Manage code changes
      +  
        Issues
        Plan and track work
      +  
        Discussions
        Collaborate outside of code
    Explore
      + All features
      + Documentation
      + GitHub Skills
      + Blog
  * Solutions
    For
      + Enterprise
      + Teams
      + Startups
      + Education
    By Solution
      + CI/CD & Automation
      + DevOps
      + DevSecOps
    Resources
      + Learning Pathways
      + White papers, Ebooks, Webinars
      + Customer Stories
      + Partners
  * Open Source
      +  
        GitHub Sponsors
        Fund open source developers
      +  
        The ReadME Project
        GitHub community articles
    Repositories
      + Topics
      + Trending
      + Collections
  * Pricing

Search or jump to...

Search code, repositories, users, issues, pull requests...

Search
[                    ]
Clear

Search syntax tips

Provide feedback

We read every piece of feedback, and take your input very seriously.

[                    ] [ ] Include my email address so I can be
contacted
Cancel Submit feedback

Saved searches

Use saved searches to filter your results more quickly

Name [                    ] 
Query [                    ]

To see all available qualifiers, see our documentation.

Cancel Create saved search
Sign in
Sign up
You signed in with another tab or window. Reload to refresh your
session. You signed out in another tab or window. Reload to refresh
your session. You switched accounts on another tab or window. Reload
to refresh your session. Dismiss alert
{{ message }}
micheldebree / retrospex Public

  * Notifications
  * Fork 0
  * Star 25
  * 

Convert images to fit Commodore 64 graphic modes

25 stars 0 forks Branches Tags Activity
Star
Notifications

  * Code
  * Issues 0
  * Pull requests 0
  * Actions
  * Projects 0
  * Security
  * Insights

Additional navigation options

  * Code
  * Issues
  * Pull requests
  * Actions
  * Projects
  * Security
  * Insights

micheldebree/retrospex

This commit does not belong to any branch on this repository, and may
belong to a fork outside of the repository.
 main
BranchesTags
  
Go to file
Code

Folders and files

      Name              Name          Last commit       Last commit
                                        message            date
Latest commit

 

History

11 Commits
 
.exrc             .exrc                                

.gitignore        .gitignore                           

Makefile          Makefile                             

README.md         README.md                            

dither.go         dither.go                            

go.mod            go.mod                               

go.sum            go.sum                               

imageio.go        imageio.go                           

indexed_image.go  indexed_image.go                     

kmeans.go         kmeans.go                            

main.go           main.go                              

paintface.jpg     paintface.jpg                        

palette.go        palette.go                           

pixels.go         pixels.go                            

quantizer.go      quantizer.go                         

resizer.go        resizer.go                           

retrospec.go      retrospec.go                         

tiler.go          tiler.go                             

View all files

Repository files navigation

  * README

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:

#!/bin/bash
INPUT=madonna

# use https://imagemagick.org to resize and normalize source image
convert ${INPUT}.png -normalize -resize 320x200^ -gravity center -extent 320x200 ${INPUT}01.png

# use retrospex to convert to c64 specs
retrospex -m koala -o ${INPUT}02.png ${INPUT}01.png

# use https://github.com/staD020/png2prg to convert to c64 executable with music
png2prg -v -d -sid Whos_That_Girl.sid ${INPUT}02.png

# open the result in https://vice-emu.sourceforge.io/
x64sc ${INPUT}02.prg

About

Convert images to fit Commodore 64 graphic modes

Resources

Readme
Activity

Stars

25 stars

Watchers

1 watching

Forks

0 forks
Report repository

Releases 1

 
v0.0 Latest
May 5, 2024

Packages 0

No packages published

Languages

  * Go 93.7%
  * Makefile 5.6%
  * Vim Script 0.7%

Footer

 (c) 2024 GitHub, Inc.

Footer navigation

  * Terms
  * Privacy
  * Security
  * Status
  * Docs
  * Contact
  * Manage cookies
  * Do not share my personal information

You can't perform that action at this time.