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 and VASM)
- 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
 -s     Save as sprite
 -a     Save as sprite for Apollo 68080 (AMMX/STOREM3)
 -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
 bmp2bin -r 2 -s sprite.bmp sprite.bin
 bmp2bin -r 2 -a sprite.bmp sprite.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



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

Changes for release 0.5 (2026-04-25)

- Added support for saving sprites. Transparent pixel is R=0,
  G=0 and B=0.
- Added support for saving sprites for the Apollo 68080. Use
  this format when you code using AMMX STOREM3. Only file format
  0-2 are supported. For more information visit www.apollo-core.com

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)
- Frank Wille
- 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]                   1856    3672  50.5% -lh5- 7cee Apr 25 17:50 bmp2bin-0.5/bmp2bin
[Amiga]                   1452    3106  46.7% -lh5- 866f Apr 25 18:16 bmp2bin-0.5/bmp2bin.readme
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total         2 files    3308    6778  48.8%            Apr 25 23:48