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

TTF_SetFontHinting

void TTF_SetFontHinting(TTF_Font *font, int hinting)

font
ヒンティングを得るフォント
hinting
設定するヒンティング:
TTF_HINTING_NORMAL
TTF_HINTING_LIGHT
TTF_HINTING_MONO
TTF_HINTING_NONE
ヒンティングを設定しないときはTTF_HINTING_NORMAL

fontのヒンティング(最適化のヒント)を設定する. 使うフォントがわかっている, 特に小さなフォントの場合は, この設定はあらかじめ確かめておくべきである. ユーザがフォントを選択する場合は, フォントと同様にヒンティングも選択できるようにしたほうがよい.

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

メモ: この関数を呼ぶと, ヒンティングが変わらない場合でも, 以前のレンダリングされたグリフの内部キャッシュが消去される. まずTTF_GetFontHintingを呼んで現在のヒンティングをチェックしたほうがよい.

サンプルコード

// 読み込んだフォントにモノクロレンダリングで最適化するヒンティングを設定する
//TTF_Font *font;
TTF_SetFontHinting(font, TTF_HINTING_MONO);

// ここでモノクロでテキストをレンダリングする...

// 読み込んだフォントのヒンティングを通常に戻す
TTF_SetFontHinting(font, TTF_HINTING_NORMAL);

参照

TTF_GetFontHinting, 5.マクロ, 6.用語, Font Hinting @ Wikipedia, FreeType Hinting and Bitmap rendering, FreeType Hinting Modes

原文へのリンク

3.3.7 TTF_SetFontHinting