Difference between revisions of "File Formats"

From SpecNext official Wiki
Jump to: navigation, search
m (Typo fixed)
(→‎Supported File Formats in NextZXOS)
(13 intermediate revisions by 5 users not shown)
Line 1: Line 1:
−
The NextZXOS can directly read and load these kind of files: bas, tap, z80, sna, snx, dot, o, p. Many other file types are supported by the use of external dot commands.
+
== Supported File Formats in NextZXOS ==
  
−
* '''[https://www.worldofspectrum.org/faq/reference/z80format.htm .z80]''' is a Spectrum snapshot file, more suitable as emulator compatibility than a real format. Files can be loaded using the NextZXOS browser, the NextZXOS SPECTRUM keyword, the esxDOS NMI menu, and the exDOS .snapload command.
+
NextZXOS can directly read and load the following file types: `.bas`, `.tap`, `.z80`, `.sna`, `.snx`, `.dot`, `.o`, `.p`. Many other file types are supported via external dot commands.
−
* '''[https://faqwiki.zxnet.co.uk/wiki/SNA_format .sna]''' is a Spectrum snapshot file, more suitable as emulator compatibility than a real format. Both 48K and 128K SNA files are supported. Files can be loaded using the NextZXOS browser, the NextZXOS SPECTRUM keyword, the esxDOS NMI menu, and the exDOS .snapload command. When loading in NextZXOS, any private data appended to the file is ignored during loading, and the program code may later read it by reopening itself using a hardcoded filename. If private data is appended to them then they cannot be loaded by esxDOS.
+
 
−
* '''.snx''' is a Spectrum snapshot file, more suitable as emulator compatibility than a real format. It is identical to a 128K .sna file, but when loaded using the browser or the SPECTRUM command, NextZXOS leaves file handle 0 open for further use by the program. The program is expected close the handle before exiting. .snx files may also have private data appended to them. They are not supported by esxDOS.
+
{| class="wikitable sortable"
−
* '''.o''' is a ZX80 snapshot
+
! File Extension !! Description !! Notes
−
* '''.p''' is a ZX81 snapshot
+
|-
−
* '''[[NEX file format|.nex]]''' is good for a program that takes over the machine. With some care, it can also be used to load a program without overwriting sysvars, allowing NextZXOS API calls to be used. It can be loaded using the NextZXOS file browser and the .nexload dot command. The [[Emulators|CSpect]] emulator can open .nex files natively from the F2 dialog. esxDOS cannot open .nex files.
+
| .z80 || Spectrum snapshot file || More suitable for emulator compatibility than real hardware. Loadable via NextZXOS browser, SPECTRUM keyword, esxDOS NMI menu, and exDOS `.snapload` command.
−
* '''.dot''' is good for dot commands and programs that can coexist with BASIC/NextZXOS and can return to BASIC safely (i.e. counterpart to nex)
+
|-
−
* '''[[TAP file format|.tap]]''' is a simple container format that can hold many files, is compatible with emulators and supported by many tools. When loading .tap files using the NextZXOS browser, a menu is displayed asking whether you want to load in standard, USR0 or 48K mode.
+
| .sna || Spectrum snapshot file || Supports 48K and 128K. Loadable via browser, SPECTRUM keyword, esxDOS NMI, and `.snapload`. Private data appended is ignored by NextZXOS but prevents loading via esxDOS. NextZXOS reconfigures system based on file type.
−
* '''.bas''' is the native SD-card format for BASIC programs (first 128 bytes of the file form standard +3DOS header).
+
|-
−
* .'''scr''' is used for a standard Spectrum screenshot created with ''SAVE "picture.scr" SCREEN$'' (256x192, 15 colours per character cell).  
+
| .snx || Spectrum snapshot file || Identical to 128K .sna, but leaves file handle 0 open. Program must close it. May contain private data. Not supported by esxDOS.
−
* '''.shc''' is used for a screenshot in Timex 8x1 Hi-colour mode (256x192, 15 colors).
+
|-
−
* '''.shr''' is used for a screenshot in Timex Hi-res mode (512x192, mono).
+
| .o || ZX80 snapshot || —
−
* '''.slr''' is used for a lo-res screenshot (128x96, 256 colours).
+
|-
−
* '''.sl2''' is used for a Layer 2 screenshot (256x192, 256 colour).
+
| .p || ZX81 snapshot || —
−
* '''.pal''' is a 9-bit palette format (256 pairs of bytes in %RRRGGGBB, %P000000B format). Files can be loaded and saved from the Screenshots menu in NextZXOS after pressing the M1 button or F9. The P bit sets priority when used in layer 2 palettes. Palette entries with P=1 cause their pixels to appear above everything else, regardless of globally-set layer priorities.
+
|-
−
* '''.npl''' is a 9-bit palette format. The first 512 bytes are identical to a .pal file. The 513th byte designates transparency - for sprite palettes, the transparency byte is a real index, and for other palettes it is a colour mask. .npl files can be created, saved and loaded by [[Miscellaneous#WASPtools|WASPtools]].
+
| [[NEX_file_format|.nex]] || Next executable file || Takes over machine. Can coexist with NextZXOS if careful. Loadable via browser and `.nexload`. CSpect emulator supports loading. Not supported by esxDOS.
 +
|-
 +
| .dot || Dot command format || For programs that coexist with BASIC/NextZXOS and return safely.
 +
|-
 +
| .tap || Tape container format || Holds many files, emulator-compatible. Browser prompts for load mode: standard, USR0, or 48K.
 +
|-
 +
| .bas || BASIC program || Native SD card format for BASIC programs. First 128 bytes are standard +3DOS header.
 +
|-
 +
| .scr || Standard Spectrum screenshot || 256x192, 15 colours, 2 per cell. Headered files (7,040 bytes) or headerless (6,912 bytes). Both are supported.
 +
|-
 +
| .shc || Timex 8x1 Hi-colour screenshot || 256x192, 15 colours.
 +
|-
 +
| .shr || Timex Hi-res screenshot || 512x192, mono.
 +
|-
 +
| .slr || Low-res screenshot || 128x96, 256 colours.
 +
|-
 +
| .sl2 || Layer 2 screenshot || 256x192, 256 colours. 128-byte +3DOS header + 49,152 bytes of pixel data. No palette data.
 +
|-
 +
| .pal || 9-bit palette format || 256 pairs of bytes in %RRRGGGBB, %P000000B format. Priority bit (P) causes pixel layering. Loadable via Screenshots menu (M1 or F9).
 +
|-
 +
| .npl || Extended palette format || First 512 bytes identical to .pal. Byte 513 is transparency index or mask. Created and loaded via WASPtools.
 +
|-
 +
| .nxi || Layer 2 screen format || 49,152 bytes = screen data. 49,664 bytes = screen + palette. Used by PLOTIT, Dnext, zxnext_bmp_tools, and Jim Bagley’s tools.
 +
|-
 +
| .vid || Video format || Played via `.playvid`. Formats supported:
 +
* 320x240 @ 16.7fps, 15.6kHz
 +
* 256x240 @ 16.7fps, 31.1kHz
 +
* 256x192 @ 25fps, 23kHz
 +
A tool for converting video files to .vid can be found here https://github.com/em00k/MakeVid-Release
 +
|}
 +
 
 +
=== Special Notes ===
 +
* The `.tzx` format is recognised by the browser, but files can only be loaded if a Raspberry Pi is installed in your Next. See the FAQ for details.

Revision as of 17:32, 5 April 2025

Supported File Formats in NextZXOS

NextZXOS can directly read and load the following file types: `.bas`, `.tap`, `.z80`, `.sna`, `.snx`, `.dot`, `.o`, `.p`. Many other file types are supported via external dot commands.

File Extension Description Notes
.z80 Spectrum snapshot file More suitable for emulator compatibility than real hardware. Loadable via NextZXOS browser, SPECTRUM keyword, esxDOS NMI menu, and exDOS `.snapload` command.
.sna Spectrum snapshot file Supports 48K and 128K. Loadable via browser, SPECTRUM keyword, esxDOS NMI, and `.snapload`. Private data appended is ignored by NextZXOS but prevents loading via esxDOS. NextZXOS reconfigures system based on file type.
.snx Spectrum snapshot file Identical to 128K .sna, but leaves file handle 0 open. Program must close it. May contain private data. Not supported by esxDOS.
.o ZX80 snapshot —
.p ZX81 snapshot —
.nex Next executable file Takes over machine. Can coexist with NextZXOS if careful. Loadable via browser and `.nexload`. CSpect emulator supports loading. Not supported by esxDOS.
.dot Dot command format For programs that coexist with BASIC/NextZXOS and return safely.
.tap Tape container format Holds many files, emulator-compatible. Browser prompts for load mode: standard, USR0, or 48K.
.bas BASIC program Native SD card format for BASIC programs. First 128 bytes are standard +3DOS header.
.scr Standard Spectrum screenshot 256x192, 15 colours, 2 per cell. Headered files (7,040 bytes) or headerless (6,912 bytes). Both are supported.
.shc Timex 8x1 Hi-colour screenshot 256x192, 15 colours.
.shr Timex Hi-res screenshot 512x192, mono.
.slr Low-res screenshot 128x96, 256 colours.
.sl2 Layer 2 screenshot 256x192, 256 colours. 128-byte +3DOS header + 49,152 bytes of pixel data. No palette data.
.pal 9-bit palette format 256 pairs of bytes in %RRRGGGBB, %P000000B format. Priority bit (P) causes pixel layering. Loadable via Screenshots menu (M1 or F9).
.npl Extended palette format First 512 bytes identical to .pal. Byte 513 is transparency index or mask. Created and loaded via WASPtools.
.nxi Layer 2 screen format 49,152 bytes = screen data. 49,664 bytes = screen + palette. Used by PLOTIT, Dnext, zxnext_bmp_tools, and Jim Bagley’s tools.
.vid Video format Played via `.playvid`. Formats supported:
  • 320x240 @ 16.7fps, 15.6kHz
  • 256x240 @ 16.7fps, 31.1kHz
  • 256x192 @ 25fps, 23kHz

A tool for converting video files to .vid can be found here https://github.com/em00k/MakeVid-Release

Special Notes

  • The `.tzx` format is recognised by the browser, but files can only be loaded if a Raspberry Pi is installed in your Next. See the FAQ for details.
Retrieved from ‘http://wiki.specnext.dev/index.php?title=File_Formats&oldid=13437’