irc-bitmap/README.md

# irc-bitmap

A format for sending IRC bitmaps inline.

## Format

The format string shall be (in Python syntax) `r'<i([^-]+)-([^-]*)-([0-9A-Fa-f]+)>'`.

The first capture group shall be a format. The currently recognized formats are `gb` and `raw`, though any format can be used. A program SHOULD gracefully report and exit on an unknown or unsupported format.  The identifier of a format may not include a hyphen (dash).

The second capture group (may be empty) shall be known as the header and its syntax shall be defined by the format.

The third capture group contains the image data and is defined by the format.

Upon receiving a message containing the part, a compliant client MAY take steps to attempt a conversion to PNG or similar, or display the image inline. A thread with timeout CAN and SHOULD be used.

While there is no theoretical limit to the size of the image you can send, you are bound by any message length limits your server sets, as the entire part MUST fit in one message.

## Recognized formats

### `gb` - GameBoy 2BPP 4-shade monochrome

For an explanation of the format, see [here](http://www.huderlem.com/demos/gameboy2bpp.html).

The header has this syntax: `r'(\d+).(\d+)'`.  The first and second capture groups specify the width and height in 8x8 tiles.

The third capture group 

Example line: `<igb-1.1-FF007EFF858189839385A58BC9977EFF>`  
Results in:  
![Pokemon Red window](https://ttm.sh/qX.png)

### `raw` - Raw arbitrary bitmaps

8x8, 2 shade monochrome

Example line: `<iraw-8.8.1-FF818181818181FF>`  
Results in:  
![box](https://ttm.sh/qy.png)