axmol/core/renderer/backend/PixelFormatUtils.cpp

/****************************************************************************
 Copyright (c) 2018-2019 Xiamen Yaji Software Co., Ltd.
 Copyright (c) 2020 C4games Ltd
 Copyright (c) 2022 Bytedance Inc.

 https://axmolengine.github.io/

 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
 in the Software without restriction, including without limitation the rights
 to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 copies of the Software, and to permit persons to whom the Software is
 furnished to do so, subject to the following conditions:

 The above copyright notice and this permission notice shall be included in
 all copies or substantial portions of the Software.

 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 OR COPYRIGHT HOLDERS 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.
 ****************************************************************************/

#include "PixelFormatUtils.h"
#include "Macros.h"

NS_AX_BEGIN

namespace backend
{
namespace PixelFormatUtils
{

static const PixelFormatDescriptor s_pixelFormatDescriptors[] = {
    //  +--------------------------------------------- bpp
    //  |   +----------------------------------------- block width
    //  |   |  +-------------------------------------- block height
    //  |   |  |   +---------------------------------- block size
    //  |   |  |   |  +------------------------------- min blocks x
    //  |   |  |   |  |  +---------------------------- min blocks y
    //  |   |  |   |  |  |   +------------------------ alpha
    //  |   |  |   |  |  |   |        +--------------- name
    {4, 4, 4, 8, 2, 2, false, "PVRTC4"},     // PVRTC4
    {4, 4, 4, 8, 2, 2, true, "PVRTC4A"},     // PVRTC4A
    {2, 8, 4, 8, 2, 2, false, "PVRTC2"},     // PVRTC2
    {2, 8, 4, 8, 2, 2, true, "PVRTC2A"},     // PVTC2A
    {4, 4, 4, 8, 1, 1, false, "ETC1"},       // ETC1
    {4, 4, 4, 8, 1, 1, false, "ETC2"},       // ETC2
    {8, 4, 4, 16, 1, 1, true, "ETC2A"},      // ETC2A
    {4, 4, 4, 8, 1, 1, true, "BC1"},         // S3TC_DXT1
    {8, 4, 4, 16, 1, 1, true, "BC2"},        // S3TC_DXT3
    {8, 4, 4, 16, 1, 1, true, "BC3"},        // S3TC_DXT5
    {4, 4, 4, 8, 1, 1, false, "ATC"},        // ATC_RGB
    {8, 4, 4, 16, 1, 1, true, "ATCE"},       // ATC_EXPLICIT_ALPHA
    {8, 4, 4, 16, 1, 1, true, "ATCI"},       // ATC_INTERPOLATED_ALPHA
    {8, 4, 4, 16, 1, 1, true, "ASTC4x4"},    // ASTC4x4
    {6, 5, 5, 16, 1, 1, true, "ASTC5x5"},    // ASTC5x5
    {4, 6, 6, 16, 1, 1, true, "ASTC6x6"},    // ASTC6x6
    {4, 8, 5, 16, 1, 1, true, "ASTC8x5"},    // ASTC8x5
    {3, 8, 6, 16, 1, 1, true, "ASTC8x6"},    // ASTC8x6
    {2, 8, 8, 16, 1, 1, true, "ASTC8x8"},    // ASTC8x8
    {3, 10, 5, 16, 1, 1, true, "ASTC10x5"},  // ASTC10x5
    {32, 1, 1, 4, 1, 1, true, "RGBA8"},      // RGBA8
    {32, 1, 1, 4, 1, 1, true, "BGRA8"},      // BGRA8
    {24, 1, 1, 3, 1, 1, false, "RGB8"},      // RGB8
    {16, 1, 1, 2, 1, 1, false, "R5G6B5"},    // R5G6B5
    {16, 1, 1, 2, 1, 1, true, "RGBA4"},      // RGBA4
    {16, 1, 1, 2, 1, 1, true, "RGB5A1"},     // RGB5A1
    {8, 1, 1, 1, 1, 1, true, "A8"},          // A8
    {8, 1, 1, 1, 1, 1, false, "L8"},         // L8
    {16, 1, 1, 2, 1, 1, true, "LA8"},        // LA8
    {16, 1, 1, 2, 1, 1, true, "RG8"},        // RG8
    {128, 1, 1, 4, 1, 1, true, "RGBA32F"},   // RGBA32F
#if (AX_TARGET_PLATFORM != AX_PLATFORM_IOS)
    {32, 1, 1, 4, 1, 1, false, "D24S8"},  // D24S8
#else
    {64, 1, 1, 8, 1, 1, false, "D32FS8"},  // D32FS8 iOS
#endif
};

static_assert(AX_ARRAYSIZE(s_pixelFormatDescriptors) == (int)PixelFormat::COUNT,
              "The pixel format descriptor table incomplete!");

//////////////////////////////////////////////////////////////////////////
// pixel format helper functions
const PixelFormatDescriptor& getFormatDescriptor(PixelFormat format)
{
    if (UTILS_LIKELY(format < PixelFormat::COUNT))
        return s_pixelFormatDescriptors[(uint32_t)format];

    static const PixelFormatDescriptor s_invalidDescriptor = {};
    return s_invalidDescriptor;
}

uint32_t computeRowPitch(PixelFormat format, uint32_t width)
{
    if (UTILS_LIKELY(format < PixelFormat::COUNT))
    {
        if (UTILS_LIKELY(format >= PixelFormat::ETC1))
        {  // @MTL: PVRTC.rowPitc must be 0
            auto& descriptor = s_pixelFormatDescriptors[(uint32_t)format];
            if (format < PixelFormat::RGBA8)
            {
                auto blocksPerRow = (width + (descriptor.blockWidth - 1)) / descriptor.blockWidth;
                return blocksPerRow * descriptor.blockSize;
            }
            return width * descriptor.bpp / 8;
        }
    }
    return 0;
}

//////////////////////////////////////////////////////////////////////////
// convertor function

// IIIIIIII -> RRRRRRRRGGGGGGGGGBBBBBBBB
void convertL8ToRGB8(const unsigned char* data, size_t dataLen, unsigned char* outData)
{
    for (size_t i = 0; i < dataLen; ++i)
    {
        *outData++ = data[i];  // R
        *outData++ = data[i];  // G
        *outData++ = data[i];  // B
    }
}

// IIIIIIIIAAAAAAAA -> RRRRRRRRGGGGGGGGBBBBBBBB
void convertLA8ToRGB8(const unsigned char* data, size_t dataLen, unsigned char* outData)
{
    for (ssize_t i = 0, l = dataLen - 1; i < l; i += 2)
    {
        *outData++ = data[i];  // R
        *outData++ = data[i];  // G
        *outData++ = data[i];  // B
    }
}

// IIIIIIII -> RRRRRRRRGGGGGGGGGBBBBBBBBAAAAAAAA
void convertL8ToRGBA8(const unsigned char* data, size_t dataLen, unsigned char* outData)
{
    for (size_t i = 0; i < dataLen; ++i)
    {
        *outData++ = data[i];  // R
        *outData++ = data[i];  // G
        *outData++ = data[i];  // B
        *outData++ = 0xFF;     // A
    }
}

// IIIIIIIIAAAAAAAA -> RRRRRRRRGGGGGGGGBBBBBBBBAAAAAAAA
void convertLA8ToRGBA8(const unsigned char* data, size_t dataLen, unsigned char* outData)
{
    for (ssize_t i = 0, l = dataLen - 1; i < l; i += 2)
    {
        *outData++ = data[i];      // R
        *outData++ = data[i];      // G
        *outData++ = data[i];      // B
        *outData++ = data[i + 1];  // A
    }
}

// IIIIIIII -> RRRRRGGGGGGBBBBB
void convertL8ToRGB565(const unsigned char* data, size_t dataLen, unsigned char* outData)
{
    unsigned short* out16 = (unsigned short*)outData;
    for (size_t i = 0; i < dataLen; ++i)
    {
        *out16++ = (data[i] & 0x00F8) << 8     // R
                   | (data[i] & 0x00FC) << 3   // G
                   | (data[i] & 0x00F8) >> 3;  // B
    }
}

// IIIIIIIIAAAAAAAA -> RRRRRGGGGGGBBBBB
void convertLA8ToRGB565(const unsigned char* data, size_t dataLen, unsigned char* outData)
{
    unsigned short* out16 = (unsigned short*)outData;
    for (ssize_t i = 0, l = dataLen - 1; i < l; i += 2)
    {
        *out16++ = (data[i] & 0x00F8) << 8     // R
                   | (data[i] & 0x00FC) << 3   // G
                   | (data[i] & 0x00F8) >> 3;  // B
    }
}

// IIIIIIII -> RRRRGGGGBBBBAAAA
void convertL8ToRGBA4(const unsigned char* data, size_t dataLen, unsigned char* outData)
{
    unsigned short* out16 = (unsigned short*)outData;
    for (size_t i = 0; i < dataLen; ++i)
    {
        *out16++ = (data[i] & 0x00F0) << 8    // R
                   | (data[i] & 0x00F0) << 4  // G
                   | (data[i] & 0x00F0)       // B
                   | 0x000F;                  // A
    }
}

// IIIIIIIIAAAAAAAA -> RRRRGGGGBBBBAAAA
void convertLA8ToRGBA4(const unsigned char* data, size_t dataLen, unsigned char* outData)
{
    unsigned short* out16 = (unsigned short*)outData;
    for (ssize_t i = 0, l = dataLen - 1; i < l; i += 2)
    {
        *out16++ = (data[i] & 0x00F0) << 8         // R
                   | (data[i] & 0x00F0) << 4       // G
                   | (data[i] & 0x00F0)            // B
                   | (data[i + 1] & 0x00F0) >> 4;  // A
    }
}

// IIIIIIII -> RRRRRGGGGGBBBBBA
void convertL8ToRGB5A1(const unsigned char* data, size_t dataLen, unsigned char* outData)
{
    unsigned short* out16 = (unsigned short*)outData;
    for (size_t i = 0; i < dataLen; ++i)
    {
        *out16++ = (data[i] & 0x00F8) << 8    // R
                   | (data[i] & 0x00F8) << 3  // G
                   | (data[i] & 0x00F8) >> 2  // B
                   | 0x0001;                  // A
    }
}

// IIIIIIIIAAAAAAAA -> RRRRRGGGGGBBBBBA
void convertLA8ToRGB5A1(const unsigned char* data, size_t dataLen, unsigned char* outData)
{
    unsigned short* out16 = (unsigned short*)outData;
    for (ssize_t i = 0, l = dataLen - 1; i < l; i += 2)
    {
        *out16++ = (data[i] & 0x00F8) << 8         // R
                   | (data[i] & 0x00F8) << 3       // G
                   | (data[i] & 0x00F8) >> 2       // B
                   | (data[i + 1] & 0x0080) >> 7;  // A
    }
}

// IIIIIIII -> IIIIIIIIAAAAAAAA
void convertL8ToLA8(const unsigned char* data, size_t dataLen, unsigned char* outData)
{
    unsigned short* out16 = (unsigned short*)outData;
    for (size_t i = 0; i < dataLen; ++i)
    {
        *out16++ = 0xFF00      // A
                   | data[i];  // I
    }
}

// IIIIIIIIAAAAAAAA -> AAAAAAAA
void convertLA8ToA8(const unsigned char* data, size_t dataLen, unsigned char* outData)
{
    for (size_t i = 1; i < dataLen; i += 2)
    {
        *outData++ = data[i];  // A
    }
}

// IIIIIIIIAAAAAAAA -> IIIIIIII
void convertLA8ToL8(const unsigned char* data, size_t dataLen, unsigned char* outData)
{
    for (ssize_t i = 0, l = dataLen - 1; i < l; i += 2)
    {
        *outData++ = data[i];  // R
    }
}

// RRRRRRRRGGGGGGGGBBBBBBBB -> RRRRRRRRGGGGGGGGBBBBBBBBAAAAAAAA
void convertRGB8ToRGBA8(const unsigned char* data, size_t dataLen, unsigned char* outData)
{
    for (ssize_t i = 0, l = dataLen - 2; i < l; i += 3)
    {
        *outData++ = data[i];      // R
        *outData++ = data[i + 1];  // G
        *outData++ = data[i + 2];  // B
        *outData++ = 0xFF;         // A
    }
}

// RRRRRRRRGGGGGGGGBBBBBBBBAAAAAAAA -> RRRRRRRRGGGGGGGGBBBBBBBB
void convertRGBA8ToRGB8(const unsigned char* data, size_t dataLen, unsigned char* outData)
{
    for (ssize_t i = 0, l = dataLen - 3; i < l; i += 4)
    {
        *outData++ = data[i];      // R
        *outData++ = data[i + 1];  // G
        *outData++ = data[i + 2];  // B
    }
}

// RRRRRRRRGGGGGGGGBBBBBBBB -> RRRRRGGGGGGBBBBB
void convertRGB8ToRGB565(const unsigned char* data, size_t dataLen, unsigned char* outData)
{
    unsigned short* out16 = (unsigned short*)outData;
    for (ssize_t i = 0, l = dataLen - 2; i < l; i += 3)
    {
        *out16++ = (data[i] & 0x00F8) << 8         // R
                   | (data[i + 1] & 0x00FC) << 3   // G
                   | (data[i + 2] & 0x00F8) >> 3;  // B
    }
}

// RRRRRRRRGGGGGGGGBBBBBBBBAAAAAAAA -> RRRRRGGGGGGBBBBB
void convertRGBA8ToRGB565(const unsigned char* data, size_t dataLen, unsigned char* outData)
{
    unsigned short* out16 = (unsigned short*)outData;
    for (ssize_t i = 0, l = dataLen - 3; i < l; i += 4)
    {
        *out16++ = (data[i] & 0x00F8) << 8         // R
                   | (data[i + 1] & 0x00FC) << 3   // G
                   | (data[i + 2] & 0x00F8) >> 3;  // B
    }
}

// RRRRRRRRGGGGGGGGBBBBBBBB -> AAAAAAAA
void convertRGB8ToA8(const unsigned char* data, size_t dataLen, unsigned char* outData)
{
    for (ssize_t i = 0, l = dataLen - 2; i < l; i += 3)
    {
        *outData++ = (data[i] * 299 + data[i + 1] * 587 + data[i + 2] * 114 + 500) /
                     1000;  // A =  (R*299 + G*587 + B*114 + 500) / 1000
    }
}

// RRRRRRRRGGGGGGGGBBBBBBBB -> IIIIIIII
void convertRGB8ToL8(const unsigned char* data, size_t dataLen, unsigned char* outData)
{
    for (ssize_t i = 0, l = dataLen - 2; i < l; i += 3)
    {
        *outData++ = (data[i] * 299 + data[i + 1] * 587 + data[i + 2] * 114 + 500) /
                     1000;  // I =  (R*299 + G*587 + B*114 + 500) / 1000
    }
}

// RRRRRRRRGGGGGGGGBBBBBBBBAAAAAAAA -> IIIIIIII
void convertRGBA8ToL8(const unsigned char* data, size_t dataLen, unsigned char* outData)
{
    for (ssize_t i = 0, l = dataLen - 3; i < l; i += 4)
    {
        *outData++ = (data[i] * 299 + data[i + 1] * 587 + data[i + 2] * 114 + 500) /
                     1000;  // I =  (R*299 + G*587 + B*114 + 500) / 1000
    }
}

// RRRRRRRRGGGGGGGGBBBBBBBBAAAAAAAA -> AAAAAAAA
void convertRGBA8ToA8(const unsigned char* data, size_t dataLen, unsigned char* outData)
{
    for (ssize_t i = 0, l = dataLen - 3; i < l; i += 4)
    {
        *outData++ = data[i + 3];  // A
    }
}

// RRRRRRRRGGGGGGGGBBBBBBBB -> IIIIIIIIAAAAAAAA
void convertRGB8ToLA8(const unsigned char* data, size_t dataLen, unsigned char* outData)
{
    for (ssize_t i = 0, l = dataLen - 2; i < l; i += 3)
    {
        *outData++ = (data[i] * 299 + data[i + 1] * 587 + data[i + 2] * 114 + 500) /
                     1000;  // I =  (R*299 + G*587 + B*114 + 500) / 1000
        *outData++ = 0xFF;
    }
}

// RRRRRRRRGGGGGGGGBBBBBBBBAAAAAAAA -> IIIIIIIIAAAAAAAA
void convertRGBA8ToLA8(const unsigned char* data, size_t dataLen, unsigned char* outData)
{
    for (ssize_t i = 0, l = dataLen - 3; i < l; i += 4)
    {
        *outData++ = (data[i] * 299 + data[i + 1] * 587 + data[i + 2] * 114 + 500) /
                     1000;  // I =  (R*299 + G*587 + B*114 + 500) / 1000
        *outData++ = data[i + 3];
    }
}

// RRRRRRRRGGGGGGGGBBBBBBBB -> RRRRGGGGBBBBAAAA
void convertRGB8ToRGBA4(const unsigned char* data, size_t dataLen, unsigned char* outData)
{
    unsigned short* out16 = (unsigned short*)outData;
    for (ssize_t i = 0, l = dataLen - 2; i < l; i += 3)
    {
        *out16++ = ((data[i] & 0x00F0) << 8        // R
                    | (data[i + 1] & 0x00F0) << 4  // G
                    | (data[i + 2] & 0xF0)         // B
                    | 0x0F);                       // A
    }
}

// RRRRRRRRGGGGGGGGBBBBBBBBAAAAAAAA -> RRRRGGGGBBBBAAAA
void convertRGBA8ToRGBA4(const unsigned char* data, size_t dataLen, unsigned char* outData)
{
    unsigned short* out16 = (unsigned short*)outData;
    for (ssize_t i = 0, l = dataLen - 3; i < l; i += 4)
    {
        *out16++ = (data[i] & 0x00F0) << 8        // R
                   | (data[i + 1] & 0x00F0) << 4  // G
                   | (data[i + 2] & 0xF0)         // B
                   | (data[i + 3] & 0xF0) >> 4;   // A
    }
}

// RRRRRRRRGGGGGGGGBBBBBBBB -> RRRRRGGGGGBBBBBA
void convertRGB8ToRGB5A1(const unsigned char* data, size_t dataLen, unsigned char* outData)
{
    unsigned short* out16 = (unsigned short*)outData;
    for (ssize_t i = 0, l = dataLen - 2; i < l; i += 3)
    {
        *out16++ = (data[i] & 0x00F8) << 8        // R
                   | (data[i + 1] & 0x00F8) << 3  // G
                   | (data[i + 2] & 0x00F8) >> 2  // B
                   | 0x01;                        // A
    }
}

// RRRRRRRRGGGGGGGGBBBBBBBBAAAAAAAA -> RRRRRGGG GGBBBBBA
void convertRGBA8ToRGB5A1(const unsigned char* data, size_t dataLen, unsigned char* outData)
{
    unsigned short* out16 = (unsigned short*)outData;
    for (ssize_t i = 0, l = dataLen - 2; i < l; i += 4)
    {
        *out16++ = (data[i] & 0x00F8) << 8         // R
                   | (data[i + 1] & 0x00F8) << 3   // G
                   | (data[i + 2] & 0x00F8) >> 2   // B
                   | (data[i + 3] & 0x0080) >> 7;  // A
    }
}

void convertRGB5A1ToRGBA8(const unsigned char* data, size_t dataLen, unsigned char* outData)
{
    uint16_t* inData      = (uint16_t*)data;
    const size_t pixelLen = dataLen / 2;
    uint16_t pixel;
    for (size_t i = 0; i < pixelLen; i++)
    {
        pixel      = inData[i];
        *outData++ = (pixel & (0x001F << 11)) >> 8;
        *outData++ = (pixel & (0x001F << 6)) >> 3;
        *outData++ = (pixel & (0x001F << 1)) << 2;
        *outData++ = (pixel & 0x0001) * 255;
    }
}

void convertRGB565ToRGBA8(const unsigned char* data, size_t dataLen, unsigned char* outData)
{
    uint16_t* inData      = (uint16_t*)data;
    const size_t pixelLen = dataLen / 2;
    uint16_t pixel;
    for (size_t i = 0; i < pixelLen; i++)
    {
        pixel      = inData[i];
        *outData++ = (pixel & (0x001F << 11)) >> 8;
        *outData++ = (pixel & (0x003F << 5)) >> 3;
        *outData++ = (pixel & (0x001F)) << 3;
        *outData++ = 0xFF;
    }
}

void convertRGBA4ToRGBA8(const unsigned char* data, size_t dataLen, unsigned char* outData)
{
    uint16_t* inData      = (uint16_t*)data;
    const size_t pixelLen = dataLen / 2;
    uint16_t pixel;
    for (size_t i = 0; i < pixelLen; i++)
    {
        pixel      = inData[i];
        *outData++ = ((pixel & 0xF000) >> 12) * 17;
        *outData++ = ((pixel & 0x0F00) >> 8) * 17;
        *outData++ = ((pixel & 0x00F0) >> 4) * 17;
        *outData++ = ((pixel & 0x000F) * 17);
    }
}

void convertA8ToRGBA8(const unsigned char* data, size_t dataLen, unsigned char* outData)
{
    for (size_t i = 0; i < dataLen; i++)
    {
        *outData++ = 0;
        *outData++ = 0;
        *outData++ = 0;
        *outData++ = data[i];
    }
}

void convertBGRA8ToRGBA8(const unsigned char* data, size_t dataLen, unsigned char* outData)
{
    const size_t pixelCounts = dataLen / 4;
    for (size_t i = 0; i < pixelCounts; i++)
    {
        *outData++ = data[i * 4 + 2];
        *outData++ = data[i * 4 + 1];
        *outData++ = data[i * 4 + 0];
        *outData++ = data[i * 4 + 3];
    }
}

// converter function end
//////////////////////////////////////////////////////////////////////////

ax::backend::PixelFormat convertL8ToFormat(const unsigned char* data,
                                                size_t dataLen,
                                                PixelFormat format,
                                                unsigned char** outData,
                                                size_t* outDataLen)
{
    switch (format)
    {
    case PixelFormat::RGBA8:
        *outDataLen = dataLen * 4;
        *outData    = (unsigned char*)malloc(sizeof(unsigned char) * (*outDataLen));
        convertL8ToRGBA8(data, dataLen, *outData);
        break;
    case PixelFormat::RGB8:
        *outDataLen = dataLen * 3;
        *outData    = (unsigned char*)malloc(sizeof(unsigned char) * (*outDataLen));
        convertL8ToRGB8(data, dataLen, *outData);
        break;
    case PixelFormat::RGB565:
        *outDataLen = dataLen * 2;
        *outData    = (unsigned char*)malloc(sizeof(unsigned char) * (*outDataLen));
        convertL8ToRGB565(data, dataLen, *outData);
        break;
    case PixelFormat::RGBA4:
        *outDataLen = dataLen * 2;
        *outData    = (unsigned char*)malloc(sizeof(unsigned char) * (*outDataLen));
        convertL8ToRGBA4(data, dataLen, *outData);
        break;
    case PixelFormat::RGB5A1:
        *outDataLen = dataLen * 2;
        *outData    = (unsigned char*)malloc(sizeof(unsigned char) * (*outDataLen));
        convertL8ToRGB5A1(data, dataLen, *outData);
        break;
    case PixelFormat::A8:
        *outData    = (unsigned char*)data;
        *outDataLen = dataLen;
        break;
    case PixelFormat::LA8:
        *outDataLen = dataLen * 2;
        *outData    = (unsigned char*)malloc(sizeof(unsigned char) * (*outDataLen));
        convertL8ToLA8(data, dataLen, *outData);
        break;
    default:
        // unsupported conversion or don't need to convert
        if (format != PixelFormat::L8)
        {
            AXLOG(
                "Can not convert image format PixelFormat::L8 to format ID:%d, we will use it's origin format "
                "PixelFormat::L8",
                static_cast<int>(format));
        }

        *outData    = (unsigned char*)data;
        *outDataLen = dataLen;
        return PixelFormat::L8;
    }

    return format;
}

ax::backend::PixelFormat convertLA8ToFormat(const unsigned char* data,
                                                 size_t dataLen,
                                                 PixelFormat format,
                                                 unsigned char** outData,
                                                 size_t* outDataLen)
{
    switch (format)
    {
    case PixelFormat::RGBA8:
        *outDataLen = dataLen * 2;
        *outData    = (unsigned char*)malloc(sizeof(unsigned char) * (*outDataLen));
        convertLA8ToRGBA8(data, dataLen, *outData);
        break;
    case PixelFormat::RGB8:
        *outDataLen = dataLen / 2 * 3;
        *outData    = (unsigned char*)malloc(sizeof(unsigned char) * (*outDataLen));
        convertLA8ToRGB8(data, dataLen, *outData);
        break;
    case PixelFormat::RGB565:
        *outDataLen = dataLen;
        *outData    = (unsigned char*)malloc(sizeof(unsigned char) * (*outDataLen));
        convertLA8ToRGB565(data, dataLen, *outData);
        break;
    case PixelFormat::RGBA4:
        *outDataLen = dataLen;
        *outData    = (unsigned char*)malloc(sizeof(unsigned char) * (*outDataLen));
        convertLA8ToRGBA4(data, dataLen, *outData);
        break;
    case PixelFormat::RGB5A1:
        *outDataLen = dataLen;
        *outData    = (unsigned char*)malloc(sizeof(unsigned char) * (*outDataLen));
        convertLA8ToRGB5A1(data, dataLen, *outData);
        break;
    case PixelFormat::A8:
        *outDataLen = dataLen / 2;
        *outData    = (unsigned char*)malloc(sizeof(unsigned char) * (*outDataLen));
        convertLA8ToA8(data, dataLen, *outData);
        break;
    case PixelFormat::L8:
        *outDataLen = dataLen / 2;
        *outData    = (unsigned char*)malloc(sizeof(unsigned char) * (*outDataLen));
        convertLA8ToL8(data, dataLen, *outData);
        break;
    default:
        // unsupported conversion or don't need to convert
        if (format != PixelFormat::LA8)
        {
            AXLOG(
                "Can not convert image format PixelFormat::LA8 to format ID:%d, we will use it's origin format "
                "PixelFormat::LA8",
                static_cast<int>(format));
        }
        *outData    = (unsigned char*)data;
        *outDataLen = dataLen;
        return PixelFormat::LA8;
        break;
    }

    return format;
}

ax::backend::PixelFormat convertRGB8ToFormat(const unsigned char* data,
                                                  size_t dataLen,
                                                  PixelFormat format,
                                                  unsigned char** outData,
                                                  size_t* outDataLen)
{
    switch (format)
    {
    case PixelFormat::RGBA8:
        *outDataLen = dataLen / 3 * 4;
        *outData    = (unsigned char*)malloc(sizeof(unsigned char) * (*outDataLen));
        convertRGB8ToRGBA8(data, dataLen, *outData);
        break;
    case PixelFormat::RGB565:
        *outDataLen = dataLen / 3 * 2;
        *outData    = (unsigned char*)malloc(sizeof(unsigned char) * (*outDataLen));
        convertRGB8ToRGB565(data, dataLen, *outData);
        break;
    case PixelFormat::RGBA4:
        *outDataLen = dataLen / 3 * 2;
        *outData    = (unsigned char*)malloc(sizeof(unsigned char) * (*outDataLen));
        convertRGB8ToRGBA4(data, dataLen, *outData);
        break;
    case PixelFormat::RGB5A1:
        *outDataLen = dataLen / 3 * 2;
        *outData    = (unsigned char*)malloc(sizeof(unsigned char) * (*outDataLen));
        convertRGB8ToRGB5A1(data, dataLen, *outData);
        break;
    case PixelFormat::A8:
        *outDataLen = dataLen / 3;
        *outData    = (unsigned char*)malloc(sizeof(unsigned char) * (*outDataLen));
        convertRGB8ToA8(data, dataLen, *outData);
        break;
    case PixelFormat::L8:
        *outDataLen = dataLen / 3;
        *outData    = (unsigned char*)malloc(sizeof(unsigned char) * (*outDataLen));
        convertRGB8ToL8(data, dataLen, *outData);
        break;
    case PixelFormat::LA8:
        *outDataLen = dataLen / 3 * 2;
        *outData    = (unsigned char*)malloc(sizeof(unsigned char) * (*outDataLen));
        convertRGB8ToLA8(data, dataLen, *outData);
        break;
    default:
        // unsupported conversion or don't need to convert
        if (format != PixelFormat::RGB8)
        {
            AXLOG(
                "Can not convert image format PixelFormat::RGB8 to format ID:%d, we will use it's origin format "
                "PixelFormat::RGB8",
                static_cast<int>(format));
        }

        *outData    = (unsigned char*)data;
        *outDataLen = dataLen;
        return PixelFormat::RGB8;
    }
    return format;
}

ax::backend::PixelFormat convertRGBA8ToFormat(const unsigned char* data,
                                                   size_t dataLen,
                                                   PixelFormat format,
                                                   unsigned char** outData,
                                                   size_t* outDataLen)
{

    switch (format)
    {
    case PixelFormat::RGB8:
        *outDataLen = dataLen / 4 * 3;
        *outData    = (unsigned char*)malloc(sizeof(unsigned char) * (*outDataLen));
        convertRGBA8ToRGB8(data, dataLen, *outData);
        break;
    case PixelFormat::RGB565:
        *outDataLen = dataLen / 2;
        *outData    = (unsigned char*)malloc(sizeof(unsigned char) * (*outDataLen));
        convertRGBA8ToRGB565(data, dataLen, *outData);
        break;
    case PixelFormat::RGBA4:
        *outDataLen = dataLen / 2;
        *outData    = (unsigned char*)malloc(sizeof(unsigned char) * (*outDataLen));
        convertRGBA8ToRGBA4(data, dataLen, *outData);
        break;
    case PixelFormat::RGB5A1:
        *outDataLen = dataLen / 2;
        *outData    = (unsigned char*)malloc(sizeof(unsigned char) * (*outDataLen));
        convertRGBA8ToRGB5A1(data, dataLen, *outData);
        break;
    case PixelFormat::A8:
        *outDataLen = dataLen / 4;
        *outData    = (unsigned char*)malloc(sizeof(unsigned char) * (*outDataLen));
        convertRGBA8ToA8(data, dataLen, *outData);
        break;
    case PixelFormat::L8:
        *outDataLen = dataLen / 4;
        *outData    = (unsigned char*)malloc(sizeof(unsigned char) * (*outDataLen));
        convertRGBA8ToL8(data, dataLen, *outData);
        break;
    case PixelFormat::LA8:
        *outDataLen = dataLen / 2;
        *outData    = (unsigned char*)malloc(sizeof(unsigned char) * (*outDataLen));
        convertRGBA8ToLA8(data, dataLen, *outData);
        break;
    default:
        // unsupported conversion or don't need to convert
        if (format != PixelFormat::RGBA8)
        {
            AXLOG(
                "Can not convert image format PixelFormat::RGBA8 to format ID:%d, we will use it's origin format "
                "PixelFormat::RGBA8",
                static_cast<int>(format));
        }

        *outData    = (unsigned char*)data;
        *outDataLen = dataLen;
        return PixelFormat::RGBA8;
    }

    return format;
}

ax::backend::PixelFormat convertRGB5A1ToFormat(const unsigned char* data,
                                                    size_t dataLen,
                                                    PixelFormat format,
                                                    unsigned char** outData,
                                                    size_t* outDataLen)
{
    switch (format)
    {
    case PixelFormat::RGBA8:
        *outDataLen = dataLen / 2 * 4;
        *outData    = (unsigned char*)malloc(sizeof(unsigned char) * (*outDataLen));
        convertRGB5A1ToRGBA8(data, dataLen, *outData);
        break;
    case PixelFormat::RGB5A1:
        *outDataLen = dataLen;
        *outData    = (unsigned char*)data;
        break;
    default:
        // unsupported conversion or don't need to convert
        if (format != PixelFormat::RGBA8)
        {
            AXLOG(
                "Can not convert image format PixelFormat::RGB5A1 to format ID:%d, we will use it's origin format "
                "PixelFormat::RGB51A",
                static_cast<int>(format));
        }
        *outData    = (unsigned char*)data;
        *outDataLen = dataLen;
        return PixelFormat::RGBA8;
    }

    return format;
}

ax::backend::PixelFormat convertRGB565ToFormat(const unsigned char* data,
                                                    size_t dataLen,
                                                    PixelFormat format,
                                                    unsigned char** outData,
                                                    size_t* outDataLen)
{
    switch (format)
    {
    case PixelFormat::RGBA8:
        *outDataLen = dataLen / 2 * 4;
        *outData    = (unsigned char*)malloc(sizeof(unsigned char) * (*outDataLen));
        convertRGB565ToRGBA8(data, dataLen, *outData);
        break;
    case PixelFormat::RGB565:
        *outDataLen = dataLen;
        *outData    = (unsigned char*)data;
        break;
    default:
        // unsupported conversion or don't need to convert
        if (format != PixelFormat::RGBA8)
        {
            AXLOG(
                "Can not convert image format PixelFormat::RGB565 to format ID:%d, we will use it's origin format "
                "PixelFormat::RGB565",
                static_cast<int>(format));
        }
        *outData    = (unsigned char*)data;
        *outDataLen = dataLen;
        return PixelFormat::RGBA8;
    }

    return format;
}

ax::backend::PixelFormat convertA8ToFormat(const unsigned char* data,
                                                size_t dataLen,
                                                PixelFormat format,
                                                unsigned char** outData,
                                                size_t* outDataLen)
{
    switch (format)
    {
    case PixelFormat::RGBA8:
        *outDataLen = dataLen * 4;
        *outData    = (unsigned char*)malloc(sizeof(unsigned char) * (*outDataLen));
        convertA8ToRGBA8(data, dataLen, *outData);
        break;
    default:
        // unsupported conversion or don't need to convert
        if (format != PixelFormat::RGBA8)
        {
            AXLOG(
                "Can not convert image format PixelFormat::A8 to format ID:%d, we will use it's origin format "
                "PixelFormat::A8",
                static_cast<int>(format));
        }
        *outData    = (unsigned char*)data;
        *outDataLen = dataLen;
        return PixelFormat::RGBA8;
    }

    return format;
}

ax::backend::PixelFormat convertRGBA4ToFormat(const unsigned char* data,
                                                   size_t dataLen,
                                                   PixelFormat format,
                                                   unsigned char** outData,
                                                   size_t* outDataLen)
{
    switch (format)
    {
    case PixelFormat::RGBA8:
        *outDataLen = dataLen / 2 * 4;
        *outData    = (unsigned char*)malloc(sizeof(unsigned char) * (*outDataLen));
        convertRGBA4ToRGBA8(data, dataLen, *outData);
        break;
    case PixelFormat::RGBA4:
        *outDataLen = dataLen;
        *outData    = (unsigned char*)data;
        break;
    default:
        // unsupported conversion or don't need to convert
        if (format != PixelFormat::RGBA8)
        {
            AXLOG(
                "Can not convert image format PixelFormat::RGBA444 to format ID:%d, we will use it's origin format "
                "PixelFormat::RGBA4",
                static_cast<int>(format));
        }
        *outData    = (unsigned char*)data;
        *outDataLen = dataLen;
        return PixelFormat::RGBA8;
    }

    return format;
}

PixelFormat convertBGRA8ToFormat(const unsigned char* data,
                                 size_t dataLen,
                                 PixelFormat format,
                                 unsigned char** outData,
                                 size_t* outDataLen)
{
    switch (format)
    {
    case PixelFormat::RGBA8:
        *outDataLen = dataLen;
        *outData    = (unsigned char*)malloc(sizeof(unsigned char) * (*outDataLen));
        convertBGRA8ToRGBA8(data, dataLen, *outData);
        break;

    default:
        break;
    }
    return format;
}

/*
 convert map:
 1.PixelFormat::RGBA8
 2.PixelFormat::RGB8
 3.PixelFormat::RGB565
 4.PixelFormat::A8
 5.PixelFormat::L8
 6.PixelFormat::LA8
 7.PixelFormat::RGBA4
 8.PixelFormat::RGB5A1

 gray(5) -> 1235678
 gray alpha(6) -> 12345678
 rgb(2) -> 1235678
 rgba(1) -> 12345678

 */
ax::backend::PixelFormat convertDataToFormat(const unsigned char* data,
                                                  size_t dataLen,
                                                  PixelFormat originFormat,
                                                  PixelFormat format,
                                                  unsigned char** outData,
                                                  size_t* outDataLen)
{
    // don't need to convert
    if (format == originFormat)
    {
        *outData    = (unsigned char*)data;
        *outDataLen = dataLen;
        return originFormat;
    }

    switch (originFormat)
    {
    case PixelFormat::L8:
        return convertL8ToFormat(data, dataLen, format, outData, outDataLen);
    case PixelFormat::LA8:
        return convertLA8ToFormat(data, dataLen, format, outData, outDataLen);
    case PixelFormat::RGB8:
        return convertRGB8ToFormat(data, dataLen, format, outData, outDataLen);
    case PixelFormat::RGBA8:
        return convertRGBA8ToFormat(data, dataLen, format, outData, outDataLen);
    case PixelFormat::RGB5A1:
        return convertRGB5A1ToFormat(data, dataLen, format, outData, outDataLen);
    case PixelFormat::RGB565:
        return convertRGB565ToFormat(data, dataLen, format, outData, outDataLen);
    case PixelFormat::RGBA4:
        return convertRGBA4ToFormat(data, dataLen, format, outData, outDataLen);
    case PixelFormat::A8:
        return convertA8ToFormat(data, dataLen, format, outData, outDataLen);
    case PixelFormat::BGRA8:
        return convertBGRA8ToFormat(data, dataLen, format, outData, outDataLen);
    default:
        AXLOG("unsupported conversion from format %d to format %d", static_cast<int>(originFormat),
              static_cast<int>(format));
        *outData    = (unsigned char*)data;
        *outDataLen = dataLen;
        return originFormat;
    }
}
}  // namespace PixelFormatUtils
}  // namespace backend

NS_AX_END