CreateFontToHandle

新しいフォントデータを作成

val = CreateFontToHandle(FontName, Size, Thick)

char *FontName : 作成するフォント名( NULL にするとデフォルトのフォント )
int Size : フォントのサイズ( およそドット数  -1:デフォルトのサイズ )
int Thick : フォントの太さ( 0 ～　9         -1:デフォルトの太さ  )
int FontType : フォントのタイプ
(　-1　　　　　　　　　　　　　　　　　　　: デフォルトフォント(DX_FONTTYPE_NORMAL と同じ)
DX_FONTTYPE_NORMAL　　　　　　: ノーマルフォント
DX_FONTTYPE_EDGE　　　　　　　　: エッジつきフォント
DX_FONTTYPE_ANTIALIASING　　　　: アンチエイリアスフォント
DX_FONTTYPE_ANTIALIASING_4X4　　　: アンチエイリアスフォント( 4x4サンプリング )
DX_FONTTYPE_ANTIALIASING_8X8　　　: アンチエイリアスフォント( 8x8サンプリング )
DX_FONTTYPE_ANTIALIASING_EDGE_4X4　: アンチエイリアス＆エッジ付きフォント( 4x4サンプリング )
DX_FONTTYPE_ANTIALIASING_EDGE_8X8　: アンチエイリアス＆エッジ付きフォント( 8x8サンプリング ) )

(プラグイン / モジュール : DxLibW)

解説

普段 DrawString 関数や DrawFormatString 関数で
文字列を描画していて、ふと一回の画面の更新で複数のタイプの
フォントを使いたくなったりしたとします。

当然描きたいフォントのサイズや太さに応じてその都度
SetFontSize 関数や SetFontThickness 関数を使用する
しかないのですが、実はフォントのサイズや太さを変えるのは非常に
時間がかかり、高速処理を行わなければならないゲームソフトでは
致命的な負荷となります。

そこで解決方法として、元々ある標準のフォントデータを場合に
応じてサイズや太さを変えるのではなく、標準のフォントデータとは
全く別に、必要な分だけフォントデータを作成しておき、文字列
描画時にあらかじめ用意されたフォントデータを使って描画処理を
行うというものがあります。

この関数は上記の方法を実現するための一つ目である『標準で
使用するフォントデータ以外のフォントデータを作る』ための機能を
持っています。

具体的に説明しますと、まずこの CreateFontToHandle 関数で作成
されたフォントのデータはひとつの識別番号を付けられます。
この CreateFontToHandle 関数は戻り値としてこの int 型の識別
番号値を返してきますので、この値を何らかの変数に保存します。

そしてあとは今まで紹介された DrawString 関数 ,
GetDrawStringWidth 関数 などと使い方はほとんど同じで、
違いは各関数名の語尾には 『ToHandle』が付き、関数の引数の
最後にどのフォントのデータを使うのか、を示す保存しておいた
識別番号を渡す必要があるということだけです。

ただしこのフォントデータ機能には、SetFontSize 関数や SetFontThickness 関数
のような、途中でサイズや太さの変更をすることは出来ません。ので、違う
タイプのフォントを使用したい場合は再度この CreateFontToHandle 関数
でフォントデータを作成する必要があります。

CreateFontToHandle 関数は FontName に作成するフォントの
名前の文字列を、Size に作成するフォントのサイズを、Thick に
作成するフォントの線の太さを渡すことで任意のフォントデータを
作成してくれます。

なお、FontName に NULL を指定するとデフォルトのフォントが
使用され、Size 及び Thick も -1 を指定することによりそれぞれ
標準のサイズ、太さのフォントが作成されます。

FontType は作成するフォントのタイプを指定します。

種類が沢山あり、説明が少々長くなるので詳細はChangeFontType 関数
の解説を参照してください。

※ DxLib のフォントハンドルは 32bit/64bit 共に int 型です。

戻り値:
  戻り値    -1 : 失敗
  0以上 : フォントハンドル

関連項目

情報