ZX-V v0.4.0

ZX-V, a 32-bit hobby computer inspired by the ZX Spectrum. (Español más abajo.)

What's new in 0.4.0

Three new games, on the ROM: drive and in the examples folder:

• Muncher, a maze game in BASIC: four chasers, each hunting you in its own way, power pills, fruit, levels and a demo, at 50 frames per second with a tile map and sprites. LOAD "muncher".
• The Mine, a digging game in C: boulders and diamonds that fall and roll, creatures that follow the walls, growing moss and twelve caves bigger than the screen, with smooth scrolling. LOAD "mine".
• Street Justice, a street brawler in C: fighters drawn by the graphics engine from a skeleton in poses, depth, grabs and a boss in each of the three stages. LOAD "street".

The other games:

• Route 128 has manual gears, as in the arcades: Z (or button 3, or Select on a gamepad) changes between LO, which pulls hard up to about 193 km/h, and HI, which reaches 290 but hardly pulls below 120.
• Sentry can be played without a mouse (the cursor keys or a gamepad), and Estela is easier.
• The game help pages say O, P, Q, A, the Spectrum order.

BASIC:

• Long programs run much faster: BASIC remembers where it last found each line and each variable, instead of searching from the start every time.
• The full-screen editor also works in mode 0: Mode 0 in the EDIT menu gives 32 × 24 double-size characters, as on the 128K.

The emulator:

• View > Border chooses how much border you see (full, medium, small or none), and View > Scaling how the picture fills the window: keeping the proportions, at an exact multiple or filling it all. The web version has both in View > Options.
• View > Size also works with the window maximised.
• The packages bring the documentation in HTML, to read offline: docs/index.html, or Help > Documentation.
• Linux has an AppImage, with Qt and SDL inside: it runs on most distributions without installing anything.

Names, licences and this repository:

• Programs and folders have English names now: hello, graphics, files, boardtest, route128, sentry, platformer, rps...
• The SDK, the examples and the documentation are in this repository: the SDK and the examples under the MIT licence, the documentation under CC BY 4.0. The binaries are free and can be passed on unchanged (TERMS.txt).
• BASIC programs can also be compiled to native programs with ZX Basic: see Compiling BASIC.
• The web version is also online, nothing to download: cronomantic.github.io/ZX-V.

File	Contents
zxv-windows-x64.zip	The emulator for Windows: the zxv app (with the ROM inside), zxv-sdl, zxv-cli, sdimg, the examples and the documentation. Unzip it and open zxv.exe
ZX-V-0.4.0-x86_64.AppImage	The emulator for Linux in a single file: make it executable and run it
zxv-linux-x86_64.tar.gz	The same for Linux (x86-64) as a folder, using the system's Qt 6 and SDL 2
zxv-web.zip	The web version: unzip it and open index.html (no server needed), or upload it as it is to a website or to itch.io
zxv-uf2.zip	The firmware for the two Pico 2 boards (.uf2): which file goes on each board is in the firmware guide

The first time it runs, zxv creates a ZX-V folder in your Documents, which acts as the SD card, with the examples in it. Start with the getting started guide.

---

ZX-V, un ordenador de 32 bits para aficionados, inspirado en el ZX Spectrum.

Novedades de la 0.4.0

Tres juegos nuevos, en la unidad ROM: y en la carpeta de los ejemplos:

• Muncher, un juego de laberinto en BASIC: cuatro perseguidores, cada uno con su forma de buscarte, píldoras, fruta, niveles y demostración, a 50 imágenes por segundo con un mapa de tiles y sprites. LOAD "muncher".
• The Mine, un juego de cavar en C: piedras y diamantes que caen y ruedan, bichos que siguen las paredes, musgo que crece y doce cuevas más grandes que la pantalla, con scroll suave. LOAD "mine".
• Street Justice, un juego de peleas callejeras en C: luchadores que dibuja el motor gráfico a partir de un esqueleto en poses, profundidad, agarres y un jefe en cada una de las tres fases. LOAD "street".

Los demás juegos:

• Route 128 tiene marchas a mano, como en las recreativas: Z (o el botón 3, o Select en un mando) cambia entre LO, que tira fuerte hasta unos 193 km/h, y HI, que llega a 290 pero por debajo de 120 apenas tira.
• Sentry se puede jugar sin ratón (con los cursores o un mando), y Estela es más fácil.
• La ayuda de los juegos dice O, P, Q, A, el orden del Spectrum.

El BASIC:

• Los programas largos van mucho más deprisa: el BASIC recuerda dónde encontró la última vez cada línea y cada variable, en vez de buscarlas desde el principio cada vez.
• El editor a pantalla completa también funciona en modo 0: Modo 0 en el menú EDIT da 32 × 24 caracteres de letra doble, como en el 128K.

El emulador:

• Ver > Borde elige cuánto borde se ve (completo, mediano, pequeño o ninguno), y Ver > Escalado, cómo llena la imagen la ventana: manteniendo la proporción, a un múltiplo exacto o llenándola entera. La versión web tiene los dos en Ver > Opciones.
• Ver > Tamaño funciona también con la ventana maximizada.
• Los paquetes traen la documentación en HTML, para leerla sin conexión: docs/index.html, o Ayuda > Documentación.
• Linux tiene una AppImage, con Qt y SDL dentro: funciona en casi todas las distribuciones sin instalar nada.

Nombres, licencias y este repositorio:

• Los programas y las carpetas se llaman ahora en inglés: hello, graphics, files, boardtest, route128, sentry, platformer, rps...
• El SDK, los ejemplos y la documentación están en este repositorio: el SDK y los ejemplos con la licencia MIT, la documentación con CC BY 4.0. Los binarios son gratis y se pueden repartir sin cambios (TERMS.txt).
• Los programas en BASIC también se pueden compilar a programas nativos con ZX Basic: ver Compilar BASIC.
• La versión web está también en línea, sin descargar nada: cronomantic.github.io/ZX-V.

Fichero	Contenido
zxv-windows-x64.zip	El emulador para Windows: la aplicación zxv (con la ROM dentro), zxv-sdl, zxv-cli, sdimg, los ejemplos y la documentación. Se descomprime y se abre zxv.exe
ZX-V-0.4.0-x86_64.AppImage	El emulador para Linux en un solo fichero: se le da permiso de ejecución y se abre
zxv-linux-x86_64.tar.gz	Lo mismo para Linux (x86-64) en una carpeta, con el Qt 6 y el SDL 2 del sistema
zxv-web.zip	La versión web: se descomprime y se abre index.html, sin servidor, o se sube tal cual a una web o a itch.io
zxv-uf2.zip	El firmware de las dos Pico 2 (.uf2): qué va en cada placa está en la guía del firmware

La primera vez, zxv crea la carpeta ZX-V en Documentos, que hace de tarjeta SD, con los ejemplos. Empieza por la guía de primeros pasos.