BBC Screen Conversion Utilities =============================== J.G.Harston - (C)1999, 2010, 2014, 2018 mdfs.net/Apps/Graphics/Conversion 70 Camm Street, Walkley, Sheffield S6 3TR BBCtoBMP -------- Syntax: BBCtoBMP -m -l -r -s -b -c -u -v Runs on BBC, Master, RISC OS, DOS and Windows. Converts a BBC graphics screen image (MODEs 0 to 6) to a Windows bitmap file. Will also read a compressed screen image and palette information stored with *ScrSave and *SVPIC. The source screen image file can be smaller than a whole screen, and will be rounded to a whole number of character lines (a whole multiple of 8 pixel lines). Various options and switches can be used, which can be abbreviated to a single letter: -mode Specifies the screen mode the source file is saved for and the default palette. If the mode and palette information is available in the source file then the -mode option can be omitted. If the -mode option is used it overrides the mode specified in the file. -ldpic The source file will be read as a LDPIC compressed screen image, including any 12-bit extended palette data. -raw The source file is a raw memory dump. -border Add a border around the saved image, creating a 672x544 or 336x272 pixel image. -compress Create an RLE compressed bitmap file. This is the default action. If attempting to create a compressed file would actually create a larger file, an uncompressed file is created. -uncompress Create an uncompressed bitmap file. -small Small resolution screen modes (those other than MODE 0 and MODE 3) are output as 320x256 pixel images instead of as 640x512 pixel images. -verbose A countdown of converted pixel lines is displayed. -quit Execute a command when finished. If the starts with a '*' then it is passed to OSCLI, otherwise it is CHAINed. -? Displays a summary of the command line parameters. On DOS/Windows if a '.inf' file is present, then the load and execution addresses are read from it. The '.inf' file will also be read on BBC/RISC OS if the source file's load and execution addresses are both zero. On exit, OSBYTE 1 or the DOS ERRORLEVEL is set to the return value, which will be 0 if no errors occured. BMPtoBBC -------- Syntax: BMPtoBBC -m -i -v Runs on BBC, Master, RISC OS, DOS and Windows. Converts a Windows bitmap file to a BBC graphics screen image (MODEs 0 to 6). Will also store palette information in load and execution addresses readable with *ScrLoad. If the bitmap is not 640 pixels wide, then unpredicatable results will occur. On DOS/Windows a '.inf' file is created containing the load and execution addresses containing the palette information. A '.inf' file will also be created on BBC/RISC OS if the -inf switch is used. Various options and switches can be used, which can be abbreviated to a single letter: -mode Specifies the screen mode the bitmap file represents. If the source bitmap is a dump of a MODE 0 to 2 screen, then BMPtoBBC can work this out, and the -mode option can be omitted. -inf Create a '.inf' file containg the file's palette information. -verbose A countdown of converted pixel lines is displayed. -quit Execute a command when finished. If the starts with a '*' then it is passed to OSCLI, otherwise it is CHAINed. -? Displays a summary of the command line parameters. On exit, OSBYTE 1 or the DOS ERRORLEVEL is set to the return value, which will be 0 if no errors occured. *BMPSave -------- Syntax: *BMPSave Saves a BBC graphics screen image (MODEs 0 to 6) as a Windows BitMap file. There is no -small switch, all screens are saved as 640x512 pixel images, and images are saved uncompressed. File sizes ---------- The following table lists the maximum resultant BitMap file size for uncompressed files. Compressed files may be smaller than this depending on how much the screen data can be compressed, and screen dumps that are smaller than a full screen will also be smaller. MODE Pixels 0 1 2 3 4 5 6 640x512 40K 160K 160K 40K 40K 160K 40K 320x256 - 40K 40K - 10K 40K 10K History ------- BBCtoBMP, BMPtoBBC: v1.00 18-Jun-1999 Initial version. v1.01 12-Jul-1999 Reads ScrSave compressed files and palettes. v1.02 11-Jul-2009 Made Windows binary. v1.03 19-Jul-2009 Reads and writes .inf files, -s option for BBCtoBMP. v1.04 17-Jul-2010 Can parse "quoted" command line parameters. v1.05 22-Aug-2010 BBCtoBMP -small works for MODE 0-2 v1.06 07-Oct-2010 BBCtoBMP creates compressed bitmaps, has -uncompressed option. v1.07 10-Mar-2018 BBCtoBMP supports LDPIC/SVPIC compressed files. v1.08 23-Apr-2018 2-colour MODEs can be compressed, -border option added. v1.09 15-May-2018 With low memory raw screen can use faster line buffer. *BMPSave: v1.00 12-Jul-2010 Non-shadow MODE 0. v1.01 16-Jun-2010 Non-shadow MODE 0 and MODE 1. v1.02 16-Jun-2010 Can output small pixels. v1.03 16-Jun-2010 MODE 2, and shadow screen modes v1.04 12-Jun-2014 Checks if overwriting Master NetFS WS. v1.05 14-Jun-2014 Code moved to avoid Master NetWS workspace, MODEs 3-6 work, no zebra stripes, removed small pixel code. v1.06 16-Jun-2014 Zebra stripes work.