SDL入门教程（九）：1、在SDL图形窗口显示文本

作者：龙飞

        最近几篇教程基本上都是参考着Lazy Foo的教程顺序来的。因为我也觉得他的顺序很实用。所不同的是，新的类型我都添加在了之前建立起来的surface类的基础之上。所以，如果你觉得单独看这些教程完全搞不明白，最好从头按照顺序来学习。另外，为了复习C++知识，也为了遵循C++的理念，我有意的将程序风格向C++靠拢。如果你更喜欢C风格，相信你在其他地方可以找到更适合你的教程。

1.1：一个小细节，SDL窗口的名称

        因为涉及到文本的显示了，我们提一个一直以来忽略的问题——SDL建立起来的窗口的名字。因为我们所建立起来的Screen Surface是唯一和特殊的。所以窗口名字这个行为是可以绑定在这个唯一的Screen Surface对象上的。SDL中的相关函数是：

void  SDL_WM_SetCaption( const   char   * title,  const   char   * icon);

        一般icon还暂时用不上，我们设置为空指针。我们修改一下Screen Surface的数据成员与构造函数。在数据成员里面添加一个windowName，并且修改构造函数

class  ScreenSurface
{
private :
     //
     char *  windowName;
public :
   //
   ScreenSurface(int w, int h, char* window_name = 0, int b = 0, Uint32 f = 0); 
};

ScreenSurface::ScreenSurface():
width( 640 ), height( 480 ), bpp( 32 ), flags( 0 ), windowName( 0 )
{
     if  ( screenNum  >   0  )
         throw  ErrorInfo( " DONOT create more than ONE screen! " );
     if  ( SDL_Init(SDL_INIT_VIDEO  <   0  ) )
         throw  ErrorInfo(SDL_GetError());
    pScreen  =  SDL_SetVideoMode(width, height, bpp, flags);
    screenNum ++ ;
}

ScreenSurface::ScreenSurface( int  w,  int  h,  char *  window_name,  int  b, Uint32 f):
width(w), height(h), bpp(b), flags(f)
{
     if  ( screenNum  >   0  )
         throw  ErrorInfo( " DONOT create more than ONE screen! " );
     if  ( SDL_Init(SDL_INIT_VIDEO  <   0  ) )
         throw  ErrorInfo(SDL_GetError());
    pScreen  =  SDL_SetVideoMode(width, height, bpp, flags);
    screenNum ++ ;
     if  ( window_name  !=   0  ) {
        windowName  =  window_name;
        SDL_WM_SetCaption(windowName,  0 );
    }
     else
        windowName  =   0 ;
}

这样，我们在创建SceenSurface的时候，第三个参数如果指定，则可以用字符串表示窗口名称。

1.2：使用*.ttf文件

        SDL使用*.ttf文件，仍然需要扩展库的支持。相关的下载和SDL_image的类似，大家可以参考前面的教程。下载地址如下：
http://www.libsdl.org/projects/SDL_ttf/
        使用ttf扩展库的程序如下：
(1)装载扩展库：TTF_Init();
(2)打开字库：TTF_OpenFont(const char* ttf_fileName, int ttf_size);
(3)构建显示文本的surface：TTF_RenderText_Solid(TTF_Font* pFont, const char* message, SDL_Color textColor);
(4)显示（blit）文本surface;
(5)关闭字库：TTF_CloseFont();
(6)退出扩展库：TTF_Quit();
(7)释放显示文本的surface：SDL_FreeSurface();
        我们考虑下这个TextSurface与之前的DisplaySurface之间的关系，希望通过类将二者有所联系。

1.3：构建TextSurface类

        我们分析下TextSurface与DisplaySurface的关系：他们都依赖于一个ScreenSurface对象，至少具有两个一样的私有数据成员pSurface和pScreen；他们有一致的行为blit()；他们的构造前提条件不同，析构做的“善后”也不一样。
        我在水木社区的CPP版请教有这样关系的两个类应该是什么关系。有前辈指教说，一个类，用不同的flag加以区分。而我并不愿意多增加一个构造函数的参数，所以，我用构造函数的重载实现构造的不同；用继承类实现方法代码的重用；用继承类的析构函数为TextSurface类做额外的析构工作。
        考虑到应在第一次建立TextSurface对象的时候装载ttf扩展库，并在最后一个对象使用完毕后关闭ttf扩展库，所以，在基类DisplaySurface中添加静态私有成员作为计数器，并添加相应的方法为派生类使用。这些方法，以及专门为派生类创建的基类构造函数，我们并不希望能被外部使用，所以，使用了关键字proteced。

class  DisplaySurface
{
private :
     //
     // for TextSurafce
     static   int  textNum;
    TTF_Font *  pFont;
public :
     //
protected :
     // for TextSurface
    DisplaySurface( const  std:: string &  msg_name,  const  std:: string &  message,  const  ScreenSurface &  screen,
                    Uint8 r, Uint8 g, Uint8 b, 
                     const  std:: string &  ttf_fileName,  int  ttf_size);
     int  tellTextNum()  const ;
     void  reduceTextNum();
     void  deleteFontPoint();
};

pFont是TextSurface会用到的私有数据，构造基类的时候，直接设置成空指针就可以了。
保护成员的实现如下：

// for TextSurface
DisplaySurface::DisplaySurface( const  std:: string &  msg_name,  const  std:: string &  message,  const  ScreenSurface &  screen,
                    Uint8 r, Uint8 g , Uint8 b, 
                     const  std:: string &  ttf_fileName,  int  ttf_size):
fileName(msg_name)
{
     if  ( textNum  ==   0  )
         if  ( TTF_Init()  <   0  )
             throw  ErrorInfo( " TTF_Init() failed! " );
    
    SDL_Color textColor;
    textColor.r  =  r;
    textColor.g  =  g;
    textColor.b  =  b;

    pFont  =  TTF_OpenFont(ttf_fileName.c_str(), ttf_size);
     if  ( pFont  ==   0  )
         throw  ErrorInfo( " TTF_OpenFont() failed! " );

    pSurface  =  TTF_RenderText_Solid(pFont, message.c_str(), textColor);
     if  ( pSurface  ==   0  )
         throw  ErrorInfo( " TTF_RenderText_solid() failed! " );
    pScreen  =  screen.point();

    textNum ++ ;
}

int  DisplaySurface::tellTextNum()  const
{
     return  textNum;
}

void  DisplaySurface::reduceTextNum()
{
    textNum -- ;
}

void  DisplaySurface::deleteFontPoint()
{
    TTF_CloseFont(pFont);
}

有了这些数据成员和方法，我们可以构建TextSurface类了。

class  TextSurface:  public  DisplaySurface
{
public :
    TextSurface( const  std:: string &  msg_name,  const  std:: string &  message,  const  ScreenSurface &  screen,
                    Uint8 r  =   0xFF , Uint8 g  =   0xFF , Uint8 b  =   0xFF , 
                     const  std:: string &  ttf_fileName  =   " lazy.ttf " ,  int  ttf_size  =   28 );
     ~ TextSurface();
};

可以看到，我们仅仅增添了派生类的构造函数和析构函数，实现如下：

// class TextSurface

TextSurface::TextSurface( const  std:: string &  msg_name,  const  std:: string &  message,  const  ScreenSurface &  screen,
                    Uint8 r, Uint8 g, Uint8 b, 
                     const  std:: string &  ttf_fileName,  int  ttf_size):
DisplaySurface(msg_name, message, screen, r, g, b, ttf_fileName, ttf_size)
{}

TextSurface:: ~ TextSurface()
{
    deleteFontPoint();
    reduceTextNum();
     if  ( tellTextNum()  ==   0  )
        TTF_Quit();
}

我们在下节给出完整的代码以及一个用于演示的例子。