目次 - 3.関数 - 3.4レンダラー - TTF_RenderUNICODE_Blended

TTF_RenderUNICODE_Blended

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

font
テキストをレンダリングするフォント
text
レンダリングするNUL終端のUNICODE文字列
fg
レンダリングするテキストの色. ピクセルは透明色とこの色でブレンドされ, アンチエイリアスされたグリフが描かれる

UNICODEでエンコードされたtextを, fontと色fgで新しく生成したサーフェイスに混合(Blended)モードでレンダリングする. 呼び出し側(あなたのことだ!)が戻されたサーフェイスを解放しなければならない.

メモ: この関数のfontにNULLを渡すと異常終了する.

メモ: この関数のtextにNULLを渡した場合の動作は未定義である.

戻り値: 生成されたSDL_Surface. 失敗のときNULL

サンプルコード

// 黒色でUNICODEテキストを新しいサーフェイスにレンダリングする
// そしてそれを画面の左上にコピーする
// そしてテキストのサーフェイスを解放する
//SDL_Surface *screen;
SDL_Color color={0,0,0};
SDL_Surface *text_surface;
Uint16 text[]={'H','e','l','l','o',' ',
               'W','o','r','l','d','!'};
if(!(text_surface=TTF_RenderUNICODE_Blended(font,text,color))) {
    // ここでエラーを処理する. 少なくともTTF_GetErrorを表示したほうがよい
} else {
    SDL_BlitSurface(text_surface,NULL,screen,NULL);
    // これは再利用できる. しかしここでは単純化のためにそうしない
    SDL_FreeSurface(text_surface);
}

参照

TTF_SizeUNICODE, TTF_RenderText_Blended, TTF_RenderUTF8_Blended, TTF_RenderGlyph_Blended, TTF_RenderUNICODE_Solid, TTF_RenderUNICODE_Shaded

原文へのリンク

3.4.11 TTF_RenderUNICODE_Blended