영상 모니터링 API¶

oasis::ui 네임스페이스 범주에서 호출됩니다.

헤더 파일¶

OasisPreview.h

PreviewFrameObserver 인터페이스¶

Preview 객체에 setPreviewFrameObserver 함수를 이용하여 PreviewFrameObserver에서 유도된 사용자 정의 observer 객체를 지정할 수 있습니다.

응용 프로그램은 onFrame 콜백 함수를 통해 화면에 보여지는 영상 프레임을 얻을 수 있습니다.

class PreviewFrameObserver : public std::enable_shared_from_this<PreviewFrameObserver>
{
public:
    PreviewFrameObserver();
    virtual ~PreviewFrameObserver();
    virtual void onFrame(int32_t camera_id, uint8_t *frame, int32_t stride_width, int32_t width, int32_t height);
    virtual void onNoMediaData(int32_t camera_id);
};

영상 프레임 포맷이 YUV420인 경우, 아래와 같은 수식으로 Y,U,V 채널을 얻을 수 있습니다.

uint8_t *y = frame;
uint8_t *u = frame + stride_width * height;
uint8_t *v = u + stride_width * height / 4;

함수¶

각 영상 채널에 대한 key-value map 값은 각 키값 앞에 prefix로 channel<N>- 이 붙습니다. <N>은 1부터 시작하여 1씩 증가합니다.

​

예제¶

아래는 카메라 장치 ID 0 영상을 모니터링하는 예입니다.

Oasis를 초기화 합니다.

// 파일시스템을 사용하지 않습니다.

oasis::key_value_map_t parameters;

parameters["offs-disable"] = "1";

if(oasis::initialize(parameters) < 0) {
    DLOG(DLOG_ERROR, "Oasis init failed\n");
    return -1;
}

카메라 장치를 초기화 합니다. 여기서는 카메라 장치 한개를 사용합니다.

parameters.clear();

parameters["source-count"] = "1";

parameters["source1-camera-id"] = "0";
parameters["source1-isp-id"] = "0";
parameters["source1-isp-wdr-mode"] = "0";
parameters["source1-capture-format"] = "YUV420";
parameters["source1-capture-buffers"] = "5";
parameters["source1-fps"] = "30";
parameters["source1-subchannel-rotation"] = "0";
parameters["source1-loc"] = "front";
parameters["source1-capture-resolution"] = "1080p";
parameters["source1-sensor-config"] = "./Resource_tp2863/VIC/0/tp2863_1920x1080_ch0.cfg";
parameters["source1-autoscene-config"] = "./Resource_tp2863/AutoScene/autoscene_conf.cfg";
parameters["source1-resource-dir"] = "./Resource_tp2863/";

configCameras(parameters);  

디스프레이 장치를 초기화 합니다.

parameters.clear();

parameters["memory-type"] = "ion"; //cma
parameters["screen-width"] = "480";
parameters["screen-height"] = "320";

display::setup(parameters);

GUI를 설정합니다. 여기 예에서는 터치를 사용하지 않습니다.

parameters.clear();

parameters["system-font-size"] = "10";
parameters["system-font-path"] = "/mnt/sd/consola.ttf";
parameters["display-rotation"] = "0";
parameters["enable-touch"] = "0";

err = ui::setup(parameters);
if (err < 0) {
    DLOG(DLOG_ERROR, "Oasis ui::setup failed\n");
    return -1;
}

Preview 객체를 초기화 합니다.

parameters.clear();

// 기본 스크린 객체를 얻고 너비와 높이를 미디어플레이어에 적용합니다.
ui::ScreenRef screen = ui::getDefaultScreen();

int32_t screen_width = ui::screenWidth(screen);
int32_t screen_height = ui::screenHeight(screen);


// ui::PreviewFrameObserver 에서 유도된 사용자 정의 객체를 생성합니다.
std::shared_ptr<MyPreviewFrameObserver> observer = std::make_shared<MyPreviewFrameObserver>();

parameters["channel-count"] = "1";
parameters["primary-channel"] = "1";

parameters["channel1-camera-id"] = std::to_string(camera_id);
parameters["channel1-visible"] = "1";
parameters["channel1-rotation"] = std::to_string(rotation);
// 재생 화면을 전체 스크린으로 지정합니다.
parameters["channel1-x"] = "0";
parameters["channel1-y"] = "0";
parameters["channel1-width"] = std::to_string(screen_width);
parameters["channel1-height"] = std::to_string(screen_height);
parameters["channel1-zorder"] = "0";

ui::PreviewRef preview = ui::createPreview(0, parameters);
ui::setPreviewFrameObserver(preview, observer);

화면을 구성합니다. 최상위 Window 객체에 Fixed 레이아웃 컨테이너를 이용하고, 영상화면은 전체화면으로 설정합니다.

ui::WindowRef preview_panel = ui::createWindow("Preview1");
//ASSERT(preview_panel != nullptr);

ui::FixedRef fixed_layout = ui::createFixed();
ui::containerAdd(preview_panel, fixed_layout);

ui::setFixedSize(preview, screen_width, screen_height);
ui::fixedPut(fixed_layout, preview, 0, 0);
ui::screenAdd(screen, preview_panel);

ui::setVisible(preview_panel, true);

모니터링을 시작합니다.

ui::previewStart(preview);

재생 중 화면 위치를 변경하는 예입니다.

ui::previewSetPos(preview, 0, 100, 100)

모니터링을 중지합니다.

ui::previewStop(preview);

아래는 전체 코드입니다.

#include "OasisAPI.h"
#include "OasisLog.h"
#include "OasisMedia.h"
#include "OasisUI.h"
#include "OasisFS.h"
#include "OasisUtil.h"
#include "OasisDisplay.h"

#include <sys/types.h>
#include <sys/stat.h>
#include <unistd.h>
#include <dirent.h>

#include <signal.h>

#include <thread>
#include <mutex>
#include <memory>
#include <condition_variable>

using namespace oasis;


static bool continue_previewing = true;

void cancel_handler(int signum)
{
    continue_previewing = false;
}

class MyPreviewFrameObserver : public ui::PreviewFrameObserver {
public:
    MyPreviewFrameObserver() {}
    virtual ~MyPreviewFrameObserver() {}

    virtual void onFrame(int32_t camera_id, uint8_t *frame, int32_t stride_width, int32_t width, int32_t height) {
    }
    virtual void onNoMediaData(int32_t camera_id) {
        fprintf(stdout, "no media: camera<%d>\n", camera_id);
    }
};

void printUsage(const char *pgname)
{
    fprintf(stderr, "USAGE: %s [-r <rotation. 90, 270>] <camera id>\n", pgname);
}

int main(int argc, char *argv[])
{
    int32_t err;
    int c;
    int32_t rotation = 0;
    int32_t camera_id = -1;

    opterr = 0;
    while ((c = getopt(argc, argv, "r:h")) != -1) {
        switch (c) {
        case 'r':
            if(optarg == nullptr) {
                fprintf(stderr, "error: bad option argument '%c'\n", optopt);
                return -1;
            }
            rotation = atoi(optarg);
            if(rotation != 0 && rotation != 90 /*&& rotation != 180*/ && rotation != 270) {
                fprintf(stderr, "bad rotation: %d\n", rotation);
                return -1;
            }
            break;
        case 'h':
        default:
            printUsage(argv[0]);
            return -1;
        }
    }

    if(argc-optind < 1) {
        fprintf(stderr, "error: invalid or insufficient arguments (%d, %d)\n", argc, optind);
        printUsage(argv[0]);
        return -1;
    }

    camera_id = atoi(argv[optind]);
    if(camera_id < 0) {
        fprintf(stderr, "invalid camera id: %d\n", camera_id);
        return -1;
    }


    signal(SIGINT, cancel_handler);

    oasis::key_value_map_t parameters;

    ////////////////////////////////////////////////////////////////////////////////////////////
    // init

    parameters["offs-disable"] = "1";

    if(oasis::initialize(parameters) < 0) {
        DLOG(DLOG_ERROR, "Oasis init failed\n");
        return -1;
    }

    ////////////////////////////////////////////////////////////////////////////////////////////
    // camera sources
    parameters.clear();

    parameters["source-count"] = "1";

    parameters["source1-camera-id"] = "0";
    parameters["source1-isp-id"] = "0";
    parameters["source1-isp-wdr-mode"] = "0";
    parameters["source1-capture-format"] = "YUV420";
    parameters["source1-capture-buffers"] = "5";
    parameters["source1-fps"] = "30";
    parameters["source1-subchannel-rotation"] = "0";
    parameters["source1-loc"] = "front";
    parameters["source1-capture-resolution"] = "1080p";
    parameters["source1-sensor-config"] = "./Resource_tp2863/VIC/0/tp2863_1920x1080_ch0.cfg";
    parameters["source1-autoscene-config"] = "./Resource_tp2863/AutoScene/autoscene_conf.cfg";
    parameters["source1-resource-dir"] = "./Resource_tp2863/";

    configCameras(parameters);  

    ////////////////////////////////////////////////////////////////////////////////////////////
    // display setup
    parameters.clear();

    parameters["memory-type"] = "ion"; //cma
    parameters["screen-width"] = "480";
    parameters["screen-height"] = "320";

    display::setup(parameters);


    //////////////////////////////////////////////////////////////////////////////////////////
    // ui setup
    parameters.clear();

    parameters["system-font-size"] = "10";
    parameters["system-font-path"] = "/mnt/sd/consola.ttf";

    parameters["display-rotation"] = "0";
    parameters["enable-touch"] = "0";

    err = ui::setup(parameters);
    if (err < 0) {
        DLOG(DLOG_ERROR, "Oasis ui::setup failed\n");
        return -1;
    }

    /////////////////////////////////////////////////////////////////////////
    // create preview and layout

    ui::ScreenRef screen = ui::getDefaultScreen();
    //ASSERT(screen != nullptr);

    int32_t screen_width = ui::screenWidth(screen);
    int32_t screen_height = ui::screenHeight(screen);


    parameters.clear();


    //preview_panel
    ui::WindowRef preview_panel = ui::createWindow("Preview1");
    //ASSERT(preview_panel != nullptr);

    ui::FixedRef fixed_layout = ui::createFixed();
    ui::containerAdd(preview_panel, fixed_layout);

    std::shared_ptr<MyPreviewFrameObserver> observer = std::make_shared<MyPreviewFrameObserver>();

    parameters["channel-count"] = "1";
    parameters["primary-channel"] = "1";

    parameters["channel1-camera-id"] = std::to_string(camera_id);
    parameters["channel1-visible"] = "1";
    parameters["channel1-rotation"] = std::to_string(rotation);
    parameters["channel1-x"] = "0";
    parameters["channel1-y"] = "0";
    parameters["channel1-width"] = std::to_string(screen_width);
    parameters["channel1-height"] = std::to_string(screen_height);
    parameters["channel1-zorder"] = "0";

    ui::PreviewRef preview = ui::createPreview(0, parameters);
    ui::setPreviewFrameObserver(preview, observer);

    ui::setFixedSize(preview, screen_width, screen_height);
    ui::fixedPut(fixed_layout, preview, 0, 0);
    ui::screenAdd(screen, preview_panel);

    ui::setVisible(preview_panel, true);

    ui::previewStart(preview);

    do {
        usleep(100000);
    } while (continue_previewing);

    ui::previewStop(preview);

    err = ui::cleanup();

    oasis::finalize();

    return 0;
}