前のページ次のページ上に戻るホーム BREW C++ ライブラリ & GUI フレームワーク : SophiaFramework 3.0
SFBDisplay
IDisplay インターフェイスのラッパークラスです。
#include <SFBDisplay.h.hpp>
class SFBDisplay : public SFBBase;
SFMTYPEDEFWRAPPER(SFBDisplay)

継承図

SFBDisplay クラスの継承図

協調図

SFBDisplay クラスの協調図

参照

BREW API IDisplay

バグ情報

IDISPLAY_Update. IDISPLAY_UpdateEx
Tips すべて

IDISPLAY_Update/UpdateEx の動作が 2.0 と 2.1 で変更されました。 2.0 では、IDISPLAY_SetDestination を行っても、IDISPLAY_Update/UpdateEx は常にデバイスビットマップからディスプレイを更新していました。 2.1 では、IDISPLAY_SetDestination でデバイスビットマップと異なるビットマップが宛先ビットマップに指定されている場合、 IDISPLAY_Update/UpdateEx はディスプレイを更新しなくなりました。

メンバ

パブリック関数
Void Backlight( Bool on )
デバイスのバックライトを点灯/消灯します。
Void BitBlt( SInt32 xDest , SInt32 yDest , SInt32 cxDest , SInt32 cyDest , VoidConstPtr bmpSrc , SInt32 xSrc , SInt32 ySrc , AEERasterOp rop = AEE_RO_COPY )
BitBlt( SFXRectangleConstRef rect , SFBBitmapSmpConstRef bmpSrc , SFXGridConstRef gridSrc , AEERasterOp rop = AEE_RO_COPY )
BitBlt( SFXRectangleConstRef rect , SFXBufferConstRef bmpSrc , SFXGridConstRef gridSrc , AEERasterOp rop = AEE_RO_COPY )
BitBlt( SFXRectangleConstRef rect , VoidConstPtr bmpSrc , SFXGridConstRef gridSrc , AEERasterOp rop = AEE_RO_COPY )
BitBlt( SInt32 xDest , SInt32 yDest , SInt32 cxDest , SInt32 cyDest , SFXBufferConstRef bmpSrc , SInt32 xSrc , SInt32 ySrc , AEERasterOp rop = AEE_RO_COPY )
ビットマップを表示領域に転送します。
Void ClearScreen( Void )
現在のクリッピング長方形をクリアするか、 またはクリッピング長方形が設定されていない場合は、 デバイス画面全体をクリアします。
SFCError Clone( SFBDisplaySmpPtr clone )
新しい SFBDisplay インスタンスを作成し、 SFBDisplay インスタンスの現在の設定をこの新しいインスタンスにコピーします。
SFBDisplaySmp Clone( Void )
新しい SFBDisplay インスタンスを作成し、 SFBDisplay インスタンスの現在の設定をこの新しいインスタンスにコピーします。
SFCError CreateDIBitmap( SFBDIBSmpPtr clone , UInt08 depth , UInt16 width , UInt16 height )
新しいデバイス独立ビットマップ(DIB)を作成します。
SFBDIBSmp CreateDIBitmap( UInt08 depth , SFXSizeConstRef size )
新しいデバイス独立ビットマップ(DIB)を作成します。
SInt32 DrawFrame( SFXRectanglePtr rect , AEEFrameType frameType , RGBVAL fillType )
DrawFrame( SFXRectanglePtr rect , AEEFrameType frameType , SFXRGBColorConstRef fillType )
システムのカラー解像度に基づいて複雑なフレームを描画します。
Void DrawHLine( SInt16 x , SInt16 y , SInt16 length )
DrawHLine( SFXPixelConstRef pixel , SInt16 length )
指定された開始点から、指定された長さを持つ水平線を描画します。
Void DrawRect( SFXRectangleConstRef rect , RGBVAL frameColor , RGBVAL fillColor , UInt32 flags )
DrawRect( SFXRectangleConstRef rect , SFXRGBColorConstRef frameColor , SFXRGBColorConstRef fillColor , UInt32 flags )
長方形を描画します。
SFCError DrawText( AEEFont font , WCharConstPtr text , SInt32 textLength , SInt32 x , SInt32 y , SFXRectangleConstPtr rect , UInt32 flags = IDF_ALIGN_NONE )
DrawText( AEEFont font , SFXWideStringConstRef text , SInt32 textLength , SFXRectangleConstRef rect , UInt32 align = IDF_ALIGN_NONE )
DrawText( AEEFont font , SFXWideStringConstRef text , SInt32 textLength , SFXGridConstRef grid , UInt32 align = IDF_ALIGN_NONE )
DrawText( AEEFont font , SFXWideStringConstRef text , SInt32 textLength , SFXGridConstRef grid , SFXRectangleConstRef rect , UInt32 align = IDF_ALIGN_NONE )
DrawText( AEEFont font , SFXWideStringConstRef text , SInt32 textLength , SFXGridConstPtr grid , SFXRectangleConstPtr rect , UInt32 align = IDF_ALIGN_NONE )
DrawText( AEEFont font , WCharConstPtr text , SInt32 textLength , SInt32 x , SInt32 y , SFXRectangleConstRef rect , UInt32 flags = IDF_ALIGN_NONE )
テキストを描画します。
Void DrawVLine( SInt16 x , SInt16 y , SInt16 length )
DrawVLine( SFXPixelConstRef pixel , SInt16 length )
指定された開始点から、指定された長さを持つ垂直線を描画します。
Void EraseRect( SFXRectanglePtr rect )
指定された長方形を既定の背景色で塗りつぶします。
Void EraseRgn( SInt16 x , SInt16 y , UInt16 cx , UInt16 cy )
EraseRgn( SFXRectangleConstRef rect )
指定された座標で囲まれた領域を既定の背景色で塗りつぶします。
Void FillRect( SFXRectanglePtr rect , RGBVAL fillColor )
FillRect( SFXRectanglePtr rect , SFXRGBColorConstRef fillColor )
長方形を描画して、指定された色で塗りつぶします。
Void FrameButton( SFXRectanglePtr rect , Bool pressed , RGBVAL fillType )
FrameButton( SFXRectanglePtr rect , Bool pressed , SFXRGBColorConstRef fillType )
システムのカラー解像度に基づいて 3D フレーム付きボタンを描画します。
Void FrameRect( SFXRectanglePtr rect )
長方形の境界線を描画します。
Void FrameSolidRect( SFXRectanglePtr rect )
長方形の境界線を描画して、色で塗りつぶします。
Void GetClipRect( SFXRectanglePtr rect )
現在のクリッピング長方形を返します。
SFXRectangle GetClipRect( Void )
現在のクリッピング長方形を返します。
SFBBitmapSmp GetDestination( Void )
レンダリング先ビットマップを取得します。
SFCError GetDeviceBitmap( SFBBitmapSmpPtr clone )
デバイス(画面)ビットマップを取得します。
SFBBitmapSmp GetDeviceBitmap( Void )
デバイス(画面)ビットマップを取得します。
SInt32 GetFontMetrics( AEEFont font , SInt32Ptr ascent = null , SInt32Ptr descent = null )
指定されたフォントの情報を取得します。
static
SFBDisplaySmp
GetInstance( Void )
SFBDisplay インターフェイスのインスタンスを取得します。
WChar GetSymbol( AEESymbol symbol , AEEFont font )
指定された記号に対応する文字を返します。
Void InvertRect( SFXRectanglePtr rect )
指定された長方形内の色を反転させます。
Bool IsEnabled( Void )
描画対象のビットマップに対して、 SFBDisplay が有効状態であるか判定します。
Void MakeDefault( Void )
デフォルトの SFBDisplay オブジェクトとして設定します。
SInt32 MeasureText( AEEFont font , WCharConstPtr text )
MeasureText( AEEFont font , SFXWideStringConstRef text )
指定されたテキスト文字列を指定されたフォントで描画した場合の幅を測定します。
SInt32 MeasureTextEx( AEEFont font , WCharConstPtr text , SInt32 textLength , SInt32 maxWidth , SInt32Ptr fits )
MeasureTextEx( AEEFont font , SFXWideStringConstRef text , SInt32 textLength , SInt32 maxWidth , SInt32Ptr fits )
指定されたテキスト文字列を指定されたフォントで描画した場合の幅を測定します。 文字列の実際のピクセル幅が返されます。
static
SFBDisplaySmp
NewInstance( AEECLSID clsid = AEECLSID_DISPLAYCLONE )
NewInstance( Void )
SFBDisplay インターフェイスのインスタンスを作成します。
SFCError NotifyEnable( AEECallback* callback )
SFBDisplay の有効状態が変化したときに通知を受け取る関数を登録します。
Void ResetClipRect( Void )
クリッピング長方形を解除します。
SFCError ResetDestination( Void )
SFBDisplay のレンダリング先ビットマップを解除し、 レンダリング先を画面ビットマップに設定します。
Void SetAnnunciators( UInt16 value , UInt16 mask )
指定されたアナンシエータをオンまたはオフにします。
Void SetClipRect( SFXRectangleConstRef rect )
クリッピング長方形を設定します。
RGBVAL SetColor( AEEClrItem item , RGBVAL itemColor )
SetColor( AEEClrItem item , SFXRGBColorConstRef itemColor )
指定されたユーザー項目の色を設定します。
SFCError SetDestination( SFBBitmapSmpConstRef bmpDest )
レンダリング先のビットマップを設定します。
SFBFontPtr SetFont( AEEFont font , SFBFontPtr newFont )
指定されたAEEFontの描画に使用するフォントを設定します。
Void Update( Void )
デバイスビットマップに対して描画操作を行った後、 変更を表示ハードウェアに通知するために呼び出します。
Void UpdateEx( Bool defer )
デバイスビットマップに対して描画操作を行った後、 変更を表示ハードウェアに通知するために呼び出します。

SFBDisplay::Backlight
デバイスのバックライトを点灯/消灯します。
[ public ]
Void Backlight(
    Bool on   // true の場合は、バックライトが点灯する。
false の場合は、バックライトが消灯する。
);

参照

BREW API IDISPLAY_Backlight


SFBDisplay::BitBlt
ビットマップを表示領域に転送します。
[ public ]
Void BitBlt(
    SInt32 xDest                    
    SInt32 yDest                    
    SInt32 cxDest                   
    SInt32 cyDest                   
    VoidConstPtr bmpSrc             
    SInt32 xSrc                     
    SInt32 ySrc                     
    AEERasterOp rop = AEE_RO_COPY   
);
[ public ]
Void BitBlt(
    SInt32 xDest                    
    SInt32 yDest                    
    SInt32 cxDest                   
    SInt32 cyDest                   
    SFXBufferConstRef bmpSrc        
    SInt32 xSrc                     
    SInt32 ySrc                     
    AEERasterOp rop = AEE_RO_COPY   
);
[ public ]
Void BitBlt(
    SFXRectangleConstRef rect       
    VoidConstPtr bmpSrc             
    SFXGridConstRef gridSrc         
    AEERasterOp rop = AEE_RO_COPY   
);
[ public ]
Void BitBlt(
    SFXRectangleConstRef rect       
    SFXBufferConstRef bmpSrc        
    SFXGridConstRef gridSrc         
    AEERasterOp rop = AEE_RO_COPY   
);
[ public ]
Void BitBlt(
    SFXRectangleConstRef rect       
    SFBBitmapSmpConstRef bmpSrc     
    SFXGridConstRef gridSrc         
    AEERasterOp rop = AEE_RO_COPY   
);

引数

xDest

宛先長方形領域の左上隅の x 座標を指定する。

yDest

宛先長方形領域の左上隅の y 座標を指定する。

cxDest

宛先長方形の幅を指定する。 この値がソースビットマップ(pmSource)の幅より大きい場合、 このパラメータはソースビットマップの幅と同じになる。

cyDest

宛先長方形の高さを指定する。 この値がソースビットマップ(pmSource)の高さより大きい場合、 このパラメータはソースビットマップの高さと同じになる。

bmpSrc

IBitmap インタフェース、IDIB インタフェース、またはソースビットマップ構造体へのポインタ。 ソースビットマップ構造体の場合、ポインタが指しているデータには AEE ヘッダーが含まれない。 BMP 形式の場合、データは BITMAPFILEHEADER から始まることが可能。

xSrc

ビットブロック転送を開始するソースビットマップの左上隅のx座標を指定する。

ySrc

ビットブロック転送を開始するソースビットマップの左上隅のy座標を指定する。

rop

ビットマップの転送中に使用するラスター操作を指定する。

参照

BREW API IDISPLAY_BitBlt | SFBDisplay::Update | AEERasterOp


SFBDisplay::ClearScreen
現在のクリッピング長方形をクリアするか、 またはクリッピング長方形が設定されていない場合は、 デバイス画面全体をクリアします。
[ public ]
Void ClearScreen(Void);

参照

BREW API IDISPLAY_ClearScreen


SFBDisplay::Clone
新しい SFBDisplay インスタンスを作成し、 SFBDisplay インスタンスの現在の設定をこの新しいインスタンスにコピーします。
[ public ]
SFCError Clone(
    SFBDisplaySmpPtr clone   // 新しいインスタンスのアドレスを格納するインタフェース。
);
[ public ]
SFBDisplaySmp Clone(Void);

参照

BREW API IDISPLAY_Clone


SFBDisplay::CreateDIBitmap
新しいデバイス独立ビットマップ(DIB)を作成します。
[ public ]
SFCError CreateDIBitmap(
    SFBDIBSmpPtr clone   // 新しいDIB のインタフェースへのポインタ。
    UInt08 depth         // 1 ピクセルに使用されるビットの数。
    UInt16 width         // 新しいビットマップの幅(ピクセル数)。
    UInt16 height        // 新しいビットマップの高さ(ピクセル数)。
);
[ public ]
SFBDIBSmp CreateDIBitmap(
    UInt08 depth           // 1 ピクセルに使用されるビットの数。
    SFXSizeConstRef size   // // 新しいビットマップのサイズ。
);

参照

BREW API IDISPLAY_CreateDIBitmap | SFBBitmap | SFBDIB | IDIB_TO_IBITMAP


SFBDisplay::DrawFrame
システムのカラー解像度に基づいて複雑なフレームを描画します。
[ public ]
SInt32 DrawFrame(
    SFXRectanglePtr rect     // ソース長方形へのポインタ。このパラメータが null の場合、フレームは描画されない。
    AEEFrameType frameType   // フレームタイプ。
    RGBVAL fillType          // フレーム内部の塗りつぶしタイプ。
);
[ public ]
SInt32 DrawFrame(
    SFXRectanglePtr rect           // ソース長方形へのポインタ。このパラメータが null の場合、フレームは描画されない。
    AEEFrameType frameType         // フレームタイプ。
    SFXRGBColorConstRef fillType   // フレーム内部を塗りつぶす色。
);

参照

BREW API IDISPLAY_DrawFrame | AEEFrameType


SFBDisplay::DrawHLine
指定された開始点から、指定された長さを持つ水平線を描画します。
[ public ]
Void DrawHLine(
    SInt16 x        // 開始点の Y 座標
    SInt16 y        // 開始点の X 座標
    SInt16 length   // 描画する長さ
);
[ public ]
Void DrawHLine(
    SFXPixelConstRef pixel   // 開始点
    SInt16 length            // 描画する長さ
);

参照

BREW API IDISPLAY_DrawHLine | SFBDisplay::DrawVLine


SFBDisplay::DrawRect
長方形を描画します。
[ public ]
Void DrawRect(
    SFXRectangleConstRef rect   
// 描画する長方形の座標を定義する AEERect 構造体へのポインタ。
// これらの座標は、画面の左上隅が (0,0) の画面座標系で指定する。
        
    RGBVAL frameColor           
// 長方形のフレーム(外側の境界線)の描画に使用する色。
// このパラメータは、flags に IDF_RECT_FRAME フラグが指定されている場合にのみ使用される。
        
    RGBVAL fillColor            
// 長方形の塗りつぶしに使用する色を指定する。
// このパラメータは、flags に IDF_RECT_FILL フラグが指定されている場合にのみ使用される。
        
    UInt32 flags                
// 長方形の描画に使用するフラグを指定する。
// 以下のフラグの1 つ以上を論理OR で指定する。
// . IDF_RECT_FRAME: 長方形の外側の境界のみを描画する。
// . IDF_RECT_FILL: clrFillの色で長方形を塗りつぶす。
// . IDF_RECT_INVERT: 指定された長方形の内容を反転させる。
// このフラグを設定すると、clrFrame パラメータと clrFill パラメータは無効になる。
        
);
[ public ]
Void DrawRect(
    SFXRectangleConstRef rect        
    SFXRGBColorConstRef frameColor   
    SFXRGBColorConstRef fillColor    
    UInt32 flags                     
);

参照

BREW API IDISPLAY_DrawRect | SFBDisplay::Update


SFBDisplay::DrawText
テキストを描画します。
[ public ]
SFCError DrawText(
    AEEFont font                    // テキストの描画に使用するフォントを指定する。
    WCharConstPtr text              // 描画する文字列を格納する。
    SInt32 textLength               // textの文字数を指定する。-1 を指定すると、この関数により自動的に長さが計算される。
    SInt32 x                        
// テキストを描画する画面上の位置の x 座標を指定する。
// 画面の左上隅が [0,0] とみなされる。
// 左右の位置揃えフラグが設定されている場合、このパラメータは無効になる。
        
    SInt32 y                        
// テキストを描画する画面上の位置の y 座標を指定する。
// 画面の左上隅が [0,0] とみなされる。
// 上下の位置揃えフラグが設定されている場合、このパラメータは無効になる。
        
    SFXRectangleConstPtr rect       
// クリップ領域の座標を指定する。 
// null の場合、宛先ビットマップの境界がクリップ領域になる。
// テキストはクリップ領域の外側には描画されない。
// DF_RECT_XXXX フラグが指定されている場合、 その目的のためにも利用される。
//   NOTE: SFBDisplay::SetClipRect 関数で指定するクリップ領域とは独立している。
//         テキストは二つのクリップ領域内に描画される。
//         IDF_ALIGN_XXXX フラグは rect パラメータにのみアライン指定される。
        
    UInt32 flags = IDF_ALIGN_NONE   
// テキスト描画のためにフラグを指定する。
// 以下のフラグの1 つ以上を論理OR で指定する。
//  a. 左右の位置揃えフラグのひとつ (IDF_ALIGN_LEFT, IDF_ALIGN_CENTER,IDF_ALIGN_RIGHT)
//  b. 上下の位置揃えフラグのひとつ (IDF_ALIGN_TOP, IDF_ALIGN_MIDDLE,IDF_ALIGN_BOTTOM)
//  c. テキストフォーマットフラグのひとつ (IDF_TEXT_UNDERLINE, IDF_TEXT_INVERTED)
//  d. 長方形フォーマットフラグのひとつ (IDF_RECT_FRAME,IDF_RECT_FILL,IDF_RECT_INVERT) 
//     --- これらのフラグは rect パラメータについて機能する。
//      CLR_USER_BACKGROUND as the fill color
//      CLR_USER_FRAME as the frame color.
//
// 位置揃えフラグが指定されない場合、x, y パラメータによってテキストの場所は決定される。
        
);
[ public ]
SFCError DrawText(
    AEEFont font                    
    WCharConstPtr text              
    SInt32 textLength               
    SInt32 x                        
    SInt32 y                        
    SFXRectangleConstRef rect       
    UInt32 flags = IDF_ALIGN_NONE   
);
[ public ]
SFCError DrawText(
    AEEFont font                    
    SFXWideStringConstRef text      
    SInt32 textLength               
    SFXGridConstPtr grid            
    SFXRectangleConstPtr rect       
    UInt32 align = IDF_ALIGN_NONE   
);
[ public ]
SFCError DrawText(
    AEEFont font                    
    SFXWideStringConstRef text      
    SInt32 textLength               
    SFXGridConstRef grid            
    SFXRectangleConstRef rect       
    UInt32 align = IDF_ALIGN_NONE   
);
[ public ]
SFCError DrawText(
    AEEFont font                    
    SFXWideStringConstRef text      
    SInt32 textLength               
    SFXGridConstRef grid            
    UInt32 align = IDF_ALIGN_NONE   
);
[ public ]
SFCError DrawText(
    AEEFont font                    
    SFXWideStringConstRef text      
    SInt32 textLength               
    SFXRectangleConstRef rect       
    UInt32 align = IDF_ALIGN_NONE   
);

戻り値

描画に成功すると SFERR_NO_ERROR を返します。

参照

BREW API IDISPLAY_DrawText | SFBDisplay::Update | AEEFont


SFBDisplay::DrawVLine
指定された開始点から、指定された長さを持つ垂直線を描画します。
[ public ]
Void DrawVLine(
    SInt16 x        // 開始点の X 座標
    SInt16 y        // 開始点の Y 座標
    SInt16 length   // 描画する長さ
);
[ public ]
Void DrawVLine(
    SFXPixelConstRef pixel   // 開始点
    SInt16 length            // 描画する長さ
);

参照

BREW API IDISPLAY_DrawVLine | SFBDisplay::DrawHLine


SFBDisplay::EraseRect
指定された長方形を既定の背景色で塗りつぶします。
[ public ]
Void EraseRect(
    SFXRectanglePtr rect   // 色を反転する長方形への有効なポインタ。
);

参照

BREW API IDISPLAY_EraseRect


SFBDisplay::EraseRgn
指定された座標で囲まれた領域を既定の背景色で塗りつぶします。
[ public ]
Void EraseRgn(
    SInt16 x    // 領域の左上隅の X 座標。
    SInt16 y    // 領域の左上隅の Y 座標。
    UInt16 cx   // 領域の幅。
    UInt16 cy   // 領域の高さ。
);
[ public ]
Void EraseRgn(
    SFXRectangleConstRef rect   // 領域
);

参照

BREW API IDISPLAY_EraseRgn


SFBDisplay::FillRect
長方形を描画して、指定された色で塗りつぶします。
[ public ]
Void FillRect(
    SFXRectanglePtr rect   // 指定された色で塗りつぶす長方形への有効なポインタ。
    RGBVAL fillColor       // 長方形の塗りつぶしに使用する色。
);
[ public ]
Void FillRect(
    SFXRectanglePtr rect            // 指定された色で塗りつぶす長方形への有効なポインタ。
    SFXRGBColorConstRef fillColor   // 長方形の塗りつぶしに使用する色。
);

参照

BREW API IDISPLAY_FillRect


SFBDisplay::FrameButton
システムのカラー解像度に基づいて 3D フレーム付きボタンを描画します。
[ public ]
Void FrameButton(
    SFXRectanglePtr rect   // ソース長方形へのポインタ。
    Bool pressed           // ボタンの押下/非押下を示す識別子。
    RGBVAL fillType        // フレーム内部の塗りつぶしタイプ。
);
[ public ]
Void FrameButton(
    SFXRectanglePtr rect           // ソース長方形へのポインタ。
    Bool pressed                   // ボタンの押下/非押下を示す識別子。
    SFXRGBColorConstRef fillType   // フレーム内部を塗りつぶす色。
);

参照

BREW API IDISPLAY_FrameButton


SFBDisplay::FrameRect
長方形の境界線を描画します。
[ public ]
Void FrameRect(
    SFXRectanglePtr rect   // 境界線を描画する長方形への有効なポインタ。
);

参照

BREW API IDISPLAY_FrameRect


SFBDisplay::FrameSolidRect
長方形の境界線を描画して、色で塗りつぶします。
[ public ]
Void FrameSolidRect(
    SFXRectanglePtr rect   // 描画して塗りつぶす長方形への有効なポインタ。
);

参照

BREW API IDISPLAY_FrameSolidRect


SFBDisplay::GetClipRect
現在のクリッピング長方形を返します。
[ public ]
Void GetClipRect(
    SFXRectanglePtr rect   // 現在のクリッピング長方形の出力先 SFXRectangle へのポインタ。
);
[ public ]
SFXRectangle GetClipRect(Void);

参照

BREW API IDISPLAY_GetClipRect | SFBDisplay::SetClipRect


SFBDisplay::GetDestination
レンダリング先ビットマップを取得します。
[ public ]
SFBBitmapSmp GetDestination(Void);

参照

BREW API IDISPLAY_GetDestination | SFBBitmap | SFBDisplay::SetDestination


SFBDisplay::GetDeviceBitmap
デバイス(画面)ビットマップを取得します。
[ public ]
SFCError GetDeviceBitmap(
    SFBBitmapSmpPtr clone   // デバイスビットマップのインタフェースへのポインタ。
);
[ public ]
SFBBitmapSmp GetDeviceBitmap(Void);

参照

BREW API IDISPLAY_GetDeviceBitmap


SFBDisplay::GetFontMetrics
指定されたフォントの情報を取得します。
[ public ]
SInt32 GetFontMetrics(
    AEEFont font               // アセントおよびディセント情報を取得するフォントタイプを指定する。
    SInt32Ptr ascent = null    
// 入力時は、SInt32 への有効なポインタ。
// リターン時は、指定されたフォントのアセント値を示す整数を指す。
// null ポインタも使用でき、この場合は、リターン時も null になる。
        
    SInt32Ptr descent = null   
// 入力時は、SInt32 への有効なポインタ。
// リターン時は、指定されたフォントのディセント値を示す整数を指す。
// null ポインタも使用でき、この場合は、リターン時も null になる。
        
);

参照

BREW API IDISPLAY_GetFontMetrics


SFBDisplay::GetInstance
SFBDisplay インターフェイスのインスタンスを取得します。
[ public, static ]
SFBDisplaySmp GetInstance(Void);

SFBDisplay::GetSymbol
指定された記号に対応する文字を返します。
[ public ]
WChar GetSymbol(
    AEESymbol symbol   // 要求する記号。
    AEEFont font       // 要求するフォント。
);

参照

BREW API IDISPLAY_GetSymbol


SFBDisplay::InvertRect
指定された長方形内の色を反転させます。
[ public ]
Void InvertRect(
    SFXRectanglePtr rect   // 色を反転する長方形への有効なポインタ。
);

参照

BREW API IDISPLAY_InvertRect


SFBDisplay::IsEnabled
描画対象のビットマップに対して、 SFBDisplay が有効状態であるか判定します。
[ public ]
Bool IsEnabled(Void);

解説

SFBDisplay が無効状態にある場合、 描画関数を呼び出しても効果がありません。 アプリケーションが SFBDIB を通じてデバイス ビットマップの ピクセル バッファに直接アクセスできる場合、 SFBDisplay が無効状態にある間、 ピクセル バッファを変更しないことが重要です。

バージョン

この関数は、BREW 2.1 以降でのみ使用可能です。

参照

BREW API IDISPLAY_IsEnabled | SFBDisplay::NotifyEnable


SFBDisplay::MakeDefault
デフォルトの SFBDisplay オブジェクトとして設定します。
[ public ]
Void MakeDefault(Void);

バージョン

この関数は、BREW 2.1 以降でのみ使用可能です。

参照

BREW API IDISPLAY_MakeDefault


SFBDisplay::MeasureText
指定されたテキスト文字列を指定されたフォントで描画した場合の幅を測定します。
[ public ]
SInt32 MeasureText(
    AEEFont font         
// 指定されたテキストの幅の測定に使用するフォント。
// この関数は、指定されたテキスト文字列を指定されたフォントで描画した場合の幅を測定する。
        
    WCharConstPtr text   // 測定する文字列へのポインタ。
);
[ public ]
SInt32 MeasureText(
    AEEFont font                 
// 指定されたテキストの幅の測定に使用するフォント。
// この関数は、指定されたテキスト文字列を指定されたフォントで描画した場合の幅を測定する。
        
    SFXWideStringConstRef text   // 測定する文字列へのポインタ。
);

参照

BREW API IDISPLAY_MeasureText


SFBDisplay::MeasureTextEx
指定されたテキスト文字列を指定されたフォントで描画した場合の幅を測定します。 文字列の実際のピクセル幅が返されます。
[ public ]
SInt32 MeasureTextEx(
    AEEFont font         
    WCharConstPtr text   
    SInt32 textLength    
    SInt32 maxWidth      
    SInt32Ptr fits       
);
[ public ]
SInt32 MeasureTextEx(
    AEEFont font                 
    SFXWideStringConstRef text   
    SInt32 textLength            
    SInt32 maxWidth              
    SInt32Ptr fits               
);

引数

font

指定されたテキストの幅の測定に使用するフォント。 この関数は、指定されたテキスト文字列を指定されたフォントで描画した場合の幅を測定する。

text

測定する文字列へのポインタ。

textLength

text の文字数を指定する。-1 を指定すると、この関数により自動的に長さが計算される。

maxWidth

テキストの描画に使用できる最大ピクセル幅を指定する。 maxWidth に-1 を指定すると、テキスト文字列のnChars 部が測定され、 *pnFits には常にテキストの全体の長さが返される。 maxWidth > 0 の場合、この値はテキストの描画に使用できる最大のピクセル幅を表す。 この関数は、この制約の中で実際に収まる最大文字数を算出し、 その文字数を *pnFits に格納し、実際のピクセル幅を戻り値として返す。

fits

入力時は整数への有効なポインタ。 関数のリターン時は、maxWidth で指定されたピクセル幅に収まる最大文字数を示す整数へのポインタ。 maxWidth に -1 を指定した場合は、指定された文字列 text の全体の長さを示す整数へのポインタ。

参照

BREW API IDISPLAY_MeasureTextEx


SFBDisplay::NewInstance
SFBDisplay インターフェイスのインスタンスを作成します。
[ public, static ]
SFBDisplaySmp NewInstance(
    AEECLSID clsid = AEECLSID_DISPLAYCLONE   // 
);
[ public, static ]
SFBDisplaySmp NewInstance(Void);

解説

        static  SFBDisplaySmp       NewInstance             (AEECLSID clsid = AEECLSID_DISPLAYCLONE);

は BREW 2.1 環境で定義されます。

        static  SFBDisplaySmp       NewInstance             (Void);

は BREW 2.0 環境で定義されます。


SFBDisplay::NotifyEnable
SFBDisplay の有効状態が変化したときに通知を受け取る関数を登録します。
[ public ]
SFCError NotifyEnable(
    AEECallback* callback   // コールバック構造体
);

バージョン

この関数は、BREW 2.1 以降でのみ使用可能です。

参照

BREW API IDISPLAY_NotifyEnable | SFBDisplay::IsEnabled


SFBDisplay::ResetClipRect
クリッピング長方形を解除します。
[ public ]
Void ResetClipRect(Void);

参照

SFBDisplay::SetClipRect


SFBDisplay::ResetDestination
SFBDisplay のレンダリング先ビットマップを解除し、 レンダリング先を画面ビットマップに設定します。
[ public ]
SFCError ResetDestination(Void);

参照

SFBDisplay::SetDestination


SFBDisplay::SetAnnunciators
指定されたアナンシエータをオンまたはオフにします。
[ public ]
Void SetAnnunciators(
    UInt16 value   
// この関数でオン/オフを切り替えるアナンシエータのセットを指定する。
// 以下のアナンシエータフラグを1つ以上組み合わせた論理ORで指定できる。
// ANNUN_MSG ボイスメール
// ANNUN_NET_MSG ネットメッセージ
// ANNUN_ALARMCLOCK アラームクロック
// ANNUN_NET_LOCK ロックされたデバイス
// ANNUN_STOPWATCH ストップウォッチ
// ANNUN_COUNTDOWN カウントダウンクロック
// ANNUN_SILENCEALL ベル音オフ
        
    UInt16 mask    
// value に指定したアナンシエータフラグごとに、
// このマスクの対応するビットでアナンシエータのオン/オフを指定する。
        
);

解説

この関数が期待通りに動作するかは、特定のデバイスに完全に依存します。

参照

BREW API IDISPLAY_SetAnnunciators


SFBDisplay::SetClipRect
クリッピング長方形を設定します。
[ public ]
Void SetClipRect(
    SFXRectangleConstRef rect   // 設定するクリッピング長方形。
);

参照

BREW API IDISPLAY_SetClipRect | SFBDisplay::GetClipRect


SFBDisplay::SetColor
指定されたユーザー項目の色を設定します。
[ public ]
RGBVAL SetColor(
    AEEClrItem item    
// 色を変更するユーザー項目を指定する。
// このパラメータには、接頭辞 CLR_USER を持つ AEEClrItem 列挙の項目の1つを指定する。
        
    RGBVAL itemColor   
// item パラメータで指定した項目に関連付ける新しい色。
// このパラメータには、AEEClrItem enum の1 項目のインデックスかRGB値を指定する。
        
);
[ public ]
RGBVAL SetColor(
    AEEClrItem item                 
// 色を変更するユーザー項目を指定する。
// このパラメータには、接頭辞 CLR_USER を持つ AEEClrItem 列挙の項目の1つを指定する。
        
    SFXRGBColorConstRef itemColor   // item パラメータで指定した項目に関連付ける新しい色。
);

参照

BREW API IDISPLAY_SetColor | AEEClrItem


SFBDisplay::SetDestination
レンダリング先のビットマップを設定します。
[ public ]
SFCError SetDestination(
    SFBBitmapSmpConstRef bmpDest   
// レンダリングに使用する SFBBitmap インタフェースポインタ、
// または画面ビットマップに設定する場合はnull。
        
);

参照

BREW API IDISPLAY_SetDestination | SFBBitmap | SFBDisplay::GetDestination


SFBDisplay::SetFont
指定されたAEEFontの描画に使用するフォントを設定します。
[ public ]
SFBFontPtr SetFont(
    AEEFont font         // フォントを指定する。
    SFBFontPtr newFont   // SFBFont ポインタ。
);

解説

SFBFontPtr SetFont(AEEFont font, SFBFontPtr newFont); はスマートポインタを使用しません。 これにより、ユーザーはアプリケーション終了時に古いポインタをリストアできます。 アプリケーションは SetFont() に渡した後のフォントを解放してはいけません。 また、アプリケーションは返された SFBFont を解放するか、 より正しくは、アプリの終了時にリストアするために、古い SFBFont を保持するべきです。

使用例

// SetFont メソッドを使い、フォントを解放するサンプルコード

SFBFontPtr validFont;
// フォントの作成
...

// 作成したフォントを設定
SFBFontPtr oldFont = display->SetFont(AEE_FONT_NORMAL, validFont);

...

// 古いフォントを再設定
validFont = display->SetFont(AEE_FONT_NORMAL, oldFont);

// 作成したフォントはスマートポインタにアタッチすることで自動的に解放される
SFBFontSmp tmpFont;
tmpFont.Attach(validFont);

// Release() メソッドをスマートポインタにより呼び出すこともできる。

参照

BREW API IDISPLAY_SetFont


SFBDisplay::Update
デバイスビットマップに対して描画操作を行った後、 変更を表示ハードウェアに通知するために呼び出します。
[ public ]
Void Update(Void);

参照

BREW API IDISPLAY_Update


SFBDisplay::UpdateEx
デバイスビットマップに対して描画操作を行った後、 変更を表示ハードウェアに通知するために呼び出します。
[ public ]
Void UpdateEx(
    Bool defer   // 画面を即時に更新するか、後で更新するかを示すブールフラグ。
);

参照

BREW API IDISPLAY_UpdateEx