Star Ruby Ruby extension library for creating 2D games

フォントを表すクラスです。 immutable です。

Texture に文字を描画する際、この Font クラスのインスタンスを指定します。

TTF ファイルおよび TTC ファイルが扱えます。

メソッドの引数として扱えるフォント名は以下の通りです。

• ファイル名、パス (拡張子省略可能)
• インストール済みのフォント名 (Windows)
• 「(フォント名)」または「(フォント名), (スタイル名)」 (Linux および Mac OS X)
  • 例1) FreeSans
  • 例2) FreeSans, Bold

フォント名の文字コードは UTF-8 です。

Linux および Mac OS X の場合は、スタイル名も同時に指定することを推奨します。

クラスメソッド

Font.new(path_or_name, size, options = {})

フォントファイルのパスまたはフォント名を指定して、新しい Font オブジェクトを生成します。

options は Hash です。指定できるキーと値は、以下の通りです。

キー	値	デフォルト値
:bold	ボールドかどうかを表す真偽値。	false
:italic	イタリックかどうかを表す真偽値。	false
:ttc_index	TTC ファイルのインデックス。	0

:ttc_index に関しては、path_or_name 引数で TTC ファイルのパスを指定した場合に有効です。

Ver 0.1.17 から、全く同じ条件で生成した Font オブジェクトは、同一になります (object_id が一致します)。

Font.exist?(path_or_name)

フォントファイルのパスまたはフォント名を指定して、そのフォントが存在するならば true、それ以外の場合は false を返します。

インスタンスメソッド

bold?

ボールドのときに true、それ以外の場合は false を返します。

get_size(text)

text を描画したときの大きさを表す配列 ([(Width), (Height)]) を返します。

italic?

イタリックのときに true、それ以外の場合は false を返します。

name

フォント名を取得します。

size

フォントの高さを取得します。