SDL_Surface * TTF_RenderText_Shaded(TTF_Font *font, const char *text, SDL_Color fg, SDL_Color bg)
| font | レンダリングで使用するフォント |
| text | レンダリングするLatin1テキスト |
| fg | テキストの前景色 |
| bg | テキストの背景色 |
この関数は新たに8ビットパレットサーフェイスを生成する. サーフェイスの0ピクセルは背景色で, それ以外のピクセルは様々な明るさの前景色を表している. この関数の戻り値は生成されたサーフェイス, またはエラーが発生した場合はNULLである.
この関数は改行しないため, どれだけ文字列が長くてもサーフェイスのテキストは1行である. 改行して複数行にする必要がある場合は, 代わりにTTF_RenderText_Shaded_Wrapped()を使うことができる.
この関数は改行コードで改行しない.
1バイトLatin1でエンコードされているのが確実でない限り, 本当に必要なのはTTF_RenderUTF8_Blendedだろう. US ASCII文字はどちらの関数でも正常に動作するが, 他の多くの文字はUTF-8としての処理が必要である.
TTF_RenderText_Solid, TTF_RenderText_Shaded, TTF_RenderText_LCDを使うと別の画質でレンダリングできる.