dkrajzew / c64tools

c64 Python helper.

c64tools

c64tools is a Python library that helps in dealing with Commodore c64 graphics and memory.

You may find more information at http://www.krajzewicz.de/docs/c64tools/index.html.

The major module is named “c64tools.py”. It contains classes that represent major c64 artifacts — memory, bitmap, char, screen, etc. These classes usually support loading, drawing, and being extracted from a pygame surface.

In addition, you may find some applications which use this module:

• a charpacker
• a c64 memory dump to png renderer
• a charset from memory dump extractor
• a linking tool

Download and Installation

The current version is c64tools-0.18.0.

You may install c64tools using

python -m pip install c64tools

You may download a copy or fork the code at c64tools's github page.

Besides, you may download the current release here:

• c64tools-0.18.0.zip
• c64tools-0.18.0.tar.gz

Links

• A complete documentation is located at:
  • https://c64tools.readthedocs.io/en/latest/ and
  • https://krajzewicz.de/docs/c64tools/index.html
• Discussions are open at https://github.com/dkrajzew/c64tools/discussions
• The github repository is located at: https://github.com/dkrajzew/c64tools
• The issue tracker is located at: https://github.com/dkrajzew/c64tools/issues
• The PyPI page is located at: https://pypi.org/project/c64tools/

Note

Let me know if you need any further information or advice. I am not actively developing c64tools currently.

c64tools's Issues

[question] Can charpacker.py used to convert a png into a multicolor charset?

Hi,
I thought I could use charpacker to convert an image (respecting the multicolor constraints) into a set of custom character data and screen memory data ($0400+) and color RAM data ($d800+) but when trying it only found 1 character:

Charpacking succesfull, needed 1 chars.
saving screen...
saving charset...

Did I misunderstand the goal of this script?

add multicolor support for mem2png

Encapsulate I/O helper in a class

mem2png: show only optionally

add Sprite class

Typo in fromC64Screen method

In

def fromC64Screen(self, screen, chars):
    """Filss the bitmap using the given screen and character set information
    
    :param screen: The screen to use
    :param chars: The character set to use
    """
    for yh in range(0, 25):
      for xh in range(0, 40):
        char = screen.getCharAt(xh, yh)

that should be screen.charAt(xh, yh) if I'm not wrong

consolidate APIs