ユーティリティとシステム関数，マクロ¶

Error Handling¶

OpenCV のエラーハンドリングは，IPL（Image Processing Library）の場合と似ています．エラーが発生した場合でも，関数はエラーコードを返しません．その代わりに， Error を呼び出すマクロ CV_ERROR を用いてエラーを発生させます．その中で， SetErrStatus によりエラー状態をセットし，標準あるいはユーザ定義のエラーハンドラ（メッセージボックスを表示したり，ログを書き出したりできます．詳しくは， RedirectError を参照してください）を呼び出します．1スレッドに1つ，現在のエラー状態（整数値）を保存するグローバル変数が存在します．このエラー状態は，関数 GetErrStatus によって取得できます．

エラーハンドリングには3つのモードが存在します（ SetErrMode および GetErrMode を参照してください）：

Leaf . エラーハンドラを呼び出した後に，プログラムが終了します．これはデフォルト値です．エラーが発生すると即座に通知されるので，デバッグ時に役立ちます．しかし，製品版のシステムでは，より細かく制御可能な他の2つのモードの方が適しているかもしれません．
Parent . エラーハンドラは呼ばれますが，プログラムは終了しません．また，（C++の例外処理を利用しないので）スタックは巻き戻されません．ユーザは， CxCore の関数を呼び出した後で， GetErrStatus を用いてエラーコードをチェックし，対処を行います．
Silent . これは Parent モードと似ていますが，エラーハンドラが呼ばれません．

実際は， Leaf モードと Parent モードの動作は，エラーハンドラによって実装され，これらは上述の説明通りの挙動を示します．しかし GuiBoxReport の場合は多少挙動が異なり，全く異なる動作を実装するカスタムエラーハンドラも存在します．

エラーの発生やチェックなどを行うマクロ．

/* 関数内の処理文を挟むことで，それらをプロローグ（リソースの初期化）と
   エピローグ（確保されたリソースの解放）から分離する特別なマクロ */
#define __BEGIN__       {
#define __END__         goto exit; exit: ; }
/* 「リソース解放ステージ」へ進みます */
#define EXIT            goto exit

/* CV_ERROR() で使用する関数名をローカルに定義します */
#define CV_FUNCNAME( Name )  \
    static char cvFuncName[] = Name

/* 現在のコンテクスト内でのエラーを発生させます */
#define CV_ERROR( Code, Msg )                                       \


/* CXCORE の関数呼び出しの後の状態をチェックします */
#define CV_CHECK()                                                  \


/* CXCORE の関数呼び出しと CV_CHECK() 呼び出しの簡略表現です */
#define CV_CALL( Statement )                                        \


/* デバッグモードとリリースモード両方に対応した状態チェックを行います */
#define CV_ASSERT( Condition )                                          \


/* これらのマクロは，それぞれ対応するマクロ CV_... と似ていますが，
   exit ラベルを必要とせず，cvFuncName も定義されている必要がありません */
#define OPENCV_ERROR(status,func_name,err_msg) ...
#define OPENCV_ERRCHK(func_name,err_msg) ...
#define OPENCV_ASSERT(condition,func_name,err_msg) ...
#define OPENCV_CALL(statement) ...

詳細を説明する代わりに，代表的なCXCOREの関数とその使用方法を以下に示します．

Example: Use of Error Handling Macros¶

#include "cxcore.h"
#include <stdio.h>

void cvResizeDCT( CvMat* input_array, CvMat* output_array )
{
    CvMat* temp_array = 0; // 最後には解放されるべきポインタの宣言

    CV_FUNCNAME( "cvResizeDCT" ); // cvFuncName の宣言

    __BEGIN__; // 処理の開始．このマクロの直後に何らかの宣言があるとしても，
               // それらは，エピローグ部からはアクセスできません．

    if( !CV_IS_MAT(input_array) || !CV_IS_MAT(output_array) )
        // エラーを発生させるために CV_ERROR() を利用します．
        CV_ERROR( CV_StsBadArg,
        "input_array or output_array are not valid matrices" );

    // 後のバージョンでは撤廃されるだろう制約条件について，
    // CV_ASSERT() を用いてチェックします．
    CV_ASSERT( input_array->rows == 1 && output_array->rows == 1 );

    // 安全な関数呼び出しのために CV_CALL を利用します．
    CV_CALL( temp_array = cvCreateMat( input_array->rows,
                                       MAX(input_array->cols,
                                       output_array->cols),
                                       input_array->type ));

    if( output_array->cols > input_array->cols )
        CV_CALL( cvZero( temp_array ));

    temp_array->cols = input_array->cols;
    CV_CALL( cvDCT( input_array, temp_array, CV_DXT_FORWARD ));
    temp_array->cols = output_array->cols;
    CV_CALL( cvDCT( temp_array, output_array, CV_DXT_INVERSE ));
    CV_CALL( cvScale( output_array,
                      output_array,
                      1./sqrt((double)input_array->cols*output_array->cols), 0 ));

    __END__; // 処理の終了．エピローグはこのマクロの後に書きます．

    // temp_array を解放します．
    // エラー発生前に temp_array が確保されていない場合，
    // cvReleaseMat が適切に処理を行います．今回のような場合は，特にに何もしません．
    cvReleaseMat( &temp_array );
}

int main( int argc, char** argv )
{
    CvMat* src = cvCreateMat( 1, 512, CV_32F );
#if 1 /* エラーなし */
    CvMat* dst = cvCreateMat( 1, 256, CV_32F );
#else
    CvMat* dst = 0; /* エラー処理のテスト用 */
#endif
    cvSet( src, cvRealScalar(1.), 0 );
#if 0 /* エラーハンドラを起動しないようにするためには 0 から 1 へ変更してください */
    cvSetErrMode( CV_ErrModeSilent );
#endif
    cvResizeDCT( src, dst ); // エラーが発生した場合，
                             // メッセージボックスがポップアップするか，
                             // メッセージがログに書き込まれるか，
                             // あるいはユーザー定義の処理が行われます．
    if( cvGetErrStatus() < 0 )
        printf("Some error occured" );
    else
        printf("Everything is OK" );
    return 0;
}

param allocFunc:
	メモリ割り当て関数．そのインタフェースは，コンテクストを決定するためなどに使用される `userdata` を除けば， `malloc` と同様です．
param freeFunc:	メモリ解放関数．そのインタフェースは， `free` と同様です．
param userdata:	カスタム関数に引数としてそのまま渡されるユーザデータ．

param create_header:
	iplCreateImageHeader へのポインタ．
param allocate_data:
	iplAllocateImage へのポインタ．
param deallocate:
	iplDeallocate へのポインタ．
param create_roi:
	iplCreateROI へのポインタ．
param clone_image:
	iplCloneImage へのポインタ．

ナビゲーション

ユーティリティとシステム関数，マクロ¶

Error Handling¶

Example: Use of Error Handling Macros¶

GetErrStatus¶

SetErrStatus¶

GetErrMode¶

SetErrMode¶

Error¶

ErrorStr¶

RedirectError¶

cvNulDevReport cvStdErrReport cvGuiBoxReport¶

Alloc¶

Free¶

GetTickCount¶

GetTickFrequency¶

RegisterModule¶

GetModuleInfo¶

UseOptimized¶

SetMemoryManager¶

SetIPLAllocators¶

ヘルプとフィードバック

目次

このページ

クイック検索

ナビゲーション