MJPEG で画像を取得する (c++/Visual Studio)

本ページでは、i-PRO カメラとPCを MJPEG により接続してPC画面へ表示するプログラムを c++ (Visual Studio) で作成する例を紹介します。とても短いプログラムで i-PRO カメラの映像を見ることができます。動作確認は i-PRO mini (WV-S7130)、モジュールカメラ（AIスターターキット）を使って行いましたが、ほとんどの i-PRO カメラでそのまま利用できるはずです。ぜひお試しください。

1. MJPEG 表記仕様

MJPEG で接続するための表記を以下に記載します。

「ネットワークカメラCGIコマンドインターフェース仕様書統合版」[1] で下記に記載されている情報を元に加筆などしています。

「3.13 動画像取得(Motion JPEG 形式取得：リアルタイム) (nphMotionJpeg)」

http://<user-id>:<user-password>@<カメラのIPアドレス>/nphMotionJpeg?Resolution=<解像度>&Quality=<品質>&Framerate=<フレームレート>

(例) http://admin:password@192.168.0.10/nphMotionJpeg?Resolution=1920x1080&Quality=Standard&Framerate=15

注意事項

実験してみたところ、ストリーム(1)～(4) を On にしているとMJPEGの配信性能が落ちる様子です。フレームレートを例えば 15 と設定してもコマ落ちが多く発生しているように見えました。
カメラの設定にて、ストリーム(1)～(4)を Off、にすることで 30fps の動作もできているように見えます。
CGI のせっていでは "Framerate" の指定を必ず行った方が良さそうです。試しに Framerate 指定を行わなかったところ 0.2fps 程度の表示となりました。恐らくデフォルト値が 0.2fps ぐらいになっていると思われます。

2. i-PRO カメラと MJPEG 接続して映像を表示してみる

[概要]

Visual Studio の c++ と OpenCV を使って、PC と i-PRO カメラを MJPEG(Motion JPEG) で接続して映像表示してみます。

[評価環境]


コンパイラ :	Visual Studio 2022 pro.,	Version 17.4.4

ライブラリ :	OpenCV,	4.6.0

OS :	Windows11 home,	22H2

※ "Community edition" でも動作する内容です。

Check

OpenCV のインストール方法、Visual Studio プロジェクトへの設定方法などは下記ページを参考に行ってください。本ページでは説明を割愛します。

OpenCV をインストールする

[プログラム]

サンプルプログラムのソースコードを以下に示します。

プロジェクトを c++ の「コンソールアプリ」として作成します。
user_id, user_pw, host はあなたが使用するカメラの設定に従って変更してください。
プログラムを終了するときはキーボードから "q" キーを押す、またはコンソール上で [ctrl]+[c] してください。

[プログラムソース "connect_with_mjpeg_1.cpp"]

/*
======================================================================================

[Abstract]
    Try connecting to an i-PRO camera with Motion JPEG.
    Motion JPEG で i-PRO カメラと接続してみる

[Details]
    Let's try first.
    まずはやってみる

[Library install]
    opencv:     You need OpenCV. See "https://i-pro-corp.github.io/Programing-Items/cpp_vs/install_opencv.html"

======================================================================================
*/


#include <iostream>
#include <opencv2/opencv.hpp>
#include <opencv2/core/utility.hpp>


const std::string user_id    = "user_id";       // Change to match your camera setting
const std::string user_pw    = "user_pw";       // Change to match your camera setting
const std::string host       = "192.168.0.10";  // Change to match your camera setting
const std::string winname    = "VIDEO";         // Window title
const std::string resolution = "1920x1080";     // Resolution
const std::string framerate  = "15";            // Frame rate

const std::string url = "http://" + user_id + ":" + user_pw + "@" + host + "/cgi-bin/nphMotionJpeg?Resolution=" + resolution + "&Quality=Standard&Framerate=" + framerate ;

int main(int argc, const char* argv[])
{
    cv::VideoCapture cap(url);
    cv::Mat frame;
    char ret;

    while (true) {
        cap >> frame;
        if (frame.empty()) {
            break;
        }

        // Please modify the value to fit your PC screen size.
        resize(frame, frame, cv::Size(), 0.5, 0.5);                                     // Setting by magnification.

        // Display video.
        cv::imshow(winname, frame);

        ret = (char)cv::waitKey(1);     // necessary to display the video by cv::imshow().

        // Press the "q" key to finish.
        if (ret == 'q') {
            break;
        }
    }

    cap.release();
    cv::destroyAllWindows();

    return EXIT_SUCCESS;
}

上記プログラムを動かした様子を動画で示します。

こんなに簡単なプログラムでとても快適な映像表示を実現することができました。

[動画] MJPEG でカメラと接続して映像表示してみた様子（注意：ストリーム1～4 を全て Off に設定しています）

ライセンス

本ページの情報は、特記無い限り下記 MIT ライセンスで提供されます。

The MIT License (MIT)

Copyright 2023 Kinoshita Hidetoshi

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

2025/11/17	-	｢[1] ネットワークカメラCGIコマンドインターフェース仕様書｣リンク先を更新,	木下英俊
2023/10/20	-	IP簡単設定ソフトウェア、IP Setting Software リンク先を更新,	木下英俊
2023/3/1	-	説明および表現を一部更新,	木下英俊
2023/2/15	-	新規作成,	木下英俊