目次 - 3.関数 - 3.3属性 - TTF_SizeUTF8

TTF_SizeUTF8

int TTF_SizeUTF8(TTF_Font *font, const char *text, int *w, int *h)

font
文字列のサイズを求めるfont
text
サイズを求めるUTF-8のNUL終端の文字列
w
文字列の幅を代入するポインタ. 不要の場合NULL
h
文字列の高さを代入するポインタ. 不要の場合NULL

fontを使ってUTF-8でエンコードされたtextのサーフェイス上のサイズを求める. 実際にはレンダリングされないが, 正しくカーニングされ, 実際の幅が得られる. 高さはTTF_FontHeightと同じ値になる.

メモ: この関数のfontにNULLを渡すと異常終了する.

メモ: この関数のtextにNULLを渡した場合の動作は未定義である.

戻り値: 成功のとき0で, NULLでないwとhに適切な値が代入される. フォントにグリフがないなど失敗のとき-1

サンプルコード

ASCIIはUTF8と互換性があるので, このサンプルではLATIN1と同じテキストを使っている.
// 読み込まれたフォントでテキストをレンダリングした場合の幅と高さを得る
//TTF_Font *font;
int w,h;
if(TTF_SizeUTF8(font,"Hello World!",&w,&h)) {
    // レンダリングできなかった. 少なくともTTF_GetErrorを表示したほうがよい
} else {
    printf("幅=%d 高さ=%d¥n",w,h);
}

参照

TTF_SizeText, TTF_SizeUNICODE, TTF_RenderText_Solid, TTF_RenderText_Shaded, TTF_RenderText_Blended

原文へのリンク

3.3.21 TTF_SizeUTF8