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

TTF_SizeUNICODE

int TTF_SizeUNICODE(TTF_Font *font, const Unit16 *text, int *w, int *h)

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

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

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

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

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

サンプルコード

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

参照

TTF_SizeText, TTF_SizeUTF8, TTF_RenderText_Solid, TTF_RenderText_Shaded, TTF_RenderText_Blended

原文へのリンク

3.3.22 TTF_SizeUNICODE