[C64] PetPet 1.01 : Editor PETSCII per Commodore 64

FRANCESCO

4 giorni fa

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 $d 018 ($ 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

Vai su https://github.com/fieserWolF/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

Condividi su :