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

TTF_MeasureText

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

構文

int TTF_MeasureText(TTF_Font *font, const char *text, int measure_width, int *extent, int *count)

引数

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

戻り値

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

詳細

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

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

1バイトLatin1でエンコードされているのが確実でない限り, 本当に必要なのはTTF_MeasureUTF8()だろう. US ASCII文字はどちらの関数でも正常に動作するが, 他の多くの文字はUTF-8としての処理が必要である.

バージョン

SDL_ttf 2.0.18以降

関連項目(関数)

TTF_MeasureUTF8
TTF_MeasureUNICODE

SDL Wikiへのリンク

SDL2_ttf/TTF_MeasureText