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

TTF_RenderGlyph_Blended

SDL_Surface *TTF_RenderGlyph_Blended(TTF_Font *font, Uint16 ch, SDL_Color fg)

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

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

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

戻り値: 生成されたSDL_Surface. グリフがフォントにないなど失敗のときNULL

サンプルコード

// 黒色で表示できる全てのASCII文字をレンダリングし格納する
//SDL_Surface *screen;
SDL_Color color={0,0,0};
SDL_Surface *glyph_cache[128-20];
Uint16 ch;
for(ch=20; ch<128; ++ch)
    glyph_cache[ch-20]=TTF_RenderGlyph_Blended(font,ch,color);
あらかじめグリフメトリック(minx, miny, advance)で変換して格納すると, 直接画面にレンダリングするより速い. しかし, カーニングは正確には行われない.

参照

TTF_RenderGlyph_Solid, TTF_RenderGlyph_Shaded, TTF_RenderText_Blended, TTF_RenderUTF8_Blended, TTF_GlyphMetrics

原文へのリンク

3.4.12 TTF_RenderGlyph_Blended