GIMP script to export bitmap as GRAPHICS 4 file (a.k.a. "SCREEN 5"). GRAPHICS 4 specs are:

• 4 pages;
• 256x1024 image (256 per page) with a 256x212 or 256x192 viewport;
• 16 color palette (from 512);
• sprite mode 2;

Plug-in is accessible through Filters > MSX >> Export GRAPHICS 4 bitmap. You may disable Image Encoding altogether to create an image inside GIMP and not export it to disk at all. In this case, the plug-in doesn't check image size. But be warned: big images tend to take a very. Long. Time.

• Change permission to execute the file:
  • chmod +x gimpfu_msx_g4.py
• Put the file into your GIMP plugin directory:
  • if you installed GIMP as a normal package, it's ~/.config/GIMP/2.10/plug-ins/;
  • if you installed GIMP as a flatpak package, it's ~/.var/app/org.gimp.GIMP/config/GIMP/2.10/plug-ins/;
• Restart GIMP

You may load files created by this plug-in using this simple code in BASIC:

10 SCREEN 5
20 REM use line below if transparency is disabled
30 VDP(9)=VDP(9) OR &H20
40 BLOAD"NONAME.SC5",S
50 COLOR=RESTORE
60 IF INKEY$ = "" GOTO 60

File (NONAME.SC5) contains the pattern and palette data. If image height is 237 pixels or more, the palette data will overwrite the pattern data. It's recommended to use SR5 with a separate palette file in this case.

Loading SR5 files is just a little different in BASIC:

10 SCREEN 5
20 REM use line below if transparency is disabled
30 VDP(9)=VDP(9) OR &H20
40 BLOAD"NONAME.PAL",S
50 COLOR=RESTORE
60 BLOAD"NONAME.SR5",S
70 IF INKEY$ = "" GOTO 70

The first file (NONAME.PAL) is the palette and the second file (NONAME.SR5) is the pattern data and you need both to get the right image.

DAT (DATA) files are copies of portions of the screen dumped to a disk file. They are created by MSX-BASIC COPY command and are limited to a maximum of 212 pixels height. Loading DAT files in BASIC is easy:

10 SCREEN 5
20 REM use line below if transparency is disabled
30 VDP(9)=VDP(9) OR &H20
40 BLOAD"NONAME.PAL",S
50 COLOR=RESTORE
60 COPY "NONAME.DAT" TO (0,0), 0
70 IF INKEY$ = "" GOTO 70

A palette file (NONAME.PAL) is still recommended to restore the image properly.

• ordered dithering;
• make it faster (dithering is very slow and stupidly unoptimised);
• enable or disable transparent colour;
• palette export;
• RGB to indexed conversion;
• export raw file to be used by external compressors;
• ignore alpha channel instead of triggering errors;
• embedded palette support;
• MSX-BASIC COPY to disk format support;
• RLE encoding;
• aPLib compression;
• converting layers into pages;