目次 - SDL_ttf - API(機能別) - レンダリング - TTF_RenderUTF8_Shaded

TTF_RenderUTF8_Shaded

UTF-8テキストを, 生成した8ビットサーフェイスに陰影(Shaded)モードでレンダリングする

構文

SDL_Surface *TTF_RenderUTF8_Shaded(TTF_Font *font, const char *text, SDL_Color fg, SDL_Color bg)

引数

fontレンダリングで使用するフォント
textレンダリングするUTF-8テキスト
fgテキストの前景色
bgテキストの背景色

戻り値

成功のとき生成された8ビットパレットサーフェイス, エラーのときNULLを戻す.

詳細

この関数は新たに8ビットパレットサーフェイスを生成する. サーフェイスの0ピクセルは背景色で, それ以外のピクセルは様々な明るさの前景色を表している. この関数の戻り値は生成されたサーフェイス, またはエラーが発生した場合はNULLである.

この関数は改行しないため, どれだけ文字列が長くてもサーフェイスのテキストは1行である. 改行して複数行にする必要がある場合は, 代わりにTTF_RenderUTF8_Shaded_Wrapped()を使うことができる.

この関数は改行コードで改行しない.

TTF_RenderUTF8_Solid, TTF_RenderUTF8_Blended, TTF_RenderUTF8_LCDを使うと別の画質でレンダリングできる.

バージョン

SDL_ttf 2.0.12以降

関連項目(関数)

TTF_RenderUNICODE_Shaded

SDL Wikiへのリンク

SDL2_ttf/TTF_RenderUTF8_Shaded