Draw Text

SDL에서 TTF 폰트를 이용하여 한글을 출력해보자.
SDL에서 폰트를 출력하기 위해서는 SDL_ttf가 필요하다.




다운로드:

다음의 링크에서 다운을 받는다.
https://www.libsdl.org/projects/SDL_ttf/
VC를 사용하므로 SDL2_ttf-devel-2.0.15-VC.zip 파일을 다운로드 받는다.

다른 SDL과 같은 폴더 위치에 압축은 푼다.
SDL2_ttf-2.0.15 폴더가 폰트 폴더이다.



헤더파일과 라이브러리 설정

헤더파일
#include "../SDL2_ttf-2.0.15/include/SDL_ttf.h"

라이브러리
#pragma comment(lib, "../SDL2_ttf-2.0.15/lib/x86/SDL2_ttf.lib")

3개의 DLL을 실행 폴더에 복사한다.
libfreetype-6.dll
SDL2_ttf.dll
zlib1.dll

초기화,  종료


SDL_Init 함수 실행후에 TTF_Init 함수로 라이브러리를 초기화 한다.
//SDL_Init
TTF_Init();

SDL_Quit 함수 호출전에 TTF_Quit 함수로 라이브러리를 종료한다.
TTF_Quit();
//SDL_Quit

렌더러를 생성후에 폰트를 메모리로 로딩한다.
폰트는 실행파일과 같은 위치에 둔다.
비주얼 스튜디오에서 직접 실행 할때는 프로젝트 파일이 있는 곳에 폰트가 있어야 한다.
//SDL_CreateRenderer
TTF_Font* font = TTF_OpenFont("godoMaum.ttf", 60);

폰트 사용이 끝나면 SDL_DestroyRenderer 함수전에 TTF_CloseFont를 실행하여 폰트를 정리한다.
TTF_CloseFont(font);
//SDL_DestroyRenderer

문자열 텍스쳐 생성

TTF_RenderText_Solid 함수로 SDL_Surface 구하여 문자열을 렌더링 한다.
SDL_Surface* textSurface = TTF_RenderText_Solid( font, szText, foreground );

SDL_CreateTextureFromSurface 함수로 SDL_Surface를 SDL_Texture로 만든다.
gTexture = SDL_CreateTextureFromSurface( renderer, textSurface );

SDL_Texture를 생성하면  서피스는 삭제한다.
SDL_FreeSurface( textSurface );

Text_Free 함수는 텍스쳐를 제거 해주는 함수로 뒤에 설명한다.
문자열이 바뀌면 Text_Create를 다시 실행 한다.
bool Text_Create(char* szText, SDL_Renderer* renderer, TTF_Font* font)
{
    Text_Free();
     
    SDL_Color foreground = { 255, 0, 0 };
    SDL_Surface* textSurface = TTF_RenderText_Solid( font, szText, foreground );
    if( textSurface == NULL )
    {
        printf( "Unable to render text surface! SDL_ttf Error: %s\n", TTF_GetError() );
    }
    else
    {
        gTexture = SDL_CreateTextureFromSurface( renderer, textSurface );
        if( gTexture == NULL )
        {
            printf( "Unable to create texture from rendered text! SDL Error: %s\n", SDL_GetError() );
        }
        else
        {
            gTextWidth = textSurface->w;
            gTextHeight = textSurface->h;
        }
        SDL_FreeSurface( textSurface );
    }
   
    return gTexture != NULL;
}

렌더링

렌더링 루프에서 SDL_RenderCopy 함수로 텍스쳐를 그린다.
SDL_QueryTexture 함수로 텍스쳐 폭과 높이를 구할수 있다.
void Text_Render( SDL_Renderer* renderer )
{
    SDL_Rect dest;
    dest.x = 0;
    dest.y = 0;
    //dest.w = gTextWidth;
    //dest.h = gTextHeight;
    SDL_QueryTexture(gTexture, NULL, NULL, &dest.w, &dest.h);

    SDL_RenderCopy( renderer, gTexture, NULL, &dest);
}

텍스쳐 제거

SDL_DestroyTexture 함수로 텍스쳐를 제거한다.

void Text_Free()
{
    if( gTexture != NULL )
    {
        SDL_DestroyTexture( gTexture );
        gTexture = NULL;
        gTextWidth = 0;
        gTextHeight = 0;
    }
}

또 다른 방법

효율은 떨어지지만 매 프레임 텍스쳐를 생성 --> 텍스쳐 렌더링 --> 텍스쳐를 소멸하는 방법이 있다.
void DrawText(wchar_t* text, SDL_Renderer* renderer, TTF_Font* font, int x, int y, bool blend)
{
    SDL_Color foreground = { 255, 0, 0 };
    SDL_Surface* textSurface = NULL;
    if(blend)
        textSurface = TTF_RenderUNICODE_Blended( font, (Uint16*)text, foreground);
    else
        textSurface = TTF_RenderUNICODE_Solid( font, (Uint16*)text, foreground);
   
   
    if( textSurface == NULL )
    {
        printf( "Unable to render text surface! SDL_ttf Error: %s\n", TTF_GetError() );
    }
    else
    {
        SDL_Texture* texture = SDL_CreateTextureFromSurface( renderer, textSurface );
        if( texture == NULL )
        {
            printf( "Unable to create texture! SDL Error: %s\n", SDL_GetError() );
        }
        else
        {
            SDL_Rect dest;
            dest.x = x;
            dest.y = y;
            dest.w = textSurface->w;
            dest.h = textSurface->h;
            SDL_RenderCopy(renderer, texture, NULL, &dest);
        }


        SDL_DestroyTexture(texture);
        SDL_FreeSurface( textSurface );
    }

한글 출력 및 블렌딩

문자열을 서피스에 그려주는 함수는 여러가지가 있지만 4가지만 설명 한다.

TTF_RenderText_Solid
TTF_RenderText_Blended

TTF_RenderUNICODE_Solid
TTF_RenderUNICODE_Blended

Solid 대신 Blended를 사용하면 렌더링 퀄리티가 좋아진다. 블렌딩이 되기 때문에 계단 현상이 줄어든다.
한글을 사용하기 위해서는 UNICODE가 붙어 있는 함수를 사용한다.

윈도우즈에서는 wchar_t 타입으로 문자열을 넘겨주면 한글을 출력 할수 있다.

wchar_t* text = L"안녕하세요. 한글";
textSurface = TTF_RenderUNICODE_Blended( font, (Uint16*)text, foreground);

프로젝트 다운로드 : sdl_font_project.zip

참조)
저작권 걱정없는 무료 한글폰트
https://brunch.co.kr/@jade/203

튜토리얼
http://gigi.nullneuron.net/gigilabs/displaying-text-in-sdl2-with-sdl_ttf/
https://lazyfoo.net/tutorials/SDL/16_true_type_fonts/index.php

실시간으로 문자열 렌더링
https://thenumbat.github.io/cpp-course/sdl2/07/07.html

한글출력
https://m.blog.naver.com/samgib/50130337930
https://m.blog.naver.com/pjc0247/80149820083

추가 설명) 화면 위치 보간:

화면의 좌표를 다른 좌표로 바꾸기 위해 보간 함수를 만들었다.

float lerp(float in, float a1, float b1, float a2, float b2)
{
    float v = (in - a1)/(b1 - a1);
    float ret = a2 + v*(b2 - a2);
    return ret;
}

화면  아래를 0, 위를 1000으로 사용한다.
y = lerp(0,  0, 1000, 768.f, 0.f);