例 21.7. スマートポインタの使い方

// SFBHashSmp は SFBHash インターフェースを管理するスマートポインタ
// SFBHash::NewInstance 関数を使用して新しいインターフェースを作成する
SFBHashSmp hash(SFBHash::NewInstance(AEECLSID_MD5));

// インターフェースの呼び出し
hash->Restart();

// 使われなくなったインターフェースは自動的に解放される

例 21.8. コールバック関数を静的メンバ関数として定義・実装し、登録する方法

SFMTYPEDEFCLASS(Camera)
class Camera {
SFMSEALCOPY(Camera)

private:
    SFBCameraSmp _camera; // ICamera インターフェースのラッパークラス

public:
    SFCError Resume(Void);  // レジューム処理
    Void OnCamera(AEECameraNotify* notify);  // コールバック関数の実体
    static Void OnCameraSHP(VoidPtr reference, AEECameraNotify* notify);  // ダミーのコールバック関数 : 静的メンバ関数として定義する
};

#endif

// レジューム処理: カメラの基本的な初期化処理
SFCError Camera::Resume(Void)
{
    SFCError error(SFERR_NO_ERROR);
 
    // SFBCamera のインスタンスを取得する
    if ((_camera = SFBCamera::NewInstance()) != null) {     
    
        // ダミーのコールバック関数を登録する
        error = _camera->RegisterNotify(OnCameraSHP, this); 
        
        if (error == SFERR_NO_ERROR) {

            ...

        }
        
    // カメラのインスタンスを取得できなかった場合
    } else {
    
        error = SFERR_NO_MEMORY;   
    }
    
    if (error != SFERR_NO_ERROR) {
	
       // エラーが発生したとき
	   ...
    }
    return error;
}

// ダミーのコールバック関数
Void Camera::OnCameraSHP(VoidPtr reference, AEECameraNotify* notify)
{
    // 実際のコールバック関数を呼び出す
    static_cast<CameraPtr>(reference)->OnCamera(notify); 
    return;
}

// 実際のコールバック関数
Void Camera::OnCamera(AEECameraNotify* notify)
{
    switch (notify->nStatus) {
        case CAM_STATUS_START:  // カメラの起動が完了したとき
            ...
            break;
        case CAM_STATUS_FRAME:  // 新たなフレームを取得したとき
            ...
            break;
        case CAM_STATUS_DONE:   // 処理が完了したとき
            ...
            break;
        case CAM_STATUS_FAIL:   // 処理が失敗したとき
            ...
            break;
        case CAM_STATUS_ABORT:  // 処理を中止したとき
            ...
            break;
    }
    return;
}

	SFBCameraSmp インスタンス変数
	ダミーのコールバック関数を登録する SFBCameraSmp インスタンス変数 _camera は、Camera クラスのクラス変数として定義します。 _cameraを Camera::Resume 関数のローカル変数として定義した場合、 Camera::Resume 関数を終了した段階でスコープから外れるので、スマートポインタである _camera は解放されてしまいます。 その結果、ダミーのコールバック Camera::OnCameraSHP 関数は呼び出されなくなります。

例 21.9. コールバック関数を friend 関数として定義・実装し、登録する方法

SFMTYPEDEFCLASS(jpegreader)
class jpegreader : public SFYApplication {
    SFMSEALCOPY(jpegreader)

private:
    SFBImageSmp _image;  // IIMage インターフェースのラッパークラス

public:
    static SFCInvokerPtr Factory(Void);

private:
    explicit jpegreader(Void) static_throws;
    virtual ~jpegreader(Void);
    SFCError LoadImage(SFXPathConstRef path);
    SFCError ExampleDirectFile(SFXFilePtr file);  // ファイルストレージからイメージを読み込む
    SFCError ExampleThroughMemory(SFXFilePtr file, UInt32 size);  // メモリストレージからイメージを読み込む
    XANDLER_DECLARE_BOOLEVENT(OnKey)
    Void OnImage(Void);  // コールバック関数の実体
    friend Void read_finished(VoidPtr, IImage*, AEEImageInfo*, SIntN);  // ダミーのコールバック関数 : friend 関数として定義する
};


// コンストラクタ
jpegreader::jpegreader(Void) static_throws
{
    if (static_try()) {
        static_throw(RegisterHandler(
            SFXEventRange(SFEVT_KEY, SFEVT_KEY, SFP16_BEGIN, SFP16_END),
            XANDLER_INTERNAL(OnKey)
        ));
    }
    if (static_try()) {
        static_throw(LoadImage(SFXPath("version.jpg")));
    }
}

// デストラクタ
jpegreader::~jpegreader(Void)
{
}


// パスから JPEG 画像の読み込み
SFCError jpegreader::LoadImage(SFXPathConstRef path)
{
    SFXFile   file;
    UInt32    size;
    SFCError  error(SFERR_NO_ERROR);

    // SFBImage のインスタンスを取得する
    if ((_image = SFBImage::NewInstance(AEECLSID_JPEG, &error)) != null) {

        if ((error = file.OpenReadOnly(path)) == SFERR_NO_ERROR) {

            if ((error = file.GetSize(path, &size)) == SFERR_NO_ERROR) {

                // ファイルストレージからイメージを読み込む場合 
                // ExampleDirectFile(&file);

                // メモリストレージからイメージを読み込む場合 
                ExampleThroughMemory(&file, size); 
            }
        }
    }
    return error;
}

// ファイルストレージからイメージを読み込む
SFCError jpegreader::ExampleDirectFile(SFXFilePtr file)
{
    // ダミーのコールバック関数を登録する
    _image->Notify((PFNIMAGEINFO)read_finished, this);

    // ファイルストレージのストリームを設定する
    return _image->SetStream(*file);
}

// メモリストレージからイメージを読み込む
SFCError jpegreader::ExampleThroughMemory(SFXFilePtr file, UInt32 size)
{
    SFXBuffer  buffer;
    VoidPtr    ptr;
    SFXMemory  memory;
    SFCError   error(SFERR_NO_ERROR);

    if (size > 0) {

        if ((error = buffer.SetSize(size)) == SFERR_NO_ERROR) {

            ptr = buffer.Detach();

            if ((error = file->Read(ptr, &size)) == SFERR_NO_ERROR) {

                if ((error = buffer.Attach(ptr, size)) ==SFERR_NO_ERROR) {

                    if ((error = memory.Open(buffer)) == SFERR_NO_ERROR) {

                        // ダミーのコールバック関数を登録する
                        _image->Notify((PFNIMAGEINFO)read_finished, this);

                        // メモリストレージのストリームを設定する
                        error = _image->SetStream(memory);
                    }
                }
            }
        }
    }
    else {
        error = SFERR_FAILED;
    }
    return error;
}

// 実際のコールバック関数（実体: イメージを描画する）
Void jpegreader::OnImage(Void)
{
    SFXRectangle  rx;
    AEEImageInfo  info;

    rx.Set(GetLocalBound());

    _image->GetInfo(&info);

    // イメージを描画する
    _image->Draw((rx.GetWidth() - info.cx) / 2, (rx.GetHeight() - info.cy) / 2);

    return;
}

// ダミーのコールバック関数（PFNIMAGEINFO 型）
Void read_finished(VoidPtr reference, IImage* /* image*/, AEEImageInfo* /* info*/, SIntN /* error*/)
{
    // 実際のコールバック関数を呼び出す
    static_cast<jpegreaderPtr>(reference)->OnImage();

    return;
}

// キー ハンドラ
XANDLER_IMPLEMENT_BOOLEVENT(jpegreader, OnKey, invoker, event)
{
    unused(invoker);
    switch (event.GetP16()) {
        case AVK_SELECT:
            Terminate();
            return true;
    }
    return false;
}

	SFBImageSmp インスタンス変数
	ダミーのコールバック関数を登録する SFBImageSmp インスタンス変数 _image は、jpegreader クラスのクラス変数として定義します。 _image を jpegreader::LoadImage 関数のローカル変数として定義した場合、 jpegreader::LoadImage 関数を終了した段階でスコープから外れるので、スマートポインタである _image は解放されてしまいます。 その結果、ダミーのコールバック read_finished 関数は呼び出されません。

	コールバック関数
	上の例では、ダミーのコールバック read_finished関数は freind 関数として定義され、 実際に JPEG 画像を描画する処理（コールバック関数の実体）は、read_finished 関数から呼び出される jpegreader::OnImage 関数内に実装します。

例 21.10. IShell インターフェースの ISHELL_GetAppCopyright 関数

// BREW ネイティブ API
int ISHELL_GetAppCopyright(IShell* pIShell, AECHAR* pBuff, int nSize);

// BREW API 関数を単純にラップしたインライン関数
SInt32 SFBShell::GetAppCopyright(WCharPtr buf, SInt32 size);

// SophiaFramework UNIVERSE のクラスを引数とする関数
SInt32 SFBShell::GetAppCopyright(SFXWideStringPtr string);