https://github.com/guidanoli/playpal2rgb

PLAYPAL to RGB converter
https://github.com/guidanoli/playpal2rgb

converter doom playpal rgb

Last synced: about 2 months ago
JSON representation

PLAYPAL to RGB converter

• Host: GitHub
• URL: https://github.com/guidanoli/playpal2rgb
• Owner: guidanoli
• License: gpl-3.0
• Created: 2024-04-30T00:29:46.000Z (8 months ago)
• Default Branch: main
• Last Pushed: 2024-05-03T03:56:27.000Z (8 months ago)
• Last Synced: 2024-05-03T18:16:35.838Z (8 months ago)
• Topics: converter, doom, playpal, rgb
• Language: C
• Homepage:
• Size: 60.5 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# PLAYPAL to RGB converter

![Freedoom](./framebuffer.png)

The purpose of this tool is to convert raw [PLAYPAL](https://doomwiki.org/wiki/PLAYPAL) files into raw RGB files.

These raw RGB files can then be converted into PNG files with tools like [ImageMagick](https://imagemagick.org/).

## Compilation

```sh

make

```

## Usage

The tool takes the path of a palette file as argument, reads the image in PLAYPAL format from `stdin` and writes out the image in RGB format to `stdout`.

This output can be piped to the `convert` tool from ImageMagick to produce an output file in PNG format.

```sh

./playpal2rgb palette.raw < framebuffer.raw | convert -depth 8 -size 320x200 rgb:- framebuffer.png

```

## Input format

The input to the `playpal2rgb` tool should be in PLAYPAL format, where each byte encodes the index of the color in the PLAYPAL table.

The PLAYPAL table should be provided in a palette file, which also has a specific format.

## Output format

The output of the `playpal2rgb` tool is in RGB format, where...

- R is 8 bits for the red component;

- G is 8 bits for the green component;

- B is 8 bits for the blue component.

... and it has the following memory layout.

```

+------------+-----+-------+-------+

| byte index | 3*n | 3*n+1 | 3*n+2 |

+------------+-----+-------+-------+

| data       | R   | G     | B     |

+------------+-----+-------+-------+

```

## Palette format

The palette is assumed to be written in RBGX format, where...

- R is 8 bits for the red component;

- G is 8 bits for the green component;

- B is 8 bits for the blue component;

- X is 8 bits for padding (unused).

The palette should be written to a binary file of 1024 bytes with the following memory layout.

```

+------------+-----+-------+-------+-------+

| byte index | 4*n | 4*n+1 | 4*n+2 | 4*n+3 |

+------------+-----+-------+-------+-------+

| data       | R   | G     | B     | X     |

+------------+-----+-------+-------+-------+

```