FineKernelToolKit  3.1.0
公開メンバ関数 | プロパティ | 全メンバ一覧
FK_CLI::fk_TextImage クラス

文字列板を管理するクラス [詳解]

+ FK_CLI::fk_TextImage の継承関係図
+ FK_CLI::fk_TextImage 連携図

公開メンバ関数

 fk_TextImage ()
 コンストラクタ [詳解]
 
 ~fk_TextImage ()
 デストラクタ [詳解]
 
 !fk_TextImage ()
 ファイナライザ [詳解]
 
フォント関連メソッド
bool InitFont (String^ fontFileName)
 フォント情報入力メソッド [詳解]
 
文字配置事前設定関連メソッド
void SetOffset (int up, int down, int left, int right)
 オフセット設定メソッド [詳解]
 
int GetUpOffset (void)
 オフセット上幅参照メソッド [詳解]
 
int GetDownOffset (void)
 オフセット下幅参照メソッド [詳解]
 
int GetLeftOffset (void)
 オフセット左幅参照メソッド [詳解]
 
int GetRightOffset (void)
 オフセット右幅参照メソッド [詳解]
 
文字列入力メソッド
bool LoadUniStr (fk_UniStr^ str)
 文字列データ入力メソッド [詳解]
 
bool LoadStrFile (String^ fileName, fk_StringCode code)
 文字列データファイル入力メソッド1 [詳解]
 
bool LoadStrFile (String^ fileName)
 文字列データファイル入力メソッド2 [詳解]
 
int GetLineCharNum (int num)
 行中文字数参照メソッド [詳解]
 
int GetLineWidth (int num)
 行横幅参照メソッド [詳解]
 
int GetLineHeight (int num)
 行縦幅参照メソッド [詳解]
 
int GetLineStartXPos (int num)
 行開始位置 x 成分取得メソッド [詳解]
 
int GetLineStartYPos (int num)
 行開始位置 y 成分取得メソッド [詳解]
 
文字送り関連メソッド
bool Send (void)
 文字送り実行メソッド [詳解]
 
bool Finish (void)
 文字送り完了メソッド [詳解]
 
bool Clear (void)
 文字送り初期化メソッド [詳解]
 
- 基底クラス FK_CLI::fk_Image に属する継承公開メンバ関数
 fk_Image ()
 コンストラクタ1 [詳解]
 
 fk_Image (int W, int H)
 コンストラクタ [詳解]
 
 ~fk_Image ()
 デストラクタ [詳解]
 
 !fk_Image ()
 ファイナライザ [詳解]
 
void Init (void)
 初期化メソッド [詳解]
 
void NewImage (int w, int h, bool initFlg)
 画像領域生成メソッド1 [詳解]
 
void NewImage (int w, int h)
 画像領域生成メソッド2 [詳解]
 
void CopyImage (fk_Image^ image)
 画像データコピーメソッド1 [詳解]
 
void CopyImage (fk_Image^ image, int x, int y)
 画像データコピーメソッド2 [詳解]
 
bool SubImage (fk_Image^ image, int x, int y, int w, int h)
 画像データ部分抽出メソッド [詳解]
 
int GetR (int x, int y)
 ピクセルR要素取得メソッド [詳解]
 
int GetG (int x, int y)
 ピクセルG要素取得メソッド [詳解]
 
int GetB (int x, int y)
 ピクセルB要素取得メソッド [詳解]
 
int GetA (int x, int y)
 ピクセルA要素取得メソッド [詳解]
 
bool SetRGBA (int x, int y, int r, int g, int b, int a)
 ピクセル RGBA 値設定メソッド [詳解]
 
bool SetRGB (int x, int y, int r, int g, int b)
 ピクセル RGB 値設定メソッド [詳解]
 
bool SetR (int x, int y, int r)
 ピクセル R 値設定メソッド [詳解]
 
bool SetG (int x, int y, int g)
 ピクセル G 値設定メソッド [詳解]
 
bool SetB (int x, int y, int b)
 ピクセル B 値設定メソッド [詳解]
 
bool SetA (int x, int y, int a)
 ピクセル A 値設定メソッド [詳解]
 
void FillColor (fk_Color^ color)
 バッファ全体初期化メソッド1 [詳解]
 
void FillColor (int r, int g, int b, int a)
 バッファ全体初期化メソッド2 [詳解]
 
void FillColor (int r, int g, int b)
 バッファ全体初期化メソッド3 [詳解]
 
bool ReadBMP (String^ fileName)
 BMP ファイル入力メソッド [詳解]
 
bool ReadPNG (String^ fileName)
 PNG ファイル入力メソッド [詳解]
 
bool ReadJPG (String^ fileName)
 JPEG ファイル入力メソッド [詳解]
 
bool WriteBMP (String^ fileName, bool transFlg)
 BMP ファイル出力メソッド1. [詳解]
 
bool WriteBMP (String^ fileName)
 BMP ファイル出力メソッド2. [詳解]
 
bool WritePNG (String^ fileName, bool transFlg)
 PNG ファイル出力メソッド1. [詳解]
 
bool WritePNG (String^ fileName)
 PNG ファイル出力メソッド2. [詳解]
 
bool WriteJPG (String^ fileName, int quality)
 JPEG ファイル出力メソッド1. [詳解]
 
bool WriteJPG (String^ fileName)
 JPEG ファイル出力メソッド2. [詳解]
 

静的公開メンバ関数

キャッシュ関連メソッド
static void ClearCache (void)
 キャッシュ初期化メソッド [詳解]
 

プロパティ

int DPI [get, set]
 フォント解像度プロパティ [詳解]
 
int PTSize [get, set]
 フォントサイズプロパティ [詳解]
 
int BoldStrength [get, set]
 太さ値プロパティ [詳解]
 
bool ShadowMode [get, set]
 影付け効果プロパティ [詳解]
 
fk_Dimension^  ShadowOffset [get, set]
 影付けずらし幅プロパティ [詳解]
 
fk_Color^  ShadowColor [get, set]
 影付け色プロパティ [詳解]
 
fk_Color^  ForeColor [get, set]
 文字色プロパティ [詳解]
 
fk_Color^  BackColor [get, set]
 背景色プロパティ [詳解]
 
bool SmoothMode [get, set]
 アンチエイリアシング効果プロパティ [詳解]
 
bool MonospaceMode [get, set]
 等幅表示プロパティ [詳解]
 
int MonospaceSize [get, set]
 等幅表示文字幅プロパティ [詳解]
 
int CharSkip [get, set]
 文字間幅プロパティ [詳解]
 
int LineSkip [get, set]
 行間幅プロパティ [詳解]
 
int SpaceLineSkip [get, set]
 空行縦幅プロパティ [詳解]
 
fk_TextAlign Align [get, set]
 文字列寄せ方向(アライメント)プロパティ [詳解]
 
int MinLineWidth [get, set]
 画像最小横幅プロパティ [詳解]
 
int LineNum [get]
 行数プロパティ [詳解]
 
int AllCharNum [get]
 文字数プロパティ [詳解]
 
int MaxLineWidth [get]
 最大横幅プロパティ [詳解]
 
int MaxLineHeight [get]
 最大縦幅プロパティ [詳解]
 
fk_TextSendingMode SendingMode [get, set]
 文字送りモードプロパティ [詳解]
 
static bool CacheMode [get, set]
 キャッシュ機能制御プロパティ [詳解]
 
- 基底クラス FK_CLI::fk_Image に属する継承プロパティ
fk_Color^  default[int, int] [get, set]
 画素プロパティ [詳解]
 
fk_Dimension^  Size [get]
 画像サイズプロパティ [詳解]
 
fk_Dimension^  BufferSize [get]
 画像バッファサイズプロパティ [詳解]
 

詳解

文字列板を管理するクラス

このクラスは、文字列板を制御する機能を提供します。

本クラスは fk_Image の派生クラスであり、本質的には画像を意味します。 通常の画像に対し、文字列を表示することに特化したクラスです。 このクラスを用いて作成した文字列を矩形テクスチャとすることで、 シーン上にメッセージを表示することができます。 実質的には通常の矩形テクスチャとなりますので、 単純に画面に文字を表示するだけではなく、 3次元空間中に自由に配置することができます。

文字列画像生成に際しては、複数行を一枚の画像中に表示することができます。 その際、左寄り、中寄り、右寄りといったアライメントや、 画像端からのマージンなども細かく設定することができます。

また、本クラスの特徴的な機能として「文字送り」があります。 これは、初期状態として全ての文字が表示されていない状態にしておき、 一文字ずつ、あるいは一行ずつ順番に表示していくという機能です。

本クラスを用いる場合、以下の順番で処理を進める必要があります。

  1. フォント情報の入力 (InitFont())
  2. 描画色、配置などの各種設定
  3. 文字列の入力

これは、実際の画像生成を文字列データ入力の段階で行うため、 それ以外の設定を事前にしておかなければならないためです。 詳細はユーザーズマニュアルの「文字列板」の項目を参照して下さい。

なお、文字列板はその性質上、常に画面上で最前面に表示しておきたい場合が多くあります。 これは、シーン登録においてオーバーレイモデルとして登録することで容易に実現できます。 詳細は fk_DisplayLink::EntryOverlayModel() の解説を参照して下さい。

参照
fk_Image, fk_UniStr, fk_RectTexture, fk_Scene, fk_SpriteModel

構築子と解体子

FK_CLI::fk_TextImage::fk_TextImage ( )

コンストラクタ

FK_CLI::fk_TextImage::~fk_TextImage ( )

デストラクタ

FK_CLI::fk_TextImage::!fk_TextImage ( )

ファイナライザ

関数詳解

bool FK_CLI::fk_TextImage::InitFont ( String^  fontFileName)

フォント情報入力メソッド

フォントの入力を行います。 ここで指定するものは TrueType 形式のフォントファイルとなります。 通常は「ttf」あるいは「ttc」という拡張子のファイルとなっています。

なお、このメソッドは LoadUniStr()LoadStrFile() などの文字列入力よりも先に行っておく必要があります。

引数
[in]fontFileNameフォントファイル名
戻り値
フォントの設定に成功すれば true を、失敗すれば false を返します。
注意
各種 OS に付属しているフォントファイルや、 商用のフォントファイルの中には、 ライセンス上再配布が禁止されているものがあります。 プログラムの配布時には必ずライセンスの確認を行ってください。
void FK_CLI::fk_TextImage::SetOffset ( int  up,
int  down,
int  left,
int  right 
)

オフセット設定メソッド

文字が実際に表示されている部分と、画面の縁までの幅を設定します。 単位はピクセルとなります。 デフォルトでは、全て 0 に設定されています。

文字との対比については、解像度やフォントサイズに応じて変わってきます。 つまり、解像度やフォントサイズが大きい場合、 空白を作るには大きな値が必要となります。 従って、解像度やフォントサイズを変更した場合には、 この値も再度調整する必要があります。

引数
[in]up上幅
[in]down下幅
[in]left左幅
[in]right右幅
参照
CharSkip, LineSkip, SpaceLineSkip, DPI, PTSize
int FK_CLI::fk_TextImage::GetUpOffset ( void  )

オフセット上幅参照メソッド

文字が実際に表示されている部分のうち、上側の縁までの幅を取得します。 単位はピクセルとなります。

戻り値
上幅
参照
SetOffset()
int FK_CLI::fk_TextImage::GetDownOffset ( void  )

オフセット下幅参照メソッド

文字が実際に表示されている部分のうち、下側の縁までの幅を取得します。 単位はピクセルとなります。

戻り値
下幅
参照
SetOffset()
int FK_CLI::fk_TextImage::GetLeftOffset ( void  )

オフセット左幅参照メソッド

文字が実際に表示されている部分のうち、左側の縁までの幅を取得します。 単位はピクセルとなります。

戻り値
左幅
参照
SetOffset()
int FK_CLI::fk_TextImage::GetRightOffset ( void  )

オフセット右幅参照メソッド

文字が実際に表示されている部分のうち、右側の縁までの幅を取得します。 単位はピクセルとなります。

戻り値
右幅
参照
SetOffset()
bool FK_CLI::fk_TextImage::LoadUniStr ( fk_UniStr str)

文字列データ入力メソッド

fk_UniStr 型のインスタンスに格納されている文字列を入力します。

文字列板画像は、 このメソッドかまたは LoadStrFile() が呼ばれた時点で生成されます。 従って、色や配置などの設定は本メソッドを呼ぶ前に行わなければなりません。

既に本メソッドを実行したインスタンスに対し、改めて本メソッドを実行することは可能です。 その場合は、新たな文字列と設定に基づき、文字列板画像を再構築します。

引数
[in]str文字列が格納されているインスタンス
戻り値
文字列板生成に成功すれば true を、失敗すれば false を返します。
参照
LoadStrFile()
bool FK_CLI::fk_TextImage::LoadStrFile ( String^  fileName,
fk_StringCode  code 
)

文字列データファイル入力メソッド1

テキストファイルに入っている文字列を入力します。

文字列板画像は、 このメソッドかまたは LoadUniStr() が呼ばれた時点で生成されます。 従って、色や配置などの設定は本メソッドを呼ぶ前に行わなければなりません。

既に本メソッドを実行したインスタンスに対し、改めて本メソッドを実行することは可能です。 その場合は、新たな文字列と設定に基づき、文字列板画像を再構築します。

引数
[in]fileNameファイル名
[in]code入力する文字列の想定日本語コード。 サポートしているのは JISコード、SJISコード、EUC、UTF-16 です。 具体的な指定値は fk_StringCode のリストを参照して下さい。
戻り値
文字列板生成に成功すれば true を、失敗すれば false を返します。
bool FK_CLI::fk_TextImage::LoadStrFile ( String^  fileName)

文字列データファイル入力メソッド2

テキストファイルに入っている文字列を入力します。 なお、文字コードは UTF-16 であることを前提としています。 その他の文字コードで入力したい場合は LoadStrFile(String^, fk_StringCode) を利用して下さい。

文字列板画像は、 このメソッドかまたは LoadUniStr() が呼ばれた時点で生成されます。 従って、色や配置などの設定は本メソッドを呼ぶ前に行わなければなりません。

既に本メソッドを実行したインスタンスに対し、改めて本メソッドを実行することは可能です。 その場合は、新たな文字列と設定に基づき、文字列板画像を再構築します。

引数
[in]fileNameファイル名
戻り値
文字列板生成に成功すれば true を、失敗すれば false を返します。
int FK_CLI::fk_TextImage::GetLineCharNum ( int  num)

行中文字数参照メソッド

入力した文字列中の、指定した行の文字数を取得します。

引数
[in]num行番号。最初の行は 0 となります。
戻り値
文字数
参照
LineNum, AllCharNum, LoadUniStr(), LoadStrFile()
int FK_CLI::fk_TextImage::GetLineWidth ( int  num)

行横幅参照メソッド

入力した文字列中の、指定した行の横幅を取得します。 単位はピクセルとなります。

引数
[in]num行番号。最初の行は 0 となります。
戻り値
横幅
参照
GetLineHeight(), MaxLineWidth
int FK_CLI::fk_TextImage::GetLineHeight ( int  num)

行縦幅参照メソッド

入力した文字列中の、指定した行の縦幅を取得します。 単位はピクセルとなります。

覚え書き
TrueType 形式のフォント、特に半角英数字については、 横幅、縦幅共に文字によって異なります。 結果として、行の縦幅も構成される文字によって異なってくることになります。
引数
[in]num行番号。最初の行は 0 となります。
戻り値
縦幅
参照
GetLineWidth(), MaxLineHeight
int FK_CLI::fk_TextImage::GetLineStartXPos ( int  num)

行開始位置 x 成分取得メソッド

入力した文字列中の、 指定した行の開始位置(文字列左下部分)の x 成分を取得します。 単位はピクセルとなります。

引数
[in]num行番号。最初の行は 0 となります。
戻り値
行左下部分の x 成分
参照
GetLineStartYPos()
int FK_CLI::fk_TextImage::GetLineStartYPos ( int  num)

行開始位置 y 成分取得メソッド

入力した文字列中の、 指定した行の開始位置(文字列左下部分)の y 成分を取得します。 単位はピクセルとなります。

引数
[in]num行番号。最初の行は 0 となります。
戻り値
行左下部分の y 成分
参照
GetLineStartXPos()
bool FK_CLI::fk_TextImage::Send ( void  )

文字送り実行メソッド

fk_TextImage::SendingMode プロパティで指定したモードに従い、 文字送りを行います。

戻り値
文字送りが行われたら true を返します。 既に全ての文字が表示されていた状態で本メソッドを呼び出した場合は、 false を返します。
参照
SendingMode, Finish(), Clear()
bool FK_CLI::fk_TextImage::Finish ( void  )

文字送り完了メソッド

文字送りが有効である場合に、 まだ表示されていない文字を全て表示させます。

戻り値
本メソッドを呼び出した時点で、まだ表示されていない文字があり、 新たに表示された文字が存在した場合には true を返します。 呼び出した時点で既に全ての文字が表示されており、 新たに表示された文字が存在しなかった場合には false を返します。
参照
SendingMode, Send(), Clear()
bool FK_CLI::fk_TextImage::Clear ( void  )

文字送り初期化メソッド

文字送りが有効である場合に、 全ての文字を初期状態、つまり非表示の状態に戻します。

戻り値
本メソッドを呼び出した時点で、既に表示されていた文字があり、 なんらかの文字が消去された場合には true を返します。 呼び出した時点で文字が表示されておらず、 結果的に非表示となった文字が存在しなかった場合には false を返します。
参照
SendingMode, Send(), Finish()
static void FK_CLI::fk_TextImage::ClearCache ( void  )
static

キャッシュ初期化メソッド

キャッシュ機能が有効である場合に、 これまでのキャッシュデータをすべて消去します。

参照
CacheMode

プロパティ詳解

int FK_CLI::fk_TextImage::DPI
getset

フォント解像度プロパティ

フォントの解像度の参照・設定を行います。 解像度を高くするほど高精細な画像となりますが、 画像サイズが大きくなるため描画時の負担が高くなっていきます。 デフォルトでは 48 に設定されています。

覚え書き
機能的には fk_TextImage::PTSize とほとんど同義になりますが、 フォントによっては解像度が高い場合とサイズが大きい場合では 異なった描画結果となることがあります。
参照
PTSize
int FK_CLI::fk_TextImage::PTSize
getset

フォントサイズプロパティ

フォントのサイズの参照・設定を行います。 サイズを大きくするほど高精細な画像となりますが、 画像サイズが大きくなるため描画時の負担が高くなっていきます。 デフォルトでは 48 に設定されています。

覚え書き
機能的には fk_TextImage::DPI とほとんど同義になりますが、 フォントによっては解像度が高い場合とサイズが大きい場合では 異なった描画結果となることがあります。
参照
DPI
int FK_CLI::fk_TextImage::BoldStrength
getset

太さ値プロパティ

文字の太さを数値に応じて太くします。 高い値であるほど、線が太くなっていきます。 デフォルトは 1 となっています。 太さの度合いについては、解像度やフォントサイズに依存するので、 それぞれと合わせて調整する必要があります。

引数
[in]str太さ値
参照
DPI, PTSize
bool FK_CLI::fk_TextImage::ShadowMode
getset

影付け効果プロパティ

表示文字に対し、影付け効果有無の参照・設定を行います。 true の場合有効、false の場合無効となります。 デフォルトでは無効となっています。

参照
ShadowOffset, ShadowColor
fk_Dimension^ FK_CLI::fk_TextImage::ShadowOffset
getset

影付けずらし幅プロパティ

影付け効果の際、影のずらし幅を設定します。

x 成分は横方向のずれを設定します。単位はピクセルです。 正の値で右方向、負の値で左方向にずらします。

y 成分は縦方向のずれを設定します。単位はピクセルです。 正の値で下方向、負の値で上方向にずらします。

参照
ShadowMode, ShadowColor, fk_Dimension
fk_Color^ FK_CLI::fk_TextImage::ShadowColor
getset

影付け色プロパティ

影付け効果の際の、影の色の参照・設定を行います。透過色設定も有効となります。

参照
ShadowMode, ShadowOffset, fk_Color
fk_Color^ FK_CLI::fk_TextImage::ForeColor
getset

文字色プロパティ

文字色の参照・設定を行います。透過色設定も有効となります。

参照
BackColor, SmoothMode
fk_Color^ FK_CLI::fk_TextImage::BackColor
getset

背景色プロパティ

背景色の参照・設定を行います。透過色設定も有効となります。

参照
ForeColor, SmoothMode
bool FK_CLI::fk_TextImage::SmoothMode
getset

アンチエイリアシング効果プロパティ

表示文字に対し、アンチエイリアシング効果の有無の参照・設定を行います。 true の場合有効、false の場合無効となります。

この設定を有効とした場合、 表示の際に文字色と背景色の中間色も描画に利用されるようになります。 逆に無効とした場合、描画の際には文字色と背景色以外は利用されなくなります。 デフォルトでは有効となっています。

参照
ForeColor, BackColor
bool FK_CLI::fk_TextImage::MonospaceMode
getset

等幅表示プロパティ

文字の等幅表示効果の参照・設定を行います。 true の場合有効、false の場合無効となります。 デフォルトでは無効となっています。

設定を有効とした場合、半角全角問わず全ての文字を等幅で表示します。 なお、 fk_TextImage::CharSkip によって設定する文字間幅は等幅においても有効となります。

覚え書き
fk_TextImage::MonospaceSize によって文字幅を設定しないと、 文字幅が 0 として表示されてしまうため、何も表示されていない状況となります。
参照
MonospaceSize, CharSkip
int FK_CLI::fk_TextImage::MonospaceSize
getset

等幅表示文字幅プロパティ

等幅表示の際の文字幅の参照・設定を行います。単位はピクセルとなります。 デフォルトでは 0 が設定されています。

覚え書き
等幅表示は、 fk_TextImage::MonospaceMode で設定を有効としなければ等幅表示とはなりません。
参照
MonospaceMode, CharSkip
int FK_CLI::fk_TextImage::CharSkip
getset

文字間幅プロパティ

文字同士の横方向の空白幅の参照・設定を行います。 単位はピクセルとなります。 デフォルトは 0 に設定されています。

文字との対比については、解像度やフォントサイズに応じて変わってきます。 つまり、解像度やフォントサイズが大きい場合、 空白を作るには大きな値が必要となります。 従って、解像度やフォントサイズを変更した場合には、 この値も再度調整する必要があります。

参照
LineSkip, SpaceLineSkip, SetOffset(), DPI, PTSize, MonospaceMode, MonospaceSize
int FK_CLI::fk_TextImage::LineSkip
getset

行間幅プロパティ

行同士の縦方向の空白幅の参照・設定を行います。 単位はピクセルとなります。 デフォルトは 0 に設定されています。

文字との対比については、解像度やフォントサイズに応じて変わってきます。 つまり、解像度やフォントサイズが大きい場合、 空白を作るには大きな値が必要となります。 従って、解像度やフォントサイズを変更した場合には、 この値も再度調整する必要があります。

参照
CharSkip, SpaceLineSkip, SetOffset(), DPI, PTSize
int FK_CLI::fk_TextImage::SpaceLineSkip
getset

空行縦幅プロパティ

文字列中に空行が入っていた場合の、その縦幅を設定します。 単位はピクセルとなります。 この値が 0 である場合、空行は結果的に省略されることになります。

文字との対比については、解像度やフォントサイズに応じて変わってきます。 つまり、解像度やフォントサイズが大きい場合、 空白を作るには大きな値が必要となります。 従って、解像度やフォントサイズを変更した場合には、 この値も再度調整する必要があります。

参照
CharSkip, LineSkip, SetOffset(), DPI, PTSize
fk_TextAlign FK_CLI::fk_TextImage::Align
getset

文字列寄せ方向(アライメント)プロパティ

文字列を表示する際の、文字寄せ方向(アライメント)の参照・設定を行います。

複数行に渡る文字列の場合で、各行の横幅が異なる場合や、 fk_TextImage::MinLineWidth によって画像の横幅をあらかじめ設定した場合などは、 行の横幅が画像の横幅に満たない状況が生じます。 このような行に対し、本メソッドでどちら側に寄るのかを設定します。 デフォルトは fk_Align.LEFT 、つまり左寄せとなっています。

参照
fk_TextAlign, MinLineWidth
int FK_CLI::fk_TextImage::MinLineWidth
getset

画像最小横幅プロパティ

生成される文字列板画像の横幅の最小値の参照・設定を行います。 単位はピクセルとなります。 デフォルトは 0 に設定されています。

通常、文字列板として生成される画像の横幅は、 入力した文字列に依存します。 行の文字数が多ければ幅は広がり、逆に少ない場合は狭まります。 このような異なる画像を同じテクスチャ画像として連続に表示した場合、 一文字の横幅が画像によって変動してしまうという現象が生じます。 これは、あまり見栄えが良いとは言えません。 そのような場合、本メソッドを用いて十分な横幅を予め確保しておきます。 そうすることで、文字列はアライメントに従って適切に配置され、 文字の幅も画像によって変わることはありません。

ただし、ここで設定した横幅を超える幅を持つ行が発生した場合、 画像の幅はその行による幅に設定されることになります。

参照
Align
int FK_CLI::fk_TextImage::LineNum
get

行数プロパティ

入力した文字列の行数を参照します。

参照
LoadUniStr(), LoadStrFile()
int FK_CLI::fk_TextImage::AllCharNum
get

文字数プロパティ

入力した文字列の文字数を参照します。

参照
LineNum, GetLineCharNum(), LoadUniStr(), LoadStrFile()
int FK_CLI::fk_TextImage::MaxLineWidth
get

最大横幅プロパティ

入力した文字列のうち、最も横幅が広い行の横幅を参照します。 単位はピクセルとなります。

画像の横幅を直接取得するには、 fk_Image::Size を利用して下さい。

参照
MaxLineHeight, MinLineWidth, GetLineWidth()
int FK_CLI::fk_TextImage::MaxLineHeight
get

最大縦幅プロパティ

入力した文字列のうち、最も縦幅が広い行の縦幅を参照します。 単位はピクセルとなります。

画像全体の縦幅を取得するには、 fk_Image::Size を利用して下さい。

覚え書き
TrueType 形式のフォント、特に半角英数字については、 横幅、縦幅共に文字によって異なります。 結果として、行の縦幅も構成される文字によって異なってくることになります。
参照
MaxLineWidth, GetLineHeight()
fk_TextSendingMode FK_CLI::fk_TextImage::SendingMode
getset

文字送りモードプロパティ

文字送りのモードの参照・設定を行います。

「文字送り」とは、読み込んだ文字列を最初は表示せず、 一文字ずつ、あるいは一行ずつ徐々に表示していく機能のことです。 文字送りを有効とした場合、 Send() を呼び出すごとに一文字ずつ、あるいは一行ずつが表示されていきます。 一度表示した文字列については、 Clear() を呼び出すことで初期状態 (文字が表示されていない状態)に戻すことができます。

本メソッドは、文字列を LoadUniStr()LoadStrFile() で入力する前に設定しておくことが可能です。 また、入力後に動的に変更することも可能です。

値として、以下のものが設定可能です。

- fk_TextSendingMode.CHAR: 一文字ずつ送るモード。
- fk_TextSendingMode.LINE: 一行ずつ送るモード。
- fk_TextSendingMode.ALL: 文字送りを無効とするモード。
参照
Send(), Finish(), Clear()
bool FK_CLI::fk_TextImage::CacheMode
staticgetset

キャッシュ機能制御プロパティ

このメソッドは、フォントデータのキャッシュの制御を参照・設定します。 true であれば有効、false であれば無効とします。 デフォルトでは無効となっています。

文字列の画像を生成する際には、 入力されたフォントデータからビットマップとしての 画像情報に変換するという処理がなされます。 同じ文字に対してこの処理を行うことは、計算時間の点で無駄となります。 そこで、 fk_TextImage には一度得た画像情報を保存しておき、 同じ文字が登場した際には再利用するという機能があります。 これが「キャッシュ機能」です。 特に数字やアルファベット、平仮名などは再利用する頻度が高いため、 本機能を有効とすることで処理が高速となる利点があります。

一方、キャッシュ機能はメモリの利用量が増えることを意味します。 高い解像度やフォントサイズを用いている場合は、 キャッシュのメモリ利用量も膨大となっていきますので、 場合によっては処理速度がむしろ低下することもありえます。

ここで利用されるキャッシュデータは、 インスタンス毎ではなくシステム全体で共有されます。 従って、異なるインスタンスで読み込んだ文字に関しても キャッシュ効果が働くことになります。

参照
ClearCache()