图形学笔记 -- OpenGL 像素格式 与 图像格式

WINGDIAPI void APIENTRY glTexImage2D (
    GLenum target,
    GLint level,
    GLint internalformat, // OpenGL 内部存储格式
    GLsizei width,
    GLsizei height,
    GLint border,
    GLenum format, GLenum type, // 定义了 pixels 内存结构
    const GLvoid *pixels
);

// ES 2.0 says internalFormat must match pixelFormat (chapter 3.7.1 in Spec).
// Doesn't mention if "match" means "equal" or some other way of matching, but
// some bug on Emscripten and browsing discussions by others lead me to believe
// it means they have to be equal. Note that this was different in OpenGL.
internalFormat = pixelFormat;

/* PixelFormat */
#define GL_RED                            0x1903
#define GL_GREEN                          0x1904
#define GL_BLUE                           0x1905
#define GL_ALPHA                          0x1906
#define GL_RGB                            0x1907
#define GL_RGBA                           0x1908

/* EXT_bgra pixelFormat */
#define GL_BGR_EXT                        0x80E0
#define GL_BGRA_EXT                       0x80E1

#define GL_ABGR_EXT                       0x8000 // GL_EXT_abgr
#define GL_BGRA8_EXT                      0x93A1 // 不常用

/* texture */
#define GL_ALPHA4                         0x803B
#define GL_ALPHA8                         0x803C
#define GL_ALPHA12                        0x803D
#define GL_ALPHA16                        0x803E
#define GL_R3_G3_B2                       0x2A10
#define GL_RGB4                           0x804F
#define GL_RGB5                           0x8050
#define GL_RGB8                           0x8051
#define GL_RGB10                          0x8052
#define GL_RGB12                          0x8053
#define GL_RGB16                          0x8054
#define GL_RGBA2                          0x8055
#define GL_RGBA4                          0x8056
#define GL_RGB5_A1                        0x8057
#define GL_RGBA8                          0x8058
#define GL_RGB10_A2                       0x8059
#define GL_RGBA12                         0x805A
#define GL_RGBA16                         0x805B

typedef struct tagPIXELFORMATDESCRIPTOR { // pfd
    WORD nSize; // nSize 是象素格式描述子结构的大小，sizeof(PIXELFORMATDESCRIPTOR) 设定其值；
    WORD nVersion; // nVersion 是 PIXELFORMATDESCRIPTOR 结构的版本，一般设为 1；
    DWORD dwFlags;  // dwFlags 是一组表明象素缓冲特性的标志位，如缓冲是否支持 GDI 或 OpenGL 等；
    BYTE iPixelType;  // iPixelType 说明象素数据类型是 RGBA 还是颜色索引；
    BYTE cColorBits; // cColorBits 每个颜色缓冲区中颜色位平面的数目，对颜色索引方式是缓冲区大小；
    BYTE cRedBits; // cRedBits 每个 RGBA 颜色缓冲区中红色位平面的数目；
    BYTE cRedShift; // cRedShift 每个 RGBA 颜色缓冲区中红色位平面的偏移数；
    BYTE cGreenBits; // cGreenBits 每个 RGBA 颜色缓冲区中绿色位平面的数目；
    BYTE cGreenShift; // cGreenShift 每个 RGBA 颜色缓冲区中绿色位平面的偏移数；
    BYTE cBlueBits; // cBlueBits 每个 RGBA 颜色缓冲区中蓝色位平面的数目；
    BYTE cBlueShift; // cBlueShift 每个 RGBA 颜色缓冲区中蓝色位平面的偏移数；
    BYTE cAlphaBits; // cAlphaBits 每个 RGBA 颜色缓冲区中 alpha 位平面的数目（保留的，现不支持）；
    BYTE cAlphaShift; // cAlphaShift 每个 RGBA 颜色缓冲区中 alpha 位平面的偏移数（保留的，现不支持）；
    BYTE cAccumBits; // cAccumBits 累加缓冲区中全部位平面的数目；
    BYTE cAccumRedBits; // cAccumRedBits 累加缓冲区中红色位平面的数目；
    BYTE cAccumGreenBits; // cAccumGreenBits 累加缓冲区中绿色位平面的数目；
    BYTE cAccumBlueBits; // cAccumBlueBits 累加缓冲区中蓝色位平面的数目；
    BYTE cAccumAlphaBits; // cAccumAlphaBits 累加缓冲区中 alpha 位平面的数目；
    BYTE cDepthBits; // cDepthBits Z（深度）缓冲区的深度；
    BYTE cStencilBits; // cStencilBits 模板缓冲区的深度；
    BYTE cAuxBuffers; // cAuxBuffers 轴向缓冲区的数量（一般 1.0 版本不支持）；
    BYTE iLayerType; // iLayerType 被忽略，为了一致性而包含的；
    BYTE bReserved; // bReserved 表层和底层平面的数量::位 0-3 表最多 15 层表层平面，位 4-7 表底层；
    DWORD dwLayerMask; // dwLayerMask 被忽略，为了一致性而包含的；
    DWORD dwVisibleMask; // dwVisibleMask 是透明色彩的值（RGBA 方式）或是一个底层平面的索引（Index）；
    DWORD dwDamageMask; // dwDamageMask 被忽略，为了一致性而包含的。
} PIXELFORMATDESCRIPTOR;

//! An enum for the color format of textures used by the Irrlicht Engine.
/** A color format specifies how color information is stored.
    NOTE: Byte order in memory is usually flipped (it's probably correct in bitmap files, but flipped on reading).
    So for example ECF_A8R8G8B8 is BGRA in memory same as in DX9's D3DFMT_A8R8G8B8 format.
*/
enum ECOLOR_FORMAT {

//! Default 32 bit color format. 8 bits are used for every component: red, green, blue and alpha.
//! Warning: This tends to be BGRA in memory (it's ARGB on file, but with usual big-endian memory it's flipped)
    ECF_A8R8G8B8,
};

//! Converts color to OpenGL color format
/** From ARGB to RGBA in 4 byte components for endian aware passing to OpenGL
\param dest: address where the 4x8 bit OpenGL color is stored.
*/
void toOpenGLColor(u8* dest) const
{
    *dest =   (u8)getRed();
    *++dest = (u8)getGreen();
    *++dest = (u8)getBlue();
    *++dest = (u8)getAlpha();
}

#ifdef __BIG_ENDIAN__
    ((u32*)out)[x] = c << 24 | c << 16 | c << 8 | 0x000000FF;
#else
    ((u32*)out)[x] = 0xFF000000 | c << 16 | c << 8 | c;
#endif

#if OGRE_ENDIAN == ENDIAN_BIG
    /// 3 byte pixel format, 1 byte for red, 1 byte for green, 1 byte for blue
    PF_BYTE_RGB = PF_R8G8B8,
    /// 3 byte pixel format, 1 byte for blue, 1 byte for green, 1 byte for red
    PF_BYTE_BGR = PF_B8G8R8,
    /// 4 byte pixel format, 1 byte for blue, 1 byte for green, 1 byte for red and one byte for alpha
    PF_BYTE_BGRA = PF_B8G8R8A8,
#else
    /// 3 byte pixel format, 1 byte for red, 1 byte for green, 1 byte for blue
    PF_BYTE_RGB = PF_B8G8R8,
    /// 3 byte pixel format, 1 byte for blue, 1 byte for green, 1 byte for red
    PF_BYTE_BGR = PF_R8G8B8,
    /// 4 byte pixel format, 1 byte for blue, 1 byte for green, 1 byte for red and one byte for alpha
    PF_BYTE_BGRA = PF_A8R8G8B8,
#endif