図形やテキストは、SFXGraphics クラスを利用して画面に描画します。 SFXGraphics クラスは SFBGraphics クラスと SFBDisplay クラスを抽象化したクラスです。

SFXGraphics クラスは、 SFBGraphics クラスの図形を描画するための関数と SFBDisplay クラスのテキストを描画するための関数を継承しているため、 図形とテキストの描画に関してクリッピングや原点の移動などが簡単に行えます。

図形やテキストを描画するための SFXGraphics インスタンスは、 アプレット起動時に自動的に生成され、アプレット終了時に自動的に解放されます。 そのため、SFXGraphics インスタンスの初期化処理や終了処理は不要です。

SFXGraphics インスタンスは、 SFXGraphics::GetInstance 関数を使用して取得します。 あるいは、描画ハンドラの引数として渡されます。

描画の対象となるターゲットビットマップは、SFXGraphics::SetDestination 関数で設定します。 デフォルトの設定では、デバイスビットマップがターゲットビットマップです。

GUI フレームワークを利用する場合は、 レスポンダ領域(ローカル領域)の左上端を原点とする相対座標系で描画を行えるように自動的に原点が移動します。

描画内容を実際に画面に反映させるには、 SFXGraphics::BitBlt 関数を呼び出してターゲットビットマップの内容をデバイスビットマップに転送し(デフォルトの設定の場合は不要)、 SFXGraphics::Update 関数を呼び出す必要があります。 GUI フレームワークを使用する場合、この処理は SFYResponder::Render 関数内で自動的に行われます(SFXGraphics::Update 関数の呼び出しは不要です)。

たとえば、矩形を画面に描画するには以下のように記述します。

// SFXGraphics インスタンスを取得する
SFXGraphicsPtr graphics = SFXGraphics::GetInstance();

// 画面の矩形 rectangle を取得する
SFXRectangle rectangle(SFXGraphics::GetDeviceRectangle());

// 矩形 rectangle を白色に塗りつぶす
graphics->ClearRectangle(rectangle, SFXRGBColor(0xFF, 0xFF, 0xFF, 0x00));

// 前景色を青色にする
graphics->SetForeColor(SFXRGBColor(0x00, 0x00, 0xFF, 0x00));
   
// 塗り潰しモードをオフにする
graphics->SetFillMode(false);

// 矩形 rectangle を上下左右 10 ピクセルずつ縮小した矩形を描画する
graphics->DrawRectangle(rectangle.Deflate(10, 10));

// 画面を更新する
graphics->Update();

また、テキストを描画するには以下のように記述します。

// SFXGraphics インスタンスを取得する
SFXGraphicsPtr graphics = SFXGraphics::GetInstance();

// 画面の矩形 rectangle を取得する
SFXRectangle rectangle(SFXGraphics::GetDeviceRectangle());

// 矩形 rectangle を白色に塗りつぶす
graphics->ClearRectangle(rectangle, SFXRGBColor(0xFF, 0xFF, 0xFF, 0x00));

// "Hello World" を黒色で描画する
graphics->DrawSingleText("Hello World", rectangle, SFXRGBColor(0x00, 0x00, 0x00, 0x00));

// 画面を更新する
graphics->Update();

長いテキストを自動改行して描画する関数も用意されています。 下記サンプルコードでは、この関数を使用して画面上に指定された矩形(画面全体の矩形を上下左右 5 ピクセルずつ縮小した矩形)内に文章を青色で描画しています。

// SFXGraphics インスタンスを取得する
SFXGraphicsPtr graphics = SFXGraphics::GetInstance();

// 画面の矩形 rectangle を取得する
SFXRectangle rectangle(SFXGraphics::GetDeviceRectangle());

// 矩形 rectangle を白色に塗りつぶす
graphics->ClearRectangle(rectangle, SFXRGBColor(0xFF, 0xFF, 0xFF, 0x00));

// 前景色を青色にする
graphics->SetForeColor(SFXRGBColor(0x00, 0x00, 0xFF, 0x00));
// 矩形 rectangle を上下左右 5 ピクセルずつ縮小した矩形内に文章を青色で描画する
graphics->DrawMultipleTextLeft("Ladies and Gentleman, SophiaFramework UNIVERSE is "
                                  "the most powerful GUI frameowk library in the BREW world.",
                                  rectangle.Deflate(5, 5), 
                                  SFXGrid(5, 5), 
                                  rectangle.GetWidth() - 5 * 2 );

// 画面を更新する
graphics->Update();

原点移動を行うには以下のように記述します。

下記のサンプルコードでは、描画の原点を (-50, -50) に移動して描画を行っています。 画面左上端を原点とする座標系で表すと移動前の原点は (50, 50) に移動したことになります。

// SFXGraphics インスタンスを取得する
SFXGraphicsPtr graphics = SFXGraphics::GetInstance();

// 原点を移動する前の画面領域を矩形 rectangle に保存する
SFXRectangle rectangle(SFXGraphics::GetDeviceRectangle());

// 原点を (-50, -50) に移動する[(-50, -50)が画面左上端になる]
graphics->SetTranslate(SFXGrid(-50, -50));

// 矩形 rectangle を灰色に塗りつぶす
graphics->ClearRectangle(rectangle, SFXRGBColor(0xDD, 0xDD, 0xDD, 0x00));

// 前景色を青色にする
graphics->SetForeColor(SFXRGBColor(0x00, 0x00, 0xFF, 0x00));
   
// 塗り潰しモードをオフにする
graphics->SetFillMode(false);

// 矩形 rectangle を上下左右 30 ピクセルずつ縮小した矩形を描画する
graphics->DrawRectangle(rectangle.Deflate(30, 30));

// 画面を更新する
graphics->Update();