About
=====

bmp2bin as a command-line tool for converting 32-bit
BMP files to 15, 16, 24 or 32-bit binary files.

BMP files need to be 32-bit (ARGB) and have a v5 header. Supports
both bottom-up and top-down bitmap data. Tested and works using

Pixelmator Pro (macOS)
GIMP

This tool was made when I wanted to try to do a system
friendly AmigaOS RTG game using Picasso96 (P96)/CyberGraphX
and found no way on the Amiga to do graphics higher
then 8-bit. As an old school bare-metal developer I like
to open or incbin my bin/raw files. This tool is great
if you code bare-metal for the Apollo Vampire cards or the
new A6000.

Support, questions, bug reports? amiga@1infiniteloop.se

1 Infinite Loop - Made for the Amiga, on the Amiga!


Features
========

- Written in 100% assembly (Devpac)
- Supports the following RGB formats

A8R8G8B8 - 4 Byte 00000000RRRRRRRRGGGGGGGGBBBBBBBB
R5G5B5   - 2 Byte 0RRRRRGGGGGBBBBB
R5G6B5   - 2 Byte RRRRRGGGGGGBBBBB
R8G8B8   - 3 Byte RRRRRRRRGGGGGGGGBBBBBBBB


Requirements
============

- AmigaOS 3.x
- 68020+


Installation
============

- Copy bmp2bin to c:


Syntax
======

bmp2bin [-r <n>] [-h] [-q] <source> [<destination>]

Options:

 -r <n> Destination file format
        0 - 4 Byte A8R8G8B8 00000000RRRRRRRRGGGGGGGGBBBBBBBB (Default)
        1 - 2 Byte R5G5B5   0RRRRRGGGGGBBBBB
        2 - 2 Byte R5G6B5   RRRRRGGGGGGBBBBB
        3 - 3 Byte R8G8B8   RRRRRRRRGGGGGGGGBBBBBBBB
 -h     Show this help message
 -q     Quiet (Except errors)

Example:

 bmp2bin amiga.bmp
 bmp2bin -r 0 amiga.bmp
 bmp2bin -r 1 -q amiga.bmp amiga.bin

 If destination is not specified default filename is data.bin


To-Do
=====

- Add more rgb formats from Picasso96.i include file
- Add support for reading 24-bit files
- Add some kind of fix to keep transparent pixel data when converting
  bitmap to 15 or 16-bit when used for game objects.



Release notes
=============

Changes for release 0.4 (2026-02-15)

- Added support for bottom-up bitmap data (GIMP)

Changes for release 0.3 (2026-01-05)

- Added support for R8G8B8
- Added option quiet

Changes for release 0.2 (2025-08-10)

- Added support for destination filename (Optional)
- Added support for R5G6B5

Changes for release 0.1 (2025-08-03)

- This is the first Aminet release


Thanks to
=========

- ElectricDevil
- Tjomp
  (bedroomcoders.com)
- Swedish User Group Of Amiga
  (suga.se)


If you like this tool you can donate to SUGA
using PayPal here

https://www.paypal.com/donate/?hosted_button_id=AREKC3DTHDPZL

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[Amiga]                   1668    3032  55.0% -lh5- 2321 Feb 15 13:00 bmp2bin-0.4/bmp2bin
[Amiga]                   1329    2740  48.5% -lh5- de46 Feb 15 13:05 bmp2bin-0.4/bmp2bin.readme
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total         2 files    2997    5772  51.9%            Feb 16 02:00