月: 2014年5月

今日は，cv::InputArray/cv::OutputArrayを入出力とする簡単な関数の作り方．
はじめ使い方がよくわからなかったので効率の悪い使い方をしていた．
まずはそれの紹介から．
例えば，全要素に1足す関数 plus1(cv::InputArray in, cv::OutputArray out) を作るとする．

void plus1(cv::InputArray in, cv::OutputArray out){
    cv::Mat img=in.getMat();
    cv::Mat pls=img+1;
    pls.copyTo(out);
}

cv::OutputArrayには直接代入が出来ないので，copyToを使ってコピーしていた．
ただし，処理の最後にOpenCVに入っている関数を呼び出すのであればこれで良い．
例えば

void fliteredplus1(cv::InputArray in, cv::OutputArray out){
    cv::Mat img=in.getMat();
    cv::Mat pls=img+1;
    cv::medianBlur(pls, out, 3);

こんな感じであれば問題ない…と思う．
で，正しい（最後にOpenCVの関数を呼び出さない場合の）使い方は次回．

前回，cv::InputArray/cv::OutputArrayについて書いたが，今回はcv::InputArrayを入力とする関数の作り方について書く．
cv::InputArrayで受け取ったものは，中身はcv::Matやstd::vectorだがそのままでは使えない．
cv::InputArrayのkind()という関数を使うことで，もともと何型だったのかを知ることができる．
使えるのは，
MAT
MATX
STD_VECTOR
STD_VECTOR_VECTOR
STD_VECTOR_MAT
EXPR
OPENGL_BUFFER
OPENGL_TEXTURE
GPU_MAT
OCL_MAP
使うときは，cv::InputArrayクラスのgetMat()やgetMatVector()を呼び出し，cv::Matやstd::vector型に変換して使う．

void showImg(cv::InputArray in){
    cv::Mat img=in.getMat();
    // 以降，元がstd::vectorだろうとcv::Matとして使える
    cv::imshow("img",img);
    cv::waitKey();
}

getMatVector()の方は，cv::Matの配列になるので，

void printImgs(cv::InputArray in){
    std::vector<cv::Mat> imgs;
    in.getMatVector(imgs);
    for(auto img: imgs){
        std::cout << img << std::endl;
    }
}

という感じで使える．上記関数にcv::Matを渡すと，各行からなるcv::Matが配列に格納され，行ごとに画面に出力される．

OpenCVの新しいバージョン(3.0)では，様々なところで変更があって，いろんなアルゴリズムが入出力としてcv::InputArrayとcv::OutputArrayを使うようになっている．
cv::InputArray/cv::OutputArrayは，std::vectorやcv::Matやstd::vectorなどを統一的に扱えるようにしたもの．
なので，例えば cv::threshold だと，cv::Matを入力として

cv::Mat img, out;
cv::threshold(img, out, 10, 255, cv::THRESH_BINARY);

このように使ったり，std::vectorを入力として

std::vector<double> img;
cv::Mat out;
cv::threshold(img, out, 10, 255, cv::THRESH_BINARY);

このように使うことができる．
また，受け取る側のcv::OutputArrayも同様なので，先ほどの例だと受け取る側を

cv::Mat img;
std::vector<unsigned char> out;
cv::threshold(img, out, 10, 255, cv::THRESH_BINARY);

のようにstd::vectorにしたりもできる．
次回はこのようなcv::InputArray/cv::OutputArrayを入出力とする関数を自作する方法について書く．