File library¶
The file library allows to save the screen or a window on a file, and to load it back into the frame-buffer.
Three options write and read dynamically at run-time.
-
The BMP binary file option writes and reads a BMP binary file to and from the SD-card.
-
The portable pixmap PBM binary file option writes and reads a portable pixmap binary file to and from the SD-card.
-
The frame-buffer binary file option writes and reads a frame-buffer binary file to and from the SD-card.
Four options saves a header file dynamically at run-time, which needs to be included into an application statically at build-time.
-
The image header file option saves a header file to the SD-card.
-
The 16-bit image header file option saves a header file to the SD-card.
-
The portable pixmap P4 header file option saves a header file to the SD-card.
-
The frame-buffer header file option saves a header file to the SD-card.
To summarise,
| Format | Name | Save to file | Read at | Screens |
|---|---|---|---|---|
| BMP | BMP |
Binary | Run-time | Monochrome and colour |
| Pixmap | PBM |
Binary | Run-time | Monochrome only |
| Frame-buffer | Frame |
Binary | Run-time | Monochrome only |
| Image | Image |
Header | Build-time | Monochrome only |
| Image | Image16 |
Header | Build-time | Monochrome and colour |
| Pixmap | P4 |
Header | Build-time | Monochrome only |
| Frame-buffer | Buffer |
Header | Build-time | Monochrome and colour |
Configure¶
Warning
The file operations on SD-card require the external SD library .
Ensure the external SD-card library is installed and configured properly.
Use¶
Select one of the four options for the file library:
-
Write and read screen content as BMP binary file dynamically at run-time on an SD-card;
-
Write and read screen content as portable pixmap PBM binary file dynamically at run-time on an SD-card;
-
Write and read screen content as frame-buffer binary file dynamically at run-time on an SD-card;
-
Save screen content as image header file dynamically at run-time on an SD-card, to be included in an application statically at build-time;
-
Save screen content as 16-bit image header file dynamically at run-time on an SD-card, to be included in an application statically at build-time;
-
Save screen content as portable pixmap P4 header file dynamically at run-time on an SD-card, to be included in an application statically at build-time;
-
Save screen content as frame-buffer header file dynamically at run-time on an SD-card, to be included in an application statically at build-time.