Cairo::ScaledFontクラス

好みのサイズと装置解像度に拡大・縮小したフォントです。 Cairo::ScaledFontは低レベルのフォント使用でもっとも役に立ちま す。例えば、メトリックスの計算を高速化するために拡大・縮小し たフォントをキャッシュしたいライブラリやアプリケーションには 役に立ちます。

Cairo::ScaledFontにはフォントバックエンドに依存したいくつか の種類があります。ただし、rcairoではサポートしていません。

オブジェクト階層

クラスメソッド

Cairo::ScaledFont.new(font_face, font_matrix, ctm, options)
フォントフェイスと、フォントサイズと使用環境を表現する 行列からCairo::ScaledFontオブジェクトを生成します。

インタンスメソッド

ctm
selfを生成するときに指定したCTM（現在の変換行列） を返します。
extents
メトリックスを返します。
font_face
selfを生成するときに指定したフォントフェイスを返 します。
font_matrix
selfを生成するときに指定したフォント行列を返しま す。
font_options
selfを生成するときに指定したフォントオプションを返 します。
glyph_extents(glyphs)

グリフの範囲を返します。範囲はグリフをインクで塗る部分 を囲む（ユーザ空間での）四角を示しています。（グリフは Cairo::Context#show_glyphsで描画できます。）さらに、 範囲（Cairo::TextExtents）のx_advanceと y_advanceの値はCairo::Context#show_glyphsが進める 現在の点の合計を示しています。 （Cairo::Context#show_glyphsはグリフを描画すると、描画 した分だけ現在の点を進めます。）

空白のグリフは四角のサイズ（extents.widthと extents.height）に貢献しないことに注意してください。

text_extents(utf8)

テキストの範囲を返します。範囲はテキストをインクで塗る 部分（テキストが描画される部分）を囲む（ユーザ空間での） 示しています。さらに、範囲（Cairo::TextExtents）の x_advanceとy_advanceの値は Cairo::Context#show_glyphsが進める現在の点の合計を示し ています。（Cairo::Context#show_textはテキストを描画す ると、描画した分だけ現在の点を進めます。）

空白文字は四角のサイズ（extents.widthとextents.height） に貢献しないことに注意してください。空白文字は非空白文 字の位置を変更することにより間接的に貢献しています。特 に、テキストの最後の空白文字は四角のサイズには影響を与 えませんが、x_advanceとy_advanceの値には影 響を与えます。

scale_matrix
Since 1.7: 拡大・縮小用の行列を返します。拡大・縮 小用行列は、このCairo::ScaledFontのフォント行列と現在の 変換行列（CTM）の積です。つまり、フォント空間から装置空 間へ変換する（写像する・mapする）行列です。
text_to_glyphs(x, y, utf8)

Since 1.7: UTF-8のテキストをグリフの配列とクラス タ対応に変換します。これらは後でこのCairo::ScaledFontを 使って描画するときに使うことができます。

どのようにクラスタ対応情報が入力のUTF-8のテキストと出力 のグリフを対応付けるかの詳細については Cairo::Context#show_text_glyphsを見てください。

同じCairo::ScaledFontを使う場合は、戻り値はそのまま Cairo::Context#show_text_glyphsや Cairo::Context#show_glyphsなど関連するメソッドで使うこ とができます。

参考

変更履歴