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

FRANCESCO 10/05/2025 3 min read

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

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