SDL_Surface *TTF_RenderUNICODE_Blended_Wrapped(TTF_Font *font, const Uint16 *text, SDL_Color fg, Uint32 wrapLength)
font | レンダリングで使用するフォント |
text | レンダリングするUCS-2テキスト |
fg | テキストの前景色 |
wrapLength | 改行するピクセル数の長さ |
この関数は新たに32ビットARGBサーフェイスを生成し, 指定の前景色とαブレンドを用いてディザリングを行いレンダリングする. この関数の戻り値は生成されたサーフェイス, またはエラーが発生した場合はNULLである.
テキストはピクセル数がwrapLengthを超えるとき行末または語の区切りで改行される.
wrapLengthが0のとき, 改行コードの場合のみ改行する.
この関数の名前は"Unicode"となっているが, 現在の実際の入力はUCS-2(1コードポイント16ビット)である. 絵文字のようなそれよりも大きなUnicodeの値は渡せない. そのようなコードポイントはUTF-8版でアクセスできる.
TTF_RenderUNICODE_Solid_Wrapped, TTF_RenderUNICODE_Shaded_Wrapped, TTF_RenderUNICODE_LCD_Wrappedを使うと別の画質でレンダリングできる.