SDL2 显示文字

1.简介

SDL本身没有显示文字功能，它需要用扩展库SDL_ttf来显示文字。ttf是True Type Font的缩写，ttf是Windows下的缺省字体，它有美观，放大缩小不变形的优点，因此广泛应用很多场合。

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

要使用SDL_ttf库首先要下载该扩展库：为了方便，我使用的开发环境是Windows。 

下载地址：Releases · libsdl-org/SDL_ttf · GitHub

我使用的是2.20.0的版本，下载我框出来的那个zip包。

2.配置环境

先拷贝SDL_ttf的头文件和库文件到目的目录下，如下图所示：

 

VS的配置请看SDL2 简单介绍以及Windows开发环境搭建-CSDN博客

目录4.配置，跟配置SDL库一样的配置。

3.使用步骤

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

• 初始TTF库
• 创建一个对应某个字体文件的TTF_Font.
• 用TTF输出函数把一段文字输出成SDL_Surface.其中TTF_font是其中必须参数
• 把这个SDL_Surface 输出到屏幕显示，如果不需它，必须释放它
• 释放TTF_Font
• 关闭TTF库

4.接口说明

要想显示文字，首先要将文字渲染成一副图像，将文字渲染成一个图像表面，有三种渲染方式：

• TTF_RenderText_Solid渲染的最快，但效果最差，文字不平滑，是单色文字，不带边框。
• TTF_RenderText_Shaded比TTF_RenderText_Solid渲染的慢，但显示效果好于Solid，带阴影。
• TTF_RenderUTF8_Blended渲染最慢，但显示效果最好。

SDL_ttf有好几个关于文字高度和宽度的方法：

• int TTF_SizeText(TTF_Font *font, const char *text, int *w, int *h) ;求英文/数字文本高度和宽度,返回值为0表示测试成功
• int TTF_SizeUTF8(TTF_Font *font, const char *text, int *w, int *h) ;求UTF-8文本高宽
• int TTF_SizeUNICODE(TTF_Font *font, const Unit16 *text, int *w, int *h) ;求Unicode文本高宽

TTF使用TF_SetFontStyle(TTF_Font *font, int style)显示特殊效果，style 参数可以设为如下几种效果：

• TTF_STYLE_BOLD #粗体
• TTF_STYLE_ITALIC #斜体
• TTF_STYLE_UNDERLINE #下划线
• TTF_STYLE_STRIKETHROUGH #删除线（即中划线）

如果Style设为 TTF_STYLE_NORMAL, 效果将变成缺省效果。

显示中文代码：直接采用数字编码。

Uint16 msg[1024] = {0x4F60,0x597D,0}; //=Unicode 编码:你好

message = TTF_RenderUNICODE_Solid( font, msg, textColor );

5.示例

#include <stdio.h>
#include <SDL.h>
#include <SDL_ttf.h>

#define WINDOW_W 800
#define WINDOW_H 640

#undef main
int main(int argc,char* argv[])
{
	/*SDL初始化*/
	SDL_Init(SDL_INIT_VIDEO);
	/*TTF初始化*/
	TTF_Init();
	/*创建窗口*/
	SDL_Window *window = SDL_CreateWindow("SDL SHOW TEXT", SDL_WINDOWPOS_CENTERED, SDL_WINDOWPOS_CENTERED, WINDOW_W, WINDOW_H, SDL_WINDOW_SHOWN);
	/*创建渲染器*/
	SDL_Renderer *render = SDL_CreateRenderer(window, -1, SDL_RENDERER_ACCELERATED);
	/*设置渲染器颜色*/
	SDL_SetRenderDrawColor(render, 255, 255, 255, 255);
	/*清空渲染器*/
	SDL_RenderClear(render);
	/*打开字库*/
	TTF_Font *ttffont = TTF_OpenFont("GBK.ttf", 50);
	if (ttffont == NULL)
	{
		printf("simkai.ttf open failed\n");
		return 0;
	}

	/*字体颜色RGBA*/
	SDL_Color color = { 52,203,120,255 };
	SDL_Color bgColor = { 33,33,33,255 };

	/*设置字体大小*/
	TTF_SetFontSize(ttffont, 60);
	/*字体加粗*/
	TTF_SetFontStyle(ttffont, TTF_STYLE_NORMAL);
	/*创建字体显示表面*/
	SDL_Surface *text1_surface = TTF_RenderUTF8_Blended(ttffont, "Hello,SDL!", color);
	/*创建纹理*/
	SDL_Texture * texture = SDL_CreateTextureFromSurface(render, text1_surface);
	/*将surface拷贝到渲染器*/
	SDL_Rect dstrect;
	dstrect.x = WINDOW_W / 2 - text1_surface->w / 2;/*显示的起始位置*/
	dstrect.y = 100;/*显示的起始位置*/
	dstrect.w = text1_surface->w;/*显示的宽度*/
	dstrect.h = text1_surface->h;/*显示的高度*/

	/*创建字体显示表面*/
	//SDL_Surface *text1_surface = TTF_RenderUTF8_Blended(ttffont, "Hello,SDL!", color);
	Uint16 msg[10] = { 0x4F60,0x597D,',','T','T','F',0 }; //=Unicode 编码:你好
	SDL_Surface *text2_surface = TTF_RenderUNICODE_Solid(ttffont, msg, color);
	/*创建纹理*/
	SDL_Texture * texture2 = SDL_CreateTextureFromSurface(render, text2_surface);
	/*将surface拷贝到渲染器*/
	SDL_Rect dstrect2;
	dstrect2.x = WINDOW_W / 2 - text2_surface->w / 2;/*显示的起始位置*/
	dstrect2.y = 180;/*显示的起始位置*/
	dstrect2.w = text2_surface->w;/*显示的宽度*/
	dstrect2.h = text2_surface->h;/*显示的高度*/

	bool bQuit = false;
	SDL_Event windowEvent;
	while (!bQuit) {
		while (SDL_PollEvent(&windowEvent)) {
			switch (windowEvent.type) {
			case SDL_QUIT:
				bQuit = true;
				break;
			default:
				break;
			}
		}

		SDL_RenderClear(render);
		SDL_RenderCopy(render, texture, NULL, &dstrect);
		SDL_RenderCopy(render, texture2, NULL, &dstrect2);
		SDL_RenderPresent(render);
	}

	SDL_FreeSurface(text1_surface);/*释放surface*/
	SDL_DestroyTexture(texture);/*释放纹理*/
	TTF_CloseFont(ttffont);
	TTF_Quit();

	return 0;
}