0. 開発環境

Raspberry Pi 2
raspbian
DFM 22BUC03-ML（the Imaging Source社製カメラ；これは，予めUVCモードにしておく．）

1. はじめに

http://qiita.com/ykatsu111/items/88d477ee970eda559264にも書いたが，Imaging Source社のUSB2.0カメラをLinux対応にすると，OpenCVで直接使ってキャプチャできなくなってしまうため，代わりにV4L2を使ってキャプチャし，そのデータをOpenCVに渡してやる必要がある．
しかし，V4L2 APIなんて使ったこともないうえに，ネット上には驚くほど情報が少なかったため，ここに行ったことをメモする．

ここでは，（Imaging Source社から？）既に提供されているサンプルプログラムを改変することで，キャプチャを行う．
このサンプルプログラムでは，単純にV4L2を使用してキャプチャしたデータを，OpenCVのIplImage構造体に渡すことでキャプチャを行っている．
しかし，IplImage構造体は古いOpenCVのデータ型で，現在ではMatクラスを用いるのが一般的である．
また，このサンプルでは，カメラの露出などの設定を行っていないため，これもできるようにする．

2. OpenCVのインストール

多くの人はOpenCVをソースコードからコンパイルされていますが，最新バージョンでなくてよければ，

sudo apt-get install libopencv-dev

でできます．なんたって楽なので，ここではこの方法でOpenCVをインストールしたRaspberry Piを開発環境とします．

3. V4L2のインストール

こちらも，apt-getから行えます．

sudo apt-get install libv4l-dev

以上．

4. v4ldevice.cppを露出設定可能なものに改変

ここで改変する関数は，void init_device(int width, int height)です．
以下改変したソースコード．
説明や追加した箇所はコメントに記入．

v4ldevice.cpp

void init_device ( int width, int height, int exposure) //改変（int exposure を追加）
{
    struct v4l2_capability cap;
    struct v4l2_cropcap cropcap;
    struct v4l2_crop crop;
    struct v4l2_format fmt;
    struct v4l2_queryctrl qctl; //追加
    struct v4l2_control control; //追加
    unsigned int min;

    if (-1 == xioctl(fd, VIDIOC_QUERYCAP, &cap))
    {
        if (EINVAL == errno)
        {
            fprintf(stderr,
                    "%s is no V4L2 device\n",
                    dev_name);
            exit(EXIT_FAILURE);
        }
        else
        {
            errno_exit("VIDIOC_QUERYCAP");
        }
    }

    if (!(cap.capabilities & V4L2_CAP_VIDEO_CAPTURE))
    {
        fprintf(stderr,
                "%s is no video capture device\n",
                dev_name);
        exit(EXIT_FAILURE);
    }

    switch (io)
    {
        case IO_METHOD_READ:
        {
            if (!(cap.capabilities & V4L2_CAP_READWRITE))
            {
                fprintf(stderr,
                        "%s does not support read i/o\n",
                        dev_name);
                exit(EXIT_FAILURE);
            }
            break;
        }
        case IO_METHOD_MMAP:
        case IO_METHOD_USERPTR:
        {
            if (!(cap.capabilities & V4L2_CAP_STREAMING))
            {
                fprintf(stderr, "%s does not support streaming i/o\n",
                        dev_name);
                exit(EXIT_FAILURE);
            }
            break;
        }
    }


    /* Select video input, video standard and tune here. */


    CLEAR(cropcap);

    cropcap.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;

    if (0 == xioctl(fd, VIDIOC_CROPCAP, &cropcap))
    {
        crop.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
        crop.c = cropcap.defrect; /* reset to default */

        if (-1 == xioctl(fd, VIDIOC_S_CROP, &crop))
        {
            switch (errno)
            {
                case EINVAL:
                    /* Cropping not supported. */
                    break;
                default:
                    /* Errors ignored. */
                    break;
            }
        }
    }
    else
    {
        /* Errors ignored. */
    }


    CLEAR(fmt);

    fmt.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
    if (force_format)
    {
        fmt.fmt.pix.width       = width;
        fmt.fmt.pix.height      = height;
        fmt.fmt.pix.pixelformat = V4L2_PIX_FMT_GREY;
        fmt.fmt.pix.field       = V4L2_FIELD_NONE;

        if (-1 == xioctl(fd, VIDIOC_S_FMT, &fmt))
            errno_exit("VIDIOC_S_FMT");

        /* Note VIDIOC_S_FMT may change width and height. */
    }
    else
    {
        /* Preserve original settings as set by v4l2-ctl for example */
        if (-1 == xioctl(fd, VIDIOC_G_FMT, &fmt))
            errno_exit("VIDIOC_G_FMT");
    }

    /* Buggy driver paranoia. */
    min = fmt.fmt.pix.width * 2;
    if (fmt.fmt.pix.bytesperline < min)
        fmt.fmt.pix.bytesperline = min;
    min = fmt.fmt.pix.bytesperline * fmt.fmt.pix.height;
    if (fmt.fmt.pix.sizeimage < min)
        fmt.fmt.pix.sizeimage = min;

    switch (io)
    {
        case IO_METHOD_READ:
            init_read(fmt.fmt.pix.sizeimage);
            break;

        case IO_METHOD_MMAP:
            init_mmap();
            break;

        case IO_METHOD_USERPTR:
            init_userp(fmt.fmt.pix.sizeimage);
            break;
    }

    //ここから追加箇所

    //Exposureの設定
    /*この部分のソースコードは，
    http://v4l.videotechnology.com/dwg/v4l2.html
    の1.8. Controls にあるサンプルを参考にした．
    以下にそのサンプルの一部をコピーしておく．
    このサンプルでは明るさの設定を行っている．
    struct v4l2_queryctrl queryctrl;
    struct v4l2_control control;
    memset (&queryctrl, 0, sizeof (queryctrl));
    queryctrl.id = V4L2_CID_BRIGHTNESS;

    if (-1 == ioctl (fd, VIDIOC_QUERYCTRL, &queryctrl)) {
        if (errno != EINVAL) {
                perror ("VIDIOC_QUERYCTRL");
                exit (EXIT_FAILURE);
        } else {
                printf ("V4L2_CID_BRIGHTNESS is not supported\n");
        }
   } else if (queryctrl.flags & V4L2_CTRL_FLAG_DISABLED) {
        printf ("V4L2_CID_BRIGHTNESS is not supported\n");
　} else {
        memset (&control, 0, sizeof (control));
        control.id = V4L2_CID_BRIGHTNESS;
        control.value = queryctrl.default_value;

        if (-1 == ioctl (fd, VIDIOC_S_CTRL, &control)) {
                perror ("VIDIOC_S_CTRL");
                exit (EXIT_FAILURE);
        }
　}
*/
    memset(&qctl, 0, sizeof(qctl));
    /*Exposureの設定で選べるIDはいくつかあり，
    https://www.linuxtv.org/downloads/legacy/video4linux/API/V4L2_API/spec-single/v4l2.html
    の1.9.6. Camera Control Reference に書いてあったものをまとめると，
    V4L2_CID_EXPOSURE_AUTO    露出と彩度を自動でおこなう．
    V4L2_CID_EXPOSURE_MANUAL    露出と彩度を手動で行う．
    V4L2_CID_EXPOSURE_SHUTTER_PRIORITY    露出を手動で，彩度を自動で行う．
    V4L2_CID_EXPOSURE_APERTURE_PRIORITY    露出を自動で，彩度を主導で行う．
    V4L2_CID_EXPOSURE_ABSOLUTE    露出時間を100μ秒単位で設定する．1が1/10000秒に，10000が１秒に，100000が１０秒にそれぞれ対応するる．
    ここでは，V4L2_CID_EXPOSURE_ABSOLUTEを選択する．
    */
    qctl.id = V4L2_CID_EXPOSURE_ABSOLUTE; 
    if (-1 == xioctl(fd, VIDIOC_QUERYCTRL, &qctl)) {
        if (errno != EINVAL) {
            perror("VIDIOC_QUERYCTRL");
            exit(EXIT_FAILURE);
        } else {
            fprintf(stderr, "V4L2_CID_EXPOSURE_ABSOLUTE is not surported\n");
        }
    } else if (qctl.flags & V4L2_CTRL_FLAG_DISABLED) {
        fprintf(stderr, "V4L2_CID_EXPOSURE_ABSOLUTE is not surported\n");
    } else {
        memset(&control, 0, sizeof(control));
        control.id = V4L2_CID_EXPOSURE_ABSOLUTE;
        control.value = exposure;
        if (-1 == xioctl(id, VIDIOC_S_CTRL, &control)) {
            perror("VIDIOC_S_CTRL");
            exit(EXIT_FAILURE);
        }
    }

    //ここまで追加箇所
}

5. main.cpp の作成

ここでは，bayerデータで受信したキャプチャデータをRGBに変換して，表示するまでのプログラムを示す．
また，元プログラムで使用していたIplImage構造体をMatクラスに置き換える．
なお，ここで示すプログラムは自分で書きなおした．

main.cpp

#define Esc 27

#include <opencv2/opencv.hpp>
#include <iostream>
#include "v4ldevice.h"

int main(int argc, char** args) {
    //カメラの初期化
    open_device("/dev/video0"); //ここは，PCに接続したカメラの場所を指定する．１台しか接続しない場合は，通常は0番にカメラは接続されるので，このパスとなる．
    init_device(640, 480, 300); //キャプチャするサイズと露出を指定する．

    //キャプチャの開始
    start_capturing();

    //バッファーとMatクラスの準備
    unsigned char* ImageBuffer = NULL;
    cv::Mat src(480, 640, CV_8UC1); //8-bit, 1チャンネルのMatクラスを用意する．配列のサイズはカメラ初期化で指定したものと同じサイズにするが，widthとheightが逆になるので，注意する．もしも逆にすると，表示される映像は縦に幾つか割れ目の入ったような映像となる．
    cv::Mat dst; //bayer変換後のデータを格納するMatクラスを用意する．

    cv::namedWindow("image", CV_WINDOW_AUTOSIZE);
    while (true) {

        //キャプチャ
        ImageBuffer = snapFrame();
        if (ImageBuffer != NULL) {
            memcpy(src.data, ImageBuffer, src.step * src.rows); //バッファーをMatクラスに受け渡す．
            cvtColor(src, dst, CV_BayerGB2RGB); //ここがBayer変換
        } else {
            std::cerr << "no image buffer retrieved!" << std::endl;
        }
        cv::imshow("image", dst);
        if (cv::waitKey(1) == Esc) {
            cv::destroyAllWindows();
            break;
        }
    }

}

プログラムを動かすと，こんな感じでちゃんとキャプチャできました．
めでたしめでたし．
（と思ったら画像アップロードの容量制限引っかかっちゃった．．．）

参考になったWebページ

サンプルのコピー（おまけ）

非常に貴重なサンプルプログラムなので，コピーさせていただきました．
https://gist.github.com/TIS-Edgar/10f04501f49b6b3bf75e