《基于MFC的OpenGL编程》Part 13 Creating 2D and 3D Text

wglUseFontBitmaps函数

The wglUseFontBitmaps() function creates a set of bitmap display lists based on the glyphs in the currently selected font in the current DC for use in the current OpenGL RC. It basically creates a series of sequential display lists which can be executed using the function glCallLists. The function takes care of aligning the raster positions of subsequent bitmaps once we specify the raster position for the first bitmap. We use the glRasterPos function to set the current raster position, where the bitmapped text would start appearing.

The glRasterPos function works exactly the same way as glVertex function, the only difference being that the position is being transformed and not the object. Thus when we use wglUseFontBitmaps to generate display lists and then call them, the resulting text is displayed, starting at the current raster position, and the bitmaps are copied to the raster buffer, giving the effect of always having the text positioned in the xy plane of the screen.

Thus we would use wglUseFontBitmaps when we need the text to be visible to the user and that the size of the text relative to its distance from the viewpoint doesn't matter.

wglUseFontOutlines函数

The wglUseFontOutlines function creates a set of 3D polygon or line based primitive display lists, based on the glyphs in the currently selected TrueType font in the current DC for use in the current OpenGL RC. Stroke and Raster fonts are not supported. These objects can then be used to draw 3D characters. This function also has additional arguments that control the extrusion of the 3D characters in the +Z direction, the deviation of the generated primitive vertices from the design outline of the font, whether to generated filled polygons or a wireframe primitives and an array of structures to hold the metrics of each of the generated characters.

1，在CCY457OpenGLView类中加入下述变量：

//For Text
GLuint m_3DTextList;
GLuint m_2DTextList;
BOOL m_b3DText, m_b2DText;

并在构造函数中进行初始化：

CCY457OpenGLView::CCY457OpenGLView()
{
m_xRot = 0.0f;
m_yRot = 0.0f;
m_b3DText = FALSE;
m_b2DText = FALSE;
}

2，加入两个用来创建文本的菜单项及其事件处理函数

void CCY457OpenGLView::OnText2dtext()
{
m_b3DText = FALSE;
m_b2DText = TRUE;
InvalidateRect(NULL,FALSE);
}
void CCY457OpenGLView::OnText3dtext()
{
m_b3DText = TRUE;
m_b2DText = FALSE;
InvalidateRect(NULL,FALSE);
}
void CCY457OpenGLView::OnUpdateText2dtext(CCmdUI* pCmdUI)
{
pCmdUI->SetRadio(m_b2DText);
}
void CCY457OpenGLView::OnUpdateText3dtext(CCmdUI* pCmdUI)
{
pCmdUI->SetRadio(m_b3DText);
}

3,实际创建2D和3D文本列表的函数:

void CCY457OpenGLView::Create3DTextLists()
{
CFont m_font;
GLYPHMETRICSFLOAT agmf[256];
m_font.CreateFont( -12, // Height Of Font
0, // Width Of Font
0, // Angle Of Escapement
0, // Orientation Angle
FW_BOLD, // Font Weight
FALSE, // Italic
FALSE, // Underline
FALSE, // Strikeout
ANSI_CHARSET, // Character Set Identifier
OUT_TT_PRECIS, // Output Precision
CLIP_DEFAULT_PRECIS, // Clipping Precision
ANTIALIASED_QUALITY, // Output Quality
FF_DONTCARE|DEFAULT_PITCH, // Family And Pitch
"Algerian");
CFont* m_pOldFont = m_pDC->SelectObject(&m_font);
// create display lists for glyphs 0 through 255 with 0.1 extrusion
// and default deviation. The display list numbering starts at 1000
// (it could be any number)
m_3DTextList = glGenLists(256);
wglUseFontOutlines(m_pDC->GetSafeHdc(), 0, 255, m_3DTextList, 0.0f, 0.5f,WGL_FONT_POLYGONS, agmf);
m_pDC->SelectObject(m_pOldFont);
}
void CCY457OpenGLView::Create2DTextLists()
{
CFont m_font;
m_font.CreateFont( -24, // Height Of Font
0, // Width Of Font
0, // Angle Of Escapement
0, // Orientation Angle
FW_NORMAL, // Font Weight
FALSE, // Italic
FALSE, // Underline
FALSE, // Strikeout
ANSI_CHARSET, // Character Set Identifier
OUT_TT_PRECIS, // Output Precision
CLIP_DEFAULT_PRECIS, // Clipping Precision
DEFAULT_QUALITY, // Output Quality
FF_DONTCARE|DEFAULT_PITCH, // Family And Pitch
"Algerian");
CFont* m_pOldFont = m_pDC->SelectObject(&m_font);
// create display lists for glyphs 0 through 255 with 0.1 extrusion
// and default deviation. The display list numbering starts at 1000
// (it could be any number)
m_2DTextList = glGenLists(256);
wglUseFontBitmaps(m_pDC->GetSafeHdc(), 0, 255, m_2DTextList);
m_pDC->SelectObject(m_pOldFont);
}

4, InitializeOpenGL函数中调用上述两个函数：

BOOL CCY457OpenGLView::InitializeOpenGL()
{
//Get a DC for the Client Area
m_pDC = new CClientDC(this);
//Failure to Get DC
if(m_pDC == NULL)
{
MessageBox("Error Obtaining DC");
return FALSE;
}
//Failure to set the pixel format
if(!SetupPixelFormat())
{
return FALSE;
}
//Create Rendering Context
m_hRC = ::wglCreateContext (m_pDC->GetSafeHdc ());
//Failure to Create Rendering Context
if(m_hRC == 0)
{
MessageBox("Error Creating RC");
return FALSE;
}
//Make the RC Current
if(::wglMakeCurrent (m_pDC->GetSafeHdc (), m_hRC)==FALSE)
{
MessageBox("Error making RC Current");
return FALSE;
}

//Specify Black as the clear color
::glClearColor(0.0f,0.0f,0.0f,0.0f);
//Specify the back of the buffer as clear depth
::glClearDepth(1.0f);
//Enable Depth Testing
::glEnable(GL_DEPTH_TEST);
glShadeModel(GL_FLAT);
SetupLighting();
//Create Font Display Lists
Create2DTextLists();
Create3DTextLists();
return TRUE;
}

5，绘制函数修改如下：

void CCY457OpenGLView::RenderScene ()
{//绘制函数
glTranslatef(-1.0f,0.0f,-5.0f);
glRotatef(-10.0,1.0f,0.0f,0.0f);
glRotatef(-10.0,0.0f,1.0f,0.0f);
if(m_b2DText)
{//2D文本
// Position The Text On The Screen
glDisable(GL_LIGHTING);
glColor3f(1.0f,1.0f,0.0f);
glRasterPos2f(0,0);
glListBase(m_2DTextList);
glCallLists(6, GL_UNSIGNED_BYTE ,"OpenGL");
glEnable(GL_LIGHTING);
}
if(m_b3DText)
{//3D文本
glListBase(m_3DTextList);
glCallLists(6, GL_UNSIGNED_BYTE ,"OpenGL");
}
}