Dither me like one of your French girls.
Ditheridoo is a multicolor bitmap editor for Commodore 64. It runs on 64 bit versions of Linux, MacOS, Windows and other systems supported by Python.
| reason | description |
|---|---|
| open source | easy to modify and to improve, any useful contribution is highly welcome |
| portable | available on Linux, MacOS, Windows and any other system supported by Python3 |
| easy dithering | checkerboard, x-line, y-line, light dither modes available, more might be implemented in the future |
| interesting for coders | total control which values are set in draw-modes "select color" and "dye", see built-in help or cheatsheet.md for details |
For a list of quick keyboard shortcuts and other information see file cheatsheet.md or the full documentation in /doc.
The multicolor bitmap is stored in the widely-spread KoalaPainter (C64) format:
- 2 bytes load address
- 8000 bytes raw bitmap data
- 1000 bytes raw "Video Matrix" (screen) data
- 1000 bytes raw "Color RAM" data
- 1 byte background data
- fieserWolF/Abyss-Connection - code, graphics - https://github.com/fieserWolF https://csdb.dk/scener/?id=3623
- The Mysterious Art/Abyss-Connection - graphics - https://csdb.dk/scener/?id=3501
- Pararaum/The 7th Division - example image - https://csdb.dk/scener/?id=31223
- Mirage/Booze Design - example image - https://csdb.dk/scener/?id=739
Ditheridoo comes in two flavors:
- standalone executable for 64-bit systems Linux, MacOS/Darwin and Windows (see releases)
- Python3 script
Just download your bundle at releases and enjoy. Keep in mind that only 64bit systems are supported as I could not find a 32bit system to generate the bundle.
If some antivirus scanner puts Ditheridoo into quarantine because it suspects a trojan or virus, simply put it out there again. It isn`t harmful, I used PyInstaller to bundle the standalone executable for you. Unfortunately, the PyInstaller bootloader triggers a false alarm on some systems. I even tried my best and re-compiled the PyInstaller bootloader so that this should not happen anymore. Keep your fingers crossed ;)
Your system might complain that the code is not signed by a certificated developer. Well, I am not, so I signed the program on my own.
"Ditheridoo" can`t be opened because it is from an unidentified developer.
You need to right-click or Control-click the app and select “Open”.
Download ditheridoo.py and the whole resource - directory into the same folder on your computer.
At least this is needed to run the script directly:
- python 3
- python tkinter module
- python "The Python Imaging Library" (PIL)
Normally, you would use pip like this:
pip3 install tk pillow
On my Debian GNU/Linux machine I use apt-get to install everything needed:
apt-get update
apt-get install python3 python3-tk python3-pil python3-pil.imagetk
- implement sanity check: accept only standard koala format files
- implement real undo for all functions
- implement hires drawing mode
- implement different pencil sizes
- implement: freely adjustable edit window
- maybe: preview window: indicate current view with a visible frame
- maybe: preview window: move visible frame by dragging the mouse
- maybe: "draw mode: select": avoid moving of the controls
Any help and support in any form is highly appreciated.
If you have a feature request, a bug report or if you want to offer help, please, contact me:
http://csdb.dk/scener/?id=3623 or wolf@abyss-connection.de
- initial release
Ditheridoo multicolor bitmap editor for Commodore 64.
Copyright (C) 2021 fieserWolF / Abyss-Connection
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.
See the LICENSE file for details.
For further questions, please contact me at http://csdb.dk/scener/?id=3623 or wolf@abyss-connection.de
For Python3, The Python Imaging Library (PIL), Tcl/Tk and other used source licenses see file LICENSE_OTHERS.