Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/bemxio/image-render-bootloader
A bootloader for rendering an image in 256-color VGA mode
https://github.com/bemxio/image-render-bootloader
assembly bios bootloader dithering image nasm python rendering
Last synced: about 1 month ago
JSON representation
A bootloader for rendering an image in 256-color VGA mode
- Host: GitHub
- URL: https://github.com/bemxio/image-render-bootloader
- Owner: bemxio
- License: mit
- Created: 2023-05-24T15:46:22.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-01-23T14:12:51.000Z (11 months ago)
- Last Synced: 2024-01-23T15:32:34.032Z (11 months ago)
- Topics: assembly, bios, bootloader, dithering, image, nasm, python, rendering
- Language: Python
- Homepage:
- Size: 15.6 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# image-render-bootloader
A bootloader designed to render an image in 256-color VGA mode.
Uses Floyd-Steinberg dithering to convert a regular RGB image into the data that can be displayed in 256-color VGA mode.
## Usage
To build the bootloader in the easiest way, just follow the instructions below.
You can do it the manual way with an assembler and GIMP but then, you're on your own.
### Installing dependencies
For Windows, you can install [`scoop`](https://scoop.sh/) and use it to install the necessary packages:
```powershell
scoop install nasm make python
```
As for Linux, all of the packages should be in your default package manager. Here's an example for Debian-based distros:
```bash
sudo apt install nasm make python3
```
After that, use `pip` to install [Pillow](https://pypi.org/project/pillow/):
```bash
pip install pillow
```
If you want to run the bootloader, you need to install QEMU as well, which can be done with either `scoop install qemu` or `sudo apt install qemu`, depending on your OS.
### Building
Before building the bootloader, you will need to do a couple of things.
1. Download the image to be displayed, it can be anything you like. Just remember that the color palette is limited to 256 colors, thus some colors might not look that good.
2. Open the [`Makefile`](Makefile) and edit variables according to your configuration. The one you will most likely need to change is `IMAGE_PATH`, which should be set to the path of the image you downloaded in the previous step.
3. Simply run `make` in the root directory of the project.
This will build the bootloader in the `build/bootloader.bin` file.
If you installed QEMU and want to run the bootloader, you can do so by running `make run` in the root directory of the project.
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.