FRANCESCO 
PetPet è un editor PETSCII per computer Commodore 64. Essendo scritto interamente in Python, funziona su qualsiasi piattaforma supportata da Python (Windows, MacOS, Linux e altri).
Perché scegliere PetPet?
| Motivo | Descrizione |
|---|---|
| Script | Nessuna compilazione, facile da modificare, importa ed esporta secondo le tue esigenze |
| Portabile | Disponibile su Linux, MacOS, Windows e qualsiasi altro sistema supportato da Python3 |
Come usare PetPet
Modalità di disegno
Usa il tasto sinistro del mouse per disegnare. Le modalità disponibili sono:
| Modalità | Descrizione |
|---|---|
| Penna | Disegna caratteri e colori |
| Pennello | Disegna solo colori |
| Matita | Disegna solo caratteri |
| Modalità testo | Digita caratteri direttamente dalla tastiera alla posizione del mouse |
| Sfondo | Scegli un colore, poi clicca nell’immagine per cambiare il colore di sfondo ($d021) |
| Bordo | Scegli un colore, poi clicca nell’immagine per cambiare il colore del bordo ($d020) |
Taglia, copia e incolla
Usa il tasto destro del mouse per selezionare un’area. Poi, usa le scorciatoie abituali (CTRL+X, CTRL+C, CTRL+V) per tagliare, copiare e incollare.
Come modificare il layout
Puoi cambiare il layout dei caratteri disponibili nel tuo file di configurazione. In questo file JSON puoi modificare l’array “layout”.
Opzioni da riga di comando
PetPet v1.00 REVISION PARTY 2025 [19.04.2025] *** by fieserWolF
usage: petpet.py [-h] [-p PETSCII_FILENAME] [-c CONFIG_FILENAME] [-f FONT_FILENAME]
Questo è un editor PETSCII. Premi F1 per aiuto nel programma.
options:
-h, --help mostra questo messaggio di aiuto ed esci
-p, --petscii_file PETSCII_FILENAME
nome file PETSCII (.json)
-c, --config_file CONFIG_FILENAME
nome file di configurazione (.json)
-f, --font_file FONT_FILENAME
nome del font (2048 byte)
Esempio: ./petpet.py -p gfx.json -c config.json -f font.bin
Formati file
L’immagine PETSCII è memorizzata nativamente come file json. È disponibile anche l’importazione e l’esportazione in formato binario.
Formato JSON di PetPet
| Oggetto | Chiave | Tipo | Valore |
|---|---|---|---|
| info | program | string | “PetPet” |
| info | version | string | es. “1.0” |
| settings | background | number | colore 0-15 |
| settings | border | number | colore 0-15 |
| settings | font | string | nome file del font |
| settings | grid | boolean | True o False |
| . | char | array di 1000 numeri | caratteri (0-255) |
| . | color | array di 1000 numeri | colori (0-15) |
Formato binario
| Offset | Dimensione in byte | Valore |
|---|---|---|
| 0 | 1000 | caratteri |
| 1000 | 1000 | colori |
| 1001 | 1 | colore di sfondo |
| 1002 | 1 | colore del bordo |
Formato binario PETSCII-EDITOR
| Offset | Dimensione in byte | Valore |
|---|---|---|
| 0 | 2 | indirizzo di partenza $3000 (low, high) |
| 2 | 1000 | caratteri |
| 1002 | 1 | colore del bordo |
| 1003 | 1 | colore di sfondo |
| 1004 | 1 | valore d018(14 o $16) |
| 1029 | 1000 | colori |
Formato JSON di configurazione di PetPet
| Oggetto | Chiave | Tipo | Valore |
|---|---|---|---|
| info | program | string | “PetPet” |
| info | version | string | es. “1.0” |
| settings | background | number | colore 0-15 |
| settings | border | number | colore 0-15 |
| settings | font | string | nome file del font |
| settings | grid | boolean | True o False |
| . | palette | array di 16*3 numeri | valori red, green, blue per ogni colore C64 (default: colori PEPTO) (0-255) |
| . | layout | array di 256 numeri | caratteri (0-255) |
Autore
fieserWolF/Abyss-Connection – lavoro iniziale – https://github.com/fieserWolF https://csdb.dk/scener/?id=3623
Ringraziamenti
-
Logiker per i test e le idee sulle funzionalità
-
Mermaid per il meraviglioso PETSCII intitolato “Gary”
Per iniziare
Installare Python
Prerequisiti
Per eseguire lo script direttamente sono necessari:
-
Python 3
-
modulo python tkinter
-
modulo python json
-
libreria python “argparse”
Installare Python su Linux
Su Debian GNU/Linux si può usare apt-get per installare tutto il necessario:
apt update apt install python3 python3-tk
In alternativa, puoi usare pip per installare i moduli mancanti:
pip3 install tk argparse json
Installare Python su Windows o Mac
-
Scarica Python da https://www.python.org
-
Installa Python sul tuo computer
Scaricare PetPet
-
Clicca sul pulsante verde “Code” e “Download ZIP”
-
Estrai il file ZIP scaricato in qualsiasi cartella
Changelog
Piani futuri
Ogni tipo di aiuto e supporto è molto apprezzato.
Se hai una richiesta di funzionalità, un report di bug o se vuoi offrire aiuto, contattami:
Cambiamenti nella 1.01
-
Migliorato il riquadro di selezione
-
Aggiunta modalità scrittura
-
Miglioramenti all’interfaccia grafica
-
Esporta in eseguibile per C64
-
Documentazione migliorata https://github.com/fieserWolF/petpet
