[MSX] NMENU 1.00: Un Programma di Menu Semplice e Personalizzabile per MSX-DOS

NMENU è un’utility per MSX-DOS 2 (o superiore) che permette di creare menu navigabili semplici ed eleganti. Ideale per organizzare e lanciare i tuoi programmi preferiti, file batch, ROM (tramite loader come SROM.COM) o persino altri file INI di NMENU per creare menu annidati o multi-pagina.

Autrice: Natalia Pujol Cremades (NataliaPC)
Licenza: MIT License

Indice

1. Introduzione

2. Caratteristiche

3. Requisiti

4. Utilizzo

5. Configurazione (NMENU.INI)

6. Controlli

7. Compilazione dai sorgenti

8. Librerie di terze parti

9. Guida dettagliata

Introduzione

NMENU offre un modo personalizzabile per organizzare e avviare i tuoi programmi su MSX-DOS. Progettato per MSX2 e superiori, sfrutta le capacità grafiche della macchina per creare menu intuitivi e visivamente accattivanti.

Tutto ciò che serve è un file di configurazione INI, dove definire testo, posizioni, colori e comandi da eseguire.

Caratteristiche

✅ Menu personalizzabili – Definisci voci di menu, testo e azioni.
✅ Esecuzione programmi – Lancia file .COM, .BAT o ROM (tramite loader).
✅ Menu annidati – Collegamenti a file INI per creare sottomenu o pagine multiple.
✅ Sfondi grafici – Supporto per immagini SCREEN 7 (.SC7).
✅ Sfondi ANSI Art – Supporto per file .ANS (arte ASCII/ANSI).
✅ Sfondi a tinta unita – Imposta un colore di sfondo semplice.
✅ Musica di sottofondo – Riproduzione di file LVGM (.LVM) (progetto MSXgl).
✅ Aspetto personalizzabile – Colori di testo e sfondo per voci normali e selezionate.
✅ Layout flessibile – Posiziona le voci di menu liberamente sullo schermo.

Requisiti

• MSX-DOS 2 (o versione superiore).

• Computer MSX2 o superiore (non compatibile con MSX1).

Utilizzo

Per avviare NMENU, usa il seguente comando da MSX-DOS:

NMENU <PERCORSO_FILE_INI>

• <PERCORSO_FILE_INI>: Il percorso del file INI da caricare.

• Se non specificato, NMENU cercherà NMENU.INI nella directory corrente.

Esempio:

A:>NMENU GAMES.INI

Configurazione (NMENU.INI)

Il file INI è strutturato in sezioni:

1. [Background]

Definisce lo sfondo del menu:

• bg.color – Colore ANSI di sfondo.

• bg.file.sc7 – Percorso di un’immagine SC7.

• bg.file.ansi – Percorso di un file ANSI.

2. [Settings]

Impostazioni generali:

• music.lvgm – Percorso di un file LVGM per la musica.

• option.fr.color / option.bg.color – Colori predefiniti delle voci.

• selected.fr.color / selected.bg.color – Colori della voce selezionata.

3. [Options]

Definisce le voci del menu:

• posx, posy – Coordinate (1-based) del testo.

• text – Testo da visualizzare.

• exec – Comando da eseguire (es. SROM GAME.ROM, PROGRAM.COM, SUBMENU.INI).

• next – Fine della definizione della voce.

Esempio di NMENU.INI:

[Background]
bg.color=44            ; Sfondo blu
bg.file.sc7=bg3.sc7    ; Immagine SC7

[Settings]
music.lvgm=music/theme.lvm
option.fr.color=30     ; Testo nero
option.bg.color=42     ; Sfondo verde
selected.fr.color=1;37 ; Testo bianco brillante (selezionato)
selected.bg.color=44   ; Sfondo blu (selezionato)

[Options]
posx=5
posy=3
text=Avvia Gioco Alpha
exec=srom roms/alpha.rom
next

posx=5
posy=5
text=Esegui Utility
exec=utils/tool.com
next

Controlli

• ↑ / ↓ – Muovi la selezione tra le voci.

• INVIO / SPAZIO / Pulsante Joystick 1/A – Esegui la voce selezionata.

• ESC – Interrompi la musica ed esci da NMENU.

Compilazione dai sorgenti

Per compilare NMENU dai sorgenti, consulta il file README.md nel repository GitHub.

Librerie di terze parti

NMENU utilizza:

• LVGM Player per la riproduzione musicale (da MSXgl).

Guida dettagliata

Per una spiegazione completa del formato INI, codici colore e posizionamento avanzato, consulta il file NMENU.HLP incluso nella release.

📥 Scarica l’ultima versione:
👉 https://github.com/nataliapc/msx_nmenu/releases

NMENU è uno strumento perfetto per organizzare la tua collezione MSX in modo elegante e funzionale! 🚀