cvui 开源项目安装及使用指南

凌霆贝

于 2024-08-08 07:19:54 发布

阅读量797

点赞数 14

本文链接：https://blog.csdn.net/gitblog_00846/article/details/141008236

版权

cvui 开源项目安装及使用指南

cvuiA (very) simple UI lib built on top of OpenCV drawing primitives项目地址:https://gitcode.com/gh_mirrors/cv/cvui

项目介绍

cvui 是一个基于OpenCV的轻量级UI库，它完全依赖于OpenCV的绘图原语进行渲染，无需复杂的图形后端如OpenGL或Qt的支持。cvui采用纯头文件形式，没有额外的外部依赖（除了对OpenCV的需求），提供友好且类C风格API，无需理解复杂的面向对象编程概念。此外，它支持组件在不关心具体位置的情况下轻松绘制（通过行和列布局），并提供了简单但强大的鼠标事件处理机制。

主要特性

轻量级和简单的用户界面
纯粹的OpenCV实现，无OpenGL/Qt要求
类C的API设计，不涉及复杂的数据结构
易于布局组件，无需精确位置设定
强大的鼠标交互功能
支持有限的UI组件集（共11种）
提供C++和Python版本，且均为纯粹实现而非绑定
极简构建流程，只需引入cvui.h即可

项目快速启动

为了能够使用cvui，你需要确保你的环境中已正确安装了OpenCV，因为它是唯一依赖项。下面是如何在C++环境中快速上手的例子：

#include <opencv2/opencv.hpp>

// 定义CVUI_IMPLEMENTATION前包括cvui.h以保证其实现编译
#define CVUI_IMPLEMENTATION
#include "cvui.h"

#define WINDOW_NAME "CVUI 示例"
int main()
{
    // 创建一个窗口用于显示组件
    cv::Mat frame = cv::Mat(200, 500, CV_8UC3);

    // 初始化cvui，创建一个OpenCV窗口
    cvui::init(WINDOW_NAME);
    
    while (true)
    {
        // 填充帧背景颜色
        frame = cv::Scalar(49, 52, 49);
        
        // 在帧上渲染UI组件
        cvui::text(frame, 110, 80, "你好，世界");

        // 显示更新后的窗口
        cv::imshow(WINDOW_NAME, frame);

        // 等待按键按下
        if(cv::waitKey(30))
            break;
    }

    return 0;
}

对于Python环境，类似地需要先安装OpenCV和cvui包，然后按以下方式导入并初始化：

import numpy as np
import cv2
from cvui import cvui

WINDOW_NAME = 'CVUI 示例'
frame = np.zeros((200, 500), dtype=np.uint8)

def main():
    cvui.init(WINDOW_NAME)
    while True:
        # 填充帧背景颜色
        frame.fill(0)
        
        # 在帧上渲染UI组件
        cvui.text(frame, 110, 80, "你好，世界")

        # 使用cvui自带的显示函数
        cvui.imshow(WINDOW_NAME, frame)
        
        # 检查退出条件
        if cv2.waitKey(30):
            break

if __name__ == "__main__":
    main()