C++ チートシート
======================

.. highlight:: cpp


このセクションは，cv::Mat を使ってユーザがやりたいと思う一般的な事柄に関する「チートシート」をまとめたものです．以下のコードスニペットでは，正しい名前空間が利用されていることを仮定しています：


 



::


    
    using namespace cv;
    using namespace std; 
     
    

..

IplImage や CvMat を cv::Mat に変換する，cv::Mat を IplImage や CvMat に変換する：

 



::


    
    // どこかで IplImage *iplimg; が宣言され，確保されており，
    // さらに cv::Mat Mimg が定義されていることを仮定しています．
    
     Mat img(iplimg);  // IplImage から Mat 画像 "img" を作成します．
     Mimg = iplimg;       // または，あらかじめ定義された cv::Mat Mimg ヘッダに
                          // iplimg のデータをセットします（コピーはされません）．
     
     // IplImage または CvMat への変換．データはコピーされません
     IplImage ipl_img = img;
     CvMat cvmat = img; // cv::Mat -> CvMat の変換
     
    

..

画像に対する矩形型の部分領域（ROI -- "Region of Interest"）を扱う簡単な方法：




::


    
     // 矩形を作成
     Rect roi(10, 20, 100, 50);
     // それを指す cv::Mat ヘッダ（メモリの確保はされません）
     Mat image_roi = image(roi);
    

..

多少高度になりますが，画像の円形領域から効率的にサンプリングしたいならば（以下では，サンプリングの代わりに BGR 画像への描画を行います）：






::


    
    // この関数は，それぞれの y に対する x の境界座標を出力します．
    // RxV[y1] = x1 は， y=y1 の場合に -x1 <=x<=x1 が円の内部
    // にあることを意味します．
    void getCircularROI(int R, vector < int > & RxV)
    {
        RxV.resize(R+1);
        for( int y = 0; y <= R; y++ )
            RxV[y] = cvRound(sqrt((double)R*R - y*y));
    }
    
    // 緑色の円を描画します
    // （ "[1]" は "BGR" 画像に対しての添字であり，
    // 青と赤のチャンネルは変更されないことに注意してください）．
    // これは，単に円領域からどのように「サンプリング」を行うかを示す例です．
    void drawCircle(Mat &image, int R, Point center)
    {
        vector<int> RxV;
        getCircularROI(R, RxV);
    
        Mat_<Vec3b>& img = (Mat_<Vec3b>&)image; // 画像の 3 チャンネルポインタ
        for( int dy = -R; dy <= R; dy++ )
        {
            int Rx = RxV[abs(dy)];
            for( int dx = -Rx; dx <= Rx; dx++ )
                img(center.y+dy, center.x+dx)[1] = 255;
        }
    }
    

..