SDL_Surface *TTF_RenderGlyph_Shaded(TTF_Font *font, Uint16 ch, SDL_Color fg, SDL_Color bg)
| font | レンダリングで使用するフォント |
| ch | レンダリングする文字 |
| fg | テキストの前景色 |
| bg | テキストの背景色 |
この関数は新たに8ビットパレットサーフェイスを生成する. サーフェイスの0ピクセルは背景色で, それ以外のピクセルは様々な明るさの前景色を表している. この関数の戻り値は生成されたサーフェイス, またはエラーが発生した場合はNULLである.
グリフはX軸方向にはパッディングやセンタリングは行われず, Y方向には通常の配置でレンダリングされる.
このバージョンの関数は16ビット文字コードを引数とするため, 基本多言語面には対応しているが, 絵文字などの全てのユニコードを扱うには不十分である. 代わりに機能は同じだが32ビットコードポイントに対応したTTF_RenderGlyph32_Shaded()を使うべきだ.
この関数を使う唯一の理由は, 最初のバージョンから存在しているから, ということのみである.
TTF_RenderGlyph_Solid, TTF_RenderGlyph_Blended, TTF_RenderGlyph_Shadedを使うと別の画質でレンダリングできる.