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

TTF_SizeText

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

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

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

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

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

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

サンプルコード

// 読み込まれたフォントでテキストをレンダリングした場合の幅と高さを得る
//TTF_Font *font;
int w,h;
if(TTF_SizeText(font,"Hello World!",&w,&h)) {
    // レンダリングできなかった. 少なくともTTF_GetErrorを表示したほうがよい
} else {
    printf("幅=%d 高さ=%d¥n",w,h);
}

参照

TTF_SizeUTF8, TTF_SizeUNICODE, TTF_RenderText_Solid, TTF_RenderText_Shaded, TTF_RenderText_Blended

原文へのリンク

3.3.20 TTF_SizeText