rhino/demo/c/dr_libs/old/dr_pcx.h

Go to the documentation of this file.

// PCX image loader. Public domain. See "unlicense" statement at the end of this file.
// dr_pcx - v0.3.1 - 2018-09-11
//
// David Reid - mackron@gmail.com
 
// USAGE
//
// dr_pcx is a single-file library. To use it, do something like the following in one .c file.
//     #define DR_PCX_IMPLEMENTATION
//     #include "dr_pcx.h"
//
// You can then #include this file in other parts of the program as you would with any other header file. Do something like
// the following to load and decode an image:
//
//     int width;
//     int height;
//     int components
//     drpcx_uint8* pImageData = drpcx_load_file("my_image.pcx", DRPCX_FALSE, &width, &height, &components, 0);
//     if (pImageData == NULL) {
//         // Failed to load image.
//     }
//
//     ...
//
//     drpcx_free(pImageData);
//
// The boolean parameter (second argument in the above example) is whether or not the image should be flipped upside down.
// 
//
//
// OPTIONS
// #define these options before including this file.
//
// #define DR_PCX_NO_STDIO
//   Disable drpcx_load_file().
//
//
//
// QUICK NOTES
// - 2-bpp/4-plane and 4-bpp/1-plane formats have not been tested.
 
#ifndef dr_pcx_h
#define dr_pcx_h
 
#include <stddef.h>
 
#if defined(_MSC_VER) && _MSC_VER < 1600
typedef   signed char    drpcx_int8;
typedef unsigned char    drpcx_uint8;
typedef   signed short   drpcx_int16;
typedef unsigned short   drpcx_uint16;
typedef   signed int     drpcx_int32;
typedef unsigned int     drpcx_uint32;
typedef   signed __int64 drpcx_int64;
typedef unsigned __int64 drpcx_uint64;
#else
#include <stdint.h>
typedef int8_t           drpcx_int8;
typedef uint8_t          drpcx_uint8;
typedef int16_t          drpcx_int16;
typedef uint16_t         drpcx_uint16;
typedef int32_t          drpcx_int32;
typedef uint32_t         drpcx_uint32;
typedef int64_t          drpcx_int64;
typedef uint64_t         drpcx_uint64;
#endif
typedef drpcx_uint8      drpcx_bool8;
typedef drpcx_uint32     drpcx_bool32;
#define DRPCX_TRUE       1
#define DRPCX_FALSE      0
 
#ifdef __cplusplus
extern "C" {
#endif
 
// Callback for when data is read. Return value is the number of bytes actually read.
typedef size_t (* drpcx_read_proc)(void* userData, void* bufferOut, size_t bytesToRead);
 
 
// Loads a PCX file using the given callbacks.
drpcx_uint8* drpcx_load(drpcx_read_proc onRead, void* pUserData, drpcx_bool32 flipped, int* x, int* y, int* internalComponents, int desiredComponents);
 
// Frees memory returned by drpcx_load() and family.
void drpcx_free(void* pReturnValueFromLoad);
 
 
#ifndef DR_PCX_NO_STDIO
// Loads an PCX file from an actual file.
drpcx_uint8* drpcx_load_file(const char* filename, drpcx_bool32 flipped, int* x, int* y, int* internalComponents, int desiredComponents);
#endif
 
// Helper for loading an PCX file from a block of memory.
drpcx_uint8* drpcx_load_memory(const void* data, size_t dataSize, drpcx_bool32 flipped, int* x, int* y, int* internalComponents, int desiredComponents);
 
 
#ifdef __cplusplus
}
#endif
 
#endif  // dr_pcx_h
 
 
//
// IMPLEMENTATION
//
#ifdef DR_PCX_IMPLEMENTATION
#include <stdlib.h>
#include <string.h>
#include <assert.h>
 
#ifndef DR_PCX_NO_STDIO
#include <stdio.h>
 
static size_t drpcx__on_read_stdio(void* pUserData, void* bufferOut, size_t bytesToRead)
{
    return fread(bufferOut, 1, bytesToRead, (FILE*)pUserData);
}
 
drpcx_uint8* drpcx_load_file(const char* filename, drpcx_bool32 flipped, int* x, int* y, int* internalComponents, int desiredComponents)
{
    FILE* pFile;
#ifdef _MSC_VER
    if (fopen_s(&pFile, filename, "rb") != 0) {
        return NULL;
    }
#else
    pFile = fopen(filename, "rb");
    if (pFile == NULL) {
        return NULL;
    }
#endif
 
    drpcx_uint8* pImageData = drpcx_load(drpcx__on_read_stdio, pFile, flipped, x, y, internalComponents, desiredComponents);
 
    fclose(pFile);
    return pImageData;
}
#endif  // DR_PCX_NO_STDIO
 
 
typedef struct
{
    // A pointer to the beginning of the data. We use a char as the type here for easy offsetting.
    const unsigned char* data;
    size_t dataSize;
    size_t currentReadPos;
} drpcx_memory;
 
static size_t drpcx__on_read_memory(void* pUserData, void* bufferOut, size_t bytesToRead)
{
    drpcx_memory* memory = (drpcx_memory*)pUserData;
    assert(memory != NULL);
    assert(memory->dataSize >= memory->currentReadPos);
 
    size_t bytesRemaining = memory->dataSize - memory->currentReadPos;
    if (bytesToRead > bytesRemaining) {
        bytesToRead = bytesRemaining;
    }
 
    if (bytesToRead > 0) {
        memcpy(bufferOut, memory->data + memory->currentReadPos, bytesToRead);
        memory->currentReadPos += bytesToRead;
    }
 
    return bytesToRead;
}
 
drpcx_uint8* drpcx_load_memory(const void* data, size_t dataSize, drpcx_bool32 flipped, int* x, int* y, int* internalComponents, int desiredComponents)
{
    drpcx_memory memory;
    memory.data = (const unsigned char*)data;
    memory.dataSize = dataSize;
    memory.currentReadPos = 0;
    return drpcx_load(drpcx__on_read_memory, &memory, flipped, x, y, internalComponents, desiredComponents);
}
 
 
typedef struct
{
    drpcx_uint8 header;
    drpcx_uint8 version;
    drpcx_uint8 encoding;
    drpcx_uint8 bpp;
    drpcx_uint16 left;
    drpcx_uint16 top;
    drpcx_uint16 right;
    drpcx_uint16 bottom;
    drpcx_uint16 hres;
    drpcx_uint16 vres;
    drpcx_uint8 palette16[48];
    drpcx_uint8 reserved1;
    drpcx_uint8 bitPlanes;
    drpcx_uint16 bytesPerLine;
    drpcx_uint16 paletteType;
    drpcx_uint16 screenSizeH;
    drpcx_uint16 screenSizeV;
    drpcx_uint8 reserved2[54];
} drpcx_header;
 
typedef struct
{
    drpcx_read_proc onRead;
    void* pUserData;
    drpcx_bool32 flipped;
    drpcx_header header;
 
    drpcx_uint32 width;
    drpcx_uint32 height;
    drpcx_uint32 components;    // 3 = RGB; 4 = RGBA. Only 3 and 4 are supported.
    drpcx_uint8* pImageData;
} drpcx;
 
 
static drpcx_uint8 drpcx__read_byte(drpcx* pPCX)
{
    drpcx_uint8 byte = 0;
    pPCX->onRead(pPCX->pUserData, &byte, 1);
 
    return byte;
}
 
static drpcx_uint8* drpcx__row_ptr(drpcx* pPCX, drpcx_uint32 row)
{
    drpcx_uint32 stride = pPCX->width * pPCX->components;
 
    drpcx_uint8* pRow = pPCX->pImageData;
    if (pPCX->flipped) {
        pRow += (pPCX->height - row - 1) * stride;
    } else {
        pRow += row * stride;
    }
 
    return pRow;
}
 
static drpcx_uint8 drpcx__rle(drpcx* pPCX, drpcx_uint8* pRLEValueOut)
{
    drpcx_uint8 rleCount;
    drpcx_uint8 rleValue;
 
    rleValue = drpcx__read_byte(pPCX);
    if ((rleValue & 0xC0) == 0xC0) {
        rleCount = rleValue & 0x3F;
        rleValue = drpcx__read_byte(pPCX);
    } else {
        rleCount = 1;
    }
 
 
    *pRLEValueOut = rleValue;
    return rleCount;
}
 
 
drpcx_bool32 drpcx__decode_1bit(drpcx* pPCX)
{
    drpcx_uint8 rleCount = 0;
    drpcx_uint8 rleValue = 0;
 
    switch (pPCX->header.bitPlanes)
    {
        case 1:
        {
            for (drpcx_uint32 y = 0; y < pPCX->height; ++y) {
                drpcx_uint8* pRow = drpcx__row_ptr(pPCX, y);
                for (drpcx_uint32 x = 0; x < pPCX->header.bytesPerLine; ++x) {
                    if (rleCount == 0) {
                        rleCount = drpcx__rle(pPCX, &rleValue);
                    }
                    rleCount -= 1;
 
                    for (int bit = 0; (bit < 8) && ((x*8 + bit) < pPCX->width); ++bit) {
                        drpcx_uint8 mask = (1 << (7 - bit));
                        drpcx_uint8 paletteIndex = (rleValue & mask) >> (7 - bit);
 
                        pRow[0] = paletteIndex * 255;
                        pRow[1] = paletteIndex * 255;
                        pRow[2] = paletteIndex * 255;
                        pRow += 3;
                    }
                }
            }
 
            return DRPCX_TRUE;
 
        } break;
 
        case 2:
        case 3:
        case 4:
        {
            for (drpcx_uint32 y = 0; y < pPCX->height; ++y) {
                for (drpcx_uint32 c = 0; c < pPCX->header.bitPlanes; ++c) {
                    drpcx_uint8* pRow = drpcx__row_ptr(pPCX, y);
                    for (drpcx_uint32 x = 0; x < pPCX->header.bytesPerLine; ++x) {
                        if (rleCount == 0) {
                            rleCount = drpcx__rle(pPCX, &rleValue);
                        }
                        rleCount -= 1;
 
                        for (int bit = 0; (bit < 8) && ((x*8 + bit) < pPCX->width); ++bit) {
                            drpcx_uint8 mask = (1 << (7 - bit));
                            drpcx_uint8 paletteIndex = (rleValue & mask) >> (7 - bit);
 
                            pRow[0] |= ((paletteIndex & 0x01) << c);
                            pRow += pPCX->components;
                        }
                    }
                }
 
 
                drpcx_uint8* pRow = drpcx__row_ptr(pPCX, y);
                for (drpcx_uint32 x = 0; x < pPCX->width; ++x) {
                    drpcx_uint8 paletteIndex = pRow[0];
                    for (drpcx_uint32 c = 0; c < pPCX->components; ++c) {
                        pRow[c] = pPCX->header.palette16[paletteIndex*3 + c];
                    }
                    
                    pRow += pPCX->components;
                }
            }
 
            return DRPCX_TRUE;
        }
 
        default: return DRPCX_FALSE;
    }
}
 
drpcx_bool32 drpcx__decode_2bit(drpcx* pPCX)
{
    drpcx_uint8 rleCount = 0;
    drpcx_uint8 rleValue = 0;
 
    switch (pPCX->header.bitPlanes)
    {
        case 1:
        {
            drpcx_uint8 paletteCGA[48];
            paletteCGA[ 0] = 0x00; paletteCGA[ 1] = 0x00; paletteCGA[ 2] = 0x00;    // #000000
            paletteCGA[ 3] = 0x00; paletteCGA[ 4] = 0x00; paletteCGA[ 5] = 0xAA;    // #0000AA
            paletteCGA[ 6] = 0x00; paletteCGA[ 7] = 0xAA; paletteCGA[ 8] = 0x00;    // #00AA00
            paletteCGA[ 9] = 0x00; paletteCGA[10] = 0xAA; paletteCGA[11] = 0xAA;    // #00AAAA
            paletteCGA[12] = 0xAA; paletteCGA[13] = 0x00; paletteCGA[14] = 0x00;    // #AA0000
            paletteCGA[15] = 0xAA; paletteCGA[16] = 0x00; paletteCGA[17] = 0xAA;    // #AA00AA
            paletteCGA[18] = 0xAA; paletteCGA[19] = 0x55; paletteCGA[20] = 0x00;    // #AA5500
            paletteCGA[21] = 0xAA; paletteCGA[22] = 0xAA; paletteCGA[23] = 0xAA;    // #AAAAAA
            paletteCGA[24] = 0x55; paletteCGA[25] = 0x55; paletteCGA[26] = 0x55;    // #555555
            paletteCGA[27] = 0x55; paletteCGA[28] = 0x55; paletteCGA[29] = 0xFF;    // #5555FF
            paletteCGA[30] = 0x55; paletteCGA[31] = 0xFF; paletteCGA[32] = 0x55;    // #55FF55
            paletteCGA[33] = 0x55; paletteCGA[34] = 0xFF; paletteCGA[35] = 0xFF;    // #55FFFF
            paletteCGA[36] = 0xFF; paletteCGA[37] = 0x55; paletteCGA[38] = 0x55;    // #FF5555
            paletteCGA[39] = 0xFF; paletteCGA[40] = 0x55; paletteCGA[41] = 0xFF;    // #FF55FF
            paletteCGA[42] = 0xFF; paletteCGA[43] = 0xFF; paletteCGA[44] = 0x55;    // #FFFF55
            paletteCGA[45] = 0xFF; paletteCGA[46] = 0xFF; paletteCGA[47] = 0xFF;    // #FFFFFF
 
            drpcx_uint8 cgaBGColor   = pPCX->header.palette16[0] >> 4;
            drpcx_uint8 i = (pPCX->header.palette16[3] & 0x20) >> 5;
            drpcx_uint8 p = (pPCX->header.palette16[3] & 0x40) >> 6;
            //drpcx_uint8 c = (pPCX->header.palette16[3] & 0x80) >> 7;    // Color or monochrome. How is monochrome handled?
 
            for (drpcx_uint32 y = 0; y < pPCX->height; ++y) {
                drpcx_uint8* pRow = drpcx__row_ptr(pPCX, y);
                for (drpcx_uint32 x = 0; x < pPCX->header.bytesPerLine; ++x) {
                    if (rleCount == 0) {
                        rleCount = drpcx__rle(pPCX, &rleValue);
                    }
                    rleCount -= 1;
 
                    for (int bit = 0; bit < 4; ++bit) {
                        if (x*4 + bit < pPCX->width) {
                            drpcx_uint8 mask = (3 << ((3 - bit) * 2));
                            drpcx_uint8 paletteIndex = (rleValue & mask) >> ((3 - bit) * 2);
 
                            drpcx_uint8 cgaIndex;
                            if (paletteIndex == 0) {    // Background.
                                cgaIndex = cgaBGColor;
                            } else {                    // Foreground
                                cgaIndex = (((paletteIndex << 1) + p) + (i << 3));
                            }
 
                            pRow[0] = paletteCGA[cgaIndex*3 + 0];
                            pRow[1] = paletteCGA[cgaIndex*3 + 1];
                            pRow[2] = paletteCGA[cgaIndex*3 + 2];
                            pRow += 3;
                        }
                    }
                }
            }
 
            // TODO: According to http://www.fysnet.net/pcxfile.htm, we should use the palette at the end of the file
            //       instead of the standard CGA palette if the version is equal to 5. With my test files the palette
            //       at the end of the file does not exist. Research this one.
            if (pPCX->header.version == 5) {
                drpcx_uint8 paletteMarker = drpcx__read_byte(pPCX);
                if (paletteMarker == 0x0C) {
                    // TODO: Implement Me.
                }
            }
            
            return DRPCX_TRUE;
        };
 
        case 4:
        {
            // NOTE: This is completely untested. If anybody knows where I can get a test file please let me know or send it through to me!
            // TODO: Test Me.
 
            for (drpcx_uint32 y = 0; y < pPCX->height; ++y) {
                for (drpcx_uint32 c = 0; c < pPCX->header.bitPlanes; ++c) {
                    drpcx_uint8* pRow = drpcx__row_ptr(pPCX, y);
                    for (drpcx_uint32 x = 0; x < pPCX->header.bytesPerLine; ++x) {
                        if (rleCount == 0) {
                            rleCount = drpcx__rle(pPCX, &rleValue);
                        }
                        rleCount -= 1;
 
                        for (int bitpair = 0; (bitpair < 4) && ((x*4 + bitpair) < pPCX->width); ++bitpair) {
                            drpcx_uint8 mask = (4 << (3 - bitpair));
                            drpcx_uint8 paletteIndex = (rleValue & mask) >> (3 - bitpair);
 
                            pRow[0] |= ((paletteIndex & 0x03) << (c*2));
                            pRow += pPCX->components;
                        }
                    }
                }
 
 
                drpcx_uint8* pRow = drpcx__row_ptr(pPCX, y);
                for (drpcx_uint32 x = 0; x < pPCX->width; ++x) {
                    drpcx_uint8 paletteIndex = pRow[0];
                    for (drpcx_uint32 c = 0; c < pPCX->header.bitPlanes; ++c) {
                        pRow[c] = pPCX->header.palette16[paletteIndex*3 + c];
                    }
                    
                    pRow += pPCX->components;
                }
            }
 
            return DRPCX_TRUE;
        };
 
        default: return DRPCX_FALSE;
    }
}
 
drpcx_bool32 drpcx__decode_4bit(drpcx* pPCX)
{
    // NOTE: This is completely untested. If anybody knows where I can get a test file please let me know or send it through to me!
    // TODO: Test Me.
 
    if (pPCX->header.bitPlanes > 1) {
        return DRPCX_FALSE;
    }
 
    drpcx_uint8 rleCount = 0;
    drpcx_uint8 rleValue = 0;
 
    for (drpcx_uint32 y = 0; y < pPCX->height; ++y) {
        for (drpcx_uint32 c = 0; c < pPCX->header.bitPlanes; ++c) {
            drpcx_uint8* pRow = drpcx__row_ptr(pPCX, y);
            for (drpcx_uint32 x = 0; x < pPCX->header.bytesPerLine; ++x) {
                if (rleCount == 0) {
                    rleCount = drpcx__rle(pPCX, &rleValue);
                }
                rleCount -= 1;
 
                for (int nibble = 0; (nibble < 2) && ((x*2 + nibble) < pPCX->width); ++nibble)
                {
                    drpcx_uint8 mask = (4 << (1 - nibble));
                    drpcx_uint8 paletteIndex = (rleValue & mask) >> (1 - nibble);
 
                    pRow[0] |= ((paletteIndex & 0x0F) << (c*4)); 
                    pRow += pPCX->components;
                }
            }
        }
 
 
        drpcx_uint8* pRow = drpcx__row_ptr(pPCX, y);
        for (drpcx_uint32 x = 0; x < pPCX->width; ++x) {
            drpcx_uint8 paletteIndex = pRow[0];
            for (drpcx_uint32 c = 0; c < pPCX->components; ++c) {
                pRow[c] = pPCX->header.palette16[paletteIndex*3 + c];
            }
                    
            pRow += pPCX->components;
        }
    }
 
    return DRPCX_TRUE;
}
 
drpcx_bool32 drpcx__decode_8bit(drpcx* pPCX)
{
    drpcx_uint8 rleCount = 0;
    drpcx_uint8 rleValue = 0;
    drpcx_uint32 stride = pPCX->width * pPCX->components;
 
    switch (pPCX->header.bitPlanes)
    {
        case 1:
        {
            for (drpcx_uint32 y = 0; y < pPCX->height; ++y) {
                drpcx_uint8* pRow = drpcx__row_ptr(pPCX, y);
                for (drpcx_uint32 x = 0; x < pPCX->header.bytesPerLine; ++x) {
                    if (rleCount == 0) {
                        rleCount = drpcx__rle(pPCX, &rleValue);
                    }
                    rleCount -= 1;
 
                    if (x < pPCX->width) {
                        pRow[0] = rleValue;
                        pRow[1] = rleValue;
                        pRow[2] = rleValue;
                        pRow += 3;
                    }
                }
            }
 
            // At this point we can know if we are dealing with a palette or a grayscale image by checking the next byte. If it's equal to 0x0C, we
            // need to do a simple palette lookup.
            drpcx_uint8 paletteMarker = drpcx__read_byte(pPCX);
            if (paletteMarker == 0x0C) {
                // A palette is present - we need to do a second pass.
                drpcx_uint8 palette256[768];
                if (pPCX->onRead(pPCX->pUserData, palette256, sizeof(palette256)) != sizeof(palette256)) {
                    return DRPCX_FALSE;
                }
 
                for (drpcx_uint32 y = 0; y < pPCX->height; ++y) {
                    drpcx_uint8* pRow = pPCX->pImageData + (y * stride);
                    for (drpcx_uint32 x = 0; x < pPCX->width; ++x) {
                        drpcx_uint8 index = pRow[0];
                        pRow[0] = palette256[index*3 + 0];
                        pRow[1] = palette256[index*3 + 1];
                        pRow[2] = palette256[index*3 + 2];
                        pRow += 3;
                    }
                }
            }
 
            return DRPCX_TRUE;
        }
 
        case 3:
        case 4:
        {
            for (drpcx_uint32 y = 0; y < pPCX->height; ++y) {
                for (drpcx_uint32 c = 0; c < pPCX->components; ++c) {
                    drpcx_uint8* pRow = drpcx__row_ptr(pPCX, y);
                    for (drpcx_uint32 x = 0; x < pPCX->header.bytesPerLine; ++x) {
                        if (rleCount == 0) {
                            rleCount = drpcx__rle(pPCX, &rleValue);
                        }
                        rleCount -= 1;
 
                        if (x < pPCX->width) {
                            pRow[c] = rleValue;
                            pRow += pPCX->components;
                        }
                    }
                }
            }
 
            return DRPCX_TRUE;
        }
    }
 
    return DRPCX_TRUE;
}
 
drpcx_uint8* drpcx_load(drpcx_read_proc onRead, void* pUserData, drpcx_bool32 flipped, int* x, int* y, int* internalComponents, int desiredComponents)
{
    if (onRead == NULL) return NULL;
    if (desiredComponents > 4) return NULL;
 
    drpcx pcx;
    pcx.onRead    = onRead;
    pcx.pUserData = pUserData;
    pcx.flipped   = flipped;
    if (onRead(pUserData, &pcx.header, sizeof(pcx.header)) != sizeof(pcx.header)) {
        return NULL;    // Failed to read the header.
    }
 
    if (pcx.header.header != 10) {
        return NULL;    // Not a PCX file.
    }
 
    if (pcx.header.encoding != 1) {
        return NULL;    // Not supporting non-RLE encoding. Would assume a value of 0 indicates raw, unencoded, but that is apparently never used.
    }
 
    if (pcx.header.bpp != 1 && pcx.header.bpp != 2 && pcx.header.bpp != 4 && pcx.header.bpp != 8) {
        return NULL;    // Unsupported pixel format.
    }
 
 
    if (pcx.header.left > pcx.header.right) {
        drpcx_uint16 temp = pcx.header.left;
        pcx.header.left = pcx.header.right;
        pcx.header.right = temp;
    }
    if (pcx.header.top > pcx.header.bottom) {
        drpcx_uint16 temp = pcx.header.top;
        pcx.header.top = pcx.header.bottom;
        pcx.header.bottom = temp;
    }
 
    pcx.width = pcx.header.right - pcx.header.left + 1;
    pcx.height = pcx.header.bottom - pcx.header.top + 1;
    pcx.components = (pcx.header.bpp == 8 && pcx.header.bitPlanes == 4) ? 4 : 3;
 
    size_t dataSize = pcx.width * pcx.height * pcx.components;
    pcx.pImageData = (drpcx_uint8*)calloc(1, dataSize);   // <-- Clearing to zero is important! Required for proper decoding.
    if (pcx.pImageData == NULL) {
        return NULL;    // Failed to allocate memory.
    }
 
    drpcx_bool32 result = DRPCX_FALSE;
    switch (pcx.header.bpp)
    {
        case 1:
        {
            result = drpcx__decode_1bit(&pcx);
        } break;
 
        case 2:
        {
            result = drpcx__decode_2bit(&pcx);
        } break;
 
        case 4:
        {
            result = drpcx__decode_4bit(&pcx);
        } break;
 
        case 8:
        {
            result = drpcx__decode_8bit(&pcx);
        } break;
    }
 
    if (!result) {
        free(pcx.pImageData);
        return NULL;
    }
 
    // There's an annoying amount of branching when loading PCX files so for simplicity I'm doing the component conversion as
    // a second pass.
    if (desiredComponents == 0) desiredComponents = pcx.components;
    if (desiredComponents != (int)pcx.components) {
        drpcx_uint8* pNewImageData = (drpcx_uint8*)malloc(pcx.width * pcx.height * desiredComponents);
        if (pNewImageData == NULL) {
            free(pcx.pImageData);
            return NULL;
        }
 
        drpcx_uint8* pSrcData = pcx.pImageData;
        drpcx_uint8* pDstData = pNewImageData;
        if (desiredComponents < (int)pcx.components) {
            // We're reducing the number of components. Just drop the excess.
            for (drpcx_uint32 i = 0; i < pcx.width*pcx.height; ++i) {
                for (int c = 0; c < desiredComponents; ++c) {
                    pDstData[c] = pSrcData[c];
                } 
 
                pSrcData += pcx.components;
                pDstData += desiredComponents;
            }
        } else {
            // We're increasing the number of components. Always ensure the alpha channel is set to 0xFF.
            if (pcx.components == 1) {
                for (drpcx_uint32 i = 0; i < pcx.width*pcx.height; ++i) {
                    for (int c = 0; c < desiredComponents; ++c) {
                        pDstData[c] = pSrcData[0];
                    }
 
                    pSrcData += pcx.components;
                    pDstData += desiredComponents;
                }
            } else if (pcx.components == 2) {
                for (drpcx_uint32 i = 0; i < pcx.width*pcx.height; ++i) {
                    pDstData[0] = pSrcData[0];
                    pDstData[1] = pSrcData[1];
                    pDstData[2] = 0x00;
                    if (desiredComponents == 4) pDstData[3] = 0xFF;
 
                    pSrcData += pcx.components;
                    pDstData += desiredComponents;
                }
            } else {
                assert(pcx.components == 3);
                assert(desiredComponents == 4);
                for (drpcx_uint32 i = 0; i < pcx.width*pcx.height; ++i) {
                    pDstData[0] = pSrcData[0];
                    pDstData[1] = pSrcData[1];
                    pDstData[2] = pSrcData[2];
                    pDstData[3] = 0xFF;
 
                    pSrcData += pcx.components;
                    pDstData += desiredComponents;
                }
            }
        }
 
        free(pcx.pImageData);
        pcx.pImageData = pNewImageData;
    }
 
    if (x) *x = pcx.width;
    if (y) *y = pcx.height;
    if (internalComponents) *internalComponents = pcx.components;
    return pcx.pImageData;
}
 
void drpcx_free(void* pReturnValueFromLoad)
{
    free(pReturnValueFromLoad);
}
 
#endif // DR_PCX_IMPLEMENTATION
 
 
// REVISION HISTORY
//
// v0.3.1 - 2018-09-11
//   - Styling fixes.
//   - Fix a typo.
//
// v0.3 - 2018-02-08
//   - API CHANGE: Rename dr_* types to drpcx_*.
//
// v0.2c - 2018-02-07
//   - Fix a crash.
//
// v0.2b - 2018-02-02
//   - Fix compilation error.
//
// v0.2a - 2017-07-16
//   - Change underlying type for booleans to unsigned.
//
// v0.2 - 2016-10-28
//   - API CHANGE: Add a parameter to drpcx_load() and family to control the number of output components.
//   - Use custom sized types rather than built-in ones to improve support for older MSVC compilers.
//
// v0.1c - 2016-10-23
//   - A minor change to drpcx_bool8 and drpcx_bool32 types.
//
// v0.1b - 2016-10-11
//   - Use drpcx_bool32 instead of the built-in "bool" type. The reason for this change is that it helps maintain API/ABI consistency
//     between C and C++ builds.
//
// v0.1a - 2016-09-18
//   - Change date format to ISO 8601 (YYYY-MM-DD)
//
// v0.1 - 2016-05-04
//   - Initial versioned release.
 
 
// TODO
// - Test 2-bpp/4-plane and 4-bpp/1-plane formats.
 
 
/*
This is free and unencumbered software released into the public domain.
 
Anyone is free to copy, modify, publish, use, compile, sell, or
distribute this software, either in source code form or as a compiled
binary, for any purpose, commercial or non-commercial, and by any
means.
 
In jurisdictions that recognize copyright laws, the author or authors
of this software dedicate any and all copyright interest in the
software to the public domain. We make this dedication for the benefit
of the public at large and to the detriment of our heirs and
successors. We intend this dedication to be an overt act of
relinquishment in perpetuity of all present and future rights to this
software under copyright law.
 
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
OTHER DEALINGS IN THE SOFTWARE.
 
For more information, please refer to <http://unlicense.org/>
*/