kengine

从今天开始，我将每天用一个小时分析KEngine，一个3d引擎。由于第一次对一个引擎进行分析，将按文件在程序中的组织顺序逐个文件进行分析。首先是KBMPFont类文件。

文中使用显示列表来创建位图字体，共产生256个显示列表，对应char类型所代表的所有字符。首先通过CreateFont创建字体。通过SelectObject为HDC选择字体。ascii基本可视集从十进制32开始.用wglUseFontBitmaps或wglUseFontOutlines为每个字创建一个list通过glCallList或glCallLists调用。

在OpenGL初始化的末尾建立字体： 
#define LISTBASE 1000 
wglUseFontBitmaps(hDC,0,255,LSITBASE); 
在需要输出文字的地方调用 
char pMyString="OpenGL Text Info"; 
glListBase(LISTBASE); 
glCallLists(strlen(pMyString),GL_UNSIGNED_BYTE,pMyString);

Windows系统中，可以使用wglUseFontBitmaps函数来批量的产生显示字符用的显示列表。函数有四个参数：
第一个参数是HDC，学过Windows GDI的朋友应该会熟悉这个。如果没有学过，那也没关系，只要知道调用wglGetCurrentDC函数，就可以得到一个HDC了。具体的情况可以看下面的代码。
第二个参数表示第一个要产生的字符，因为我们要产生0到127的字符的显示列表，所以这里填0。
第三个参数表示要产生字符的总个数，因为我们要产生0到127的字符的显示列表，总共有128个字符，所以这里填128。
第四个参数表示第一个字符所对应显示列表的编号。假如这里填1000，则第一个字符的绘制命令将被装到第1000号显示列表，第二个字符的绘制命令将被装到第1001号显示列表，依次类推。我们可以先用glGenLists申请128个连续的显示列表编号，然后把第一个显示列表编号填在这里。
还要说明一下，因为wglUseFontBitmaps是Windows系统特有的函数，所以在使用前需要加入头文件：#include <windows.h>。
现在让我们来看具体的代码：

#include <windows.h>

// ASCII字符总共只有0到127，一共128种字符
#define MAX_CHAR       128

void drawString(const char* str) {
    static int isFirstCall = 1;
    static GLuint lists;

    if( isFirstCall ) { // 如果是第一次调用，执行初始化
                        // 为每一个ASCII字符产生一个显示列表
        isFirstCall = 0;

        // 申请MAX_CHAR个连续的显示列表编号
        lists = glGenLists(MAX_CHAR);

        // 把每个字符的绘制命令都装到对应的显示列表中
        wglUseFontBitmaps(wglGetCurrentDC(), 0, MAX_CHAR, lists);
    }
    // 调用每个字符对应的显示列表，绘制每个字符
    for(; *str!='/0'; ++str)
        glCallList(lists + *str);
}

显示列表一旦产生就一直存在（除非调用glDeleteLists销毁），所以我们只需要在第一次调用的时候初始化，以后就可以很方便的调用这些显示列表来绘制字符了。
绘制字符的时候，可以先用glColor*等指定颜色，然后用glRasterPos*指定位置，最后调用显示列表来绘制。

void display(void) {
    glClear(GL_COLOR_BUFFER_BIT);

    glColor3f(1.0f, 0.0f, 0.0f);
    glRasterPos2f(0.0f, 0.0f);
    drawString("Hello, World!");

    glutSwapBuffers();
}

 

原则上，显示中文和显示英文并无不同，同样是把要显示的字符做成显示列表，然后进行调用。
但是有一个问题，英文字母很少，最多只有几百个，为每个字母创建一个显示列表，没有问题。但是汉字有非常多个，如果每个汉字都产生一个显示列表，这是不切实际的。
我们不能在初始化时就为每个字符建立一个显示列表，那就只有在每次绘制字符时创建它了。当我们需要绘制一个字符时，创建对应的显示列表，等绘制完毕后，再将它销毁。
这里还经常涉及到中文乱码的问题，我对这个问题也不甚了解，但是网上流传的版本中，使用了MultiByteToWideChar这个函数的，基本上都没有出现乱码，所以我也准备用这个函数:)
通常我们在C语言里面使用的字符串，如果中英文混合的话，例如“this is 中文字符.”，则英文字符只占用一个字节，而中文字符则占用两个字节。用MultiByteToWideChar函数，可以转化为所有的字符都占两个字节（同时解决了前面所说的乱码问题:)）。
转化的代码如下：

 

// 计算字符的个数
// 如果是双字节字符的（比如中文字符），两个字节才算一个字符
// 否则一个字节算一个字符
len = 0;
for(i=0; str[i]!='/0'; ++i)
{
    if( IsDBCSLeadByte(str[i]) )
        ++i;
    ++len;
}

// 将混合字符转化为宽字符
wstring = (wchar_t*)malloc((len+1) * sizeof(wchar_t));
MultiByteToWideChar(CP_ACP, MB_PRECOMPOSED, str, -1, wstring, len);
wstring[len] = L'/0';

// 用完后记得释放内存
free(wstring);

加上前面所讲到的wglUseFontBitmaps函数，即可显示中文字符了。

void drawCNString(const char* str) {
    int len, i;
    wchar_t* wstring;
    HDC hDC = wglGetCurrentDC();
    GLuint list = glGenLists(1);

    // 计算字符的个数
    // 如果是双字节字符的（比如中文字符），两个字节才算一个字符
    // 否则一个字节算一个字符
    len = 0;
    for(i=0; str[i]!='/0'; ++i)
    {
        if( IsDBCSLeadByte(str[i]) )
            ++i;
        ++len;
    }

    // 将混合字符转化为宽字符
    wstring = (wchar_t*)malloc((len+1) * sizeof(wchar_t));
    MultiByteToWideChar(CP_ACP, MB_PRECOMPOSED, str, -1, wstring, len);
    wstring[len] = L'/0';

    // 逐个输出字符
    for(i=0; i<len; ++i)
    {
        wglUseFontBitmapsW(hDC, wstring[i], 1, list);
        glCallList(list);
    }

    // 回收所有临时资源
    free(wstring);
    glDeleteLists(list, 1);
}

注意我用了wglUseFontBitmapsW函数，而不是wglUseFontBitmaps。wglUseFontBitmapsW是wglUseFontBitmaps函数的宽字符版本，它认为字符都占两个字节。因为这里使用了MultiByteToWideChar，每个字符其实是占两个字节的，所以应该用wglUseFontBitmapsW。

void display(void) {
    glClear(GL_COLOR_BUFFER_BIT);

    selectFont(48, ANSI_CHARSET, "Comic Sans MS");
    glColor3f(1.0f, 0.0f, 0.0f);
    glRasterPos2f(-0.7f, 0.4f);
    drawString("Hello, World!");

    selectFont(48, GB2312_CHARSET, "楷体_GB2312");
    glColor3f(1.0f, 1.0f, 0.0f);
    glRasterPos2f(-0.7f, -0.1f);
    drawCNString("当代的中国汉字");

    selectFont(48, DEFAULT_CHARSET, "华文仿宋");
    glColor3f(0.0f, 1.0f, 0.0f);
    glRasterPos2f(-0.7f, -0.6f);
    drawCNString("傳統的中國漢字");

    glutSwapBuffers();
}