目次 - SDL_ttf - API(機能別) - 属性 - TTF_MeasureUNICODE

TTF_MeasureUNICODE

与えられた幅に収まるUCS-2文字数を求める

構文

int TTF_MeasureUNICODE(TTF_Font *font, const Uint16 *text, int measure_width, int *extent, int *count)

引数

fontフォント
text求めるUCS-2テキスト
measure_width文字列の限界幅ピクセル数
extent文字列が収まる最小の幅ピクセル数
countレンダリング可能な文字数の代入先へのポインタ

戻り値

成功のとき0, エラーのとき-1を戻す.

詳細

measure_widthに達するまでレンダリングできる文字数を求める.

求めるために文字列をレンダリングする必要はない.

この関数の名前は"Unicode"となっているが, 現在の実際の入力はUCS-2(1コードポイント16ビット)である. 絵文字のようなそれよりも大きなUnicodeの値は渡せない. そのようなコードポイントはUTF-8版でアクセスできる.

バージョン

SDL_ttf 2.0.18以降

関連項目(関数)

TTF_MeasureText
TTF_MeasureUTF8

SDL Wikiへのリンク

SDL2_ttf/TTF_MeasureUNICODE