SDL文字和图形

SDL本身没有显示文字功能，它需要用扩展库SDL_ttf来显示文字。ttf是True Type Font的缩写，ttf是Windows下的缺省字体，它有美观，放大缩小不变形的优点，因此广泛应用很多场合。freeType是一个跨平台开源项目， 它可以在利用ttf字体输出到屏幕上。一般的linux发行版本都带了这个库（libfreetype.so），Windows下也有相应的移植版本。

    SDL_ttf封装freetype的库函数，提供一些简化的扩展接口提供SDL开发者使用。

使用ttf库的第一件事要从Windows的字库下拷贝出一个字库出来，最好是中文字体，这样可以同时支持英文和中文显示。它一般在c:windows fonts 目录下面。比如simsun.ttf 就是仿宋体的字库，将这个文件拷贝到你的项目目录下。或者一个指定目录。

 

在上一篇，加入下面代码：

Tao.Sdl.SdlTtf.TTF_Init();

            font36 = Tao.Sdl.SdlTtf.TTF_OpenFont(Application.StartupPath + "\simfang.ttf", 36);

            if (font36 == IntPtr.Zero)

            {

                MessageBox.Show("SDL字体初始化失败！");

                return;

            }

 

            font24 = Tao.Sdl.SdlTtf.TTF_OpenFont(Application.StartupPath + "\simfang.ttf", 24);

            if (font24 == IntPtr.Zero)

            {

                font24 = font36;

            }

            Tao.Sdl.SdlTtf.TTF_SetFontStyle(font36, Tao.Sdl.SdlTtf.TTF_STYLE_BOLD);

            Tao.Sdl.SdlTtf.TTF_SetFontStyle(font24, Tao.Sdl.SdlTtf.TTF_STYLE_BOLD);

 

            int w = 0, h = 0;

            Tao.Sdl.SdlTtf.TTF_SizeUNICODE(font36, "测试文字1", out w, out h);

            rect2 = new Tao.Sdl.Sdl.SDL_Rect(5, (short)(20), 400, 400);

            IntPtr chinese = Tao.Sdl.SdlTtf.TTF_RenderUNICODE_Blended(font36, "测试文字1",new Tao.Sdl.Sdl.SDL_Color(255, 255, 0));

            Tao.Sdl.Sdl.SDL_BlitSurface(chinese, ref rect, surfacePtr, ref rect2);

            Tao.Sdl.Sdl.SDL_FreeSurface(chinese);

 

            rect2 = new Tao.Sdl.Sdl.SDL_Rect(5, (short)(20 + h), 400, 400);

            chinese = Tao.Sdl.SdlTtf.TTF_RenderUNICODE_Blended(font24, "测试文字2", newTao.Sdl.Sdl.SDL_Color(255, 0, 255));

            Tao.Sdl.Sdl.SDL_BlitSurface(chinese, ref rect, surfacePtr, ref rect2);

            Tao.Sdl.Sdl.SDL_FreeSurface(chinese);

 

            Tao.Sdl.SdlGfx.stringRGBA(surfacePtr, 300, 300, "test string", 0, 255, 0, 255);

 

            Tao.Sdl.SdlGfx.lineRGBA(surfacePtr, 150, 150, 300, 300, 255, 60, 255, 255);

 

            short[] xs = new short[4];

            short[] ys = new short[4];

            xs[0] = 20;

            xs[1] = 120;

            xs[2] = 120;

            xs[3] = 20;

            ys[0] = 20;

            ys[1] = 20;

            ys[2] = 120;

            ys[3] = 120;

            Tao.Sdl.SdlGfx.polygonRGBA(surfacePtr, xs, ys, 4, 255, 0, 0, 255);

 

            Tao.Sdl.SdlGfx.circleRGBA(surfacePtr, 200, 200, 100, 0, 0, 255, 255);

 

            Tao.Sdl.SdlGfx.boxRGBA(surfacePtr, 350, 350, 450, 450, 0, 0, 255, 255);

 

            Tao.Sdl.SdlGfx.filledTrigonRGBA(surfacePtr, 300, 50, 200, 150, 400, 150, 255, 255, 0, 255);

 

            Tao.Sdl.Sdl.SDL_Flip(surfacePtr);

            Tao.Sdl.Sdl.SDL_UpdateRect(surfacePtr, 0, 0, rect.w, rect.h);

 

释放：

Tao.Sdl.SdlTtf.TTF_CloseFont(font36);

            Tao.Sdl.SdlTtf.TTF_CloseFont(font24);

            Tao.Sdl.SdlTtf.TTF_Quit();

 

TTF_OpenFont：打开字体，因为中途不能修改字体大小，所以打开2个，没办法的办法。另外注意字体路径下不能包含任何中文字符。

TTF_SetFontStyle：设置字体样式

TTF_SizeUNICODE：获取字体高度宽度，可以控制字符间距和行距。

TTF_RenderUNICODE_Blended：渲染字体，得到一个surface

stringRGBA：只能渲染英文字符，比较简单

lineRGBA：画线

polygonRGBA：画面

circleRGBA：画圆

boxRGBA：画填充矩形

filledTrigonRGBA：画填充三角形

 

SDL_ttf的编程的核心数据结构是TTF_Font 所有的文字输出都是围绕这个结构展开的。

    显示一段文字的流程

    一.初始TTF库

    二.创建一个对应某个字体文件的TTF_Font.

    三.用TTF输出函数把一段文字输出成SDL_Surface.其中TTF_font是其中必须参数

    四.把这个SDL_Surface 输出到屏幕显示，如果不需它，必须释放它

    五.释放TTF_Font

    六.关闭TTF库

其中在一个程序中，可以同时打开多个TTF_Font.可以可以用输出方法输出N个SDL_Surface.这个完全看你的设计要求。只要在退出时记得一一释放即可。

 

关于中文输出

 

    这个问题是一个比较复杂的问题，复杂的原因在于SDL是一个跨平台的库，而两大平台Linux和Windows对于中文的内部编码是不一致的。分别采用UTF-8和Unicode.

    而SDL_ttf对于编码是非常敏感的，必须明确告诉它是哪一种编码，才能正确输出。否则将输出乱码。可以用iconv转换编码。

    SDL两种编码都可以直接输出

    UNICODE输出:

    SDL_Surface *TTF_RenderUNICODE_Solid(TTF_Font *font, const Uint16 *text, SDL_Color fg) ;

    UTF-8输出:

    SDL_Surface *TTF_RenderUTF8_Solid(TTF_Font *font, const char *text, SDL_Color fg) ;

    简单言之，如果你的在LINUX下输入在代码中直接写成的中文，那它就是UTF-8的编码，如果在WINDOWS用文本编辑器输出中文，它就是Unicode的编码，这个你可以用二进制编辑工具查看。

    这样如果源码是在WINDOWS编辑后，拷贝到LINUX上编译，这个时候就会发生混乱了，用TTF_RenderUTF8_Solid输出必然是乱码.

    所以为了保险，可以在源代码用数组用固定的编码。这样无论在哪个平台都能正确输出。另外一种情况把文件写在带BOM头的文件里，这样可以知道文件内部编码，以便程序采用相应用输出。

    还一些特殊情况，比如网上所有LRC歌词文件，必须是GBK格式，实测所有音乐软件都只认这个编码。这样需要用iconv转换成Unicode或UTF-8格式.

    同样的 Unicode/UTF-8的输出还有其它两组

    TTF_RenderUTF8_Shaded

    TTF_RenderUNICODE_Shaded

    TTF_RenderUTF8_Blended

    TTF_RenderUNICODE_Blended