视频监控平台-OSD源代码解释和分享：通过大华SDK设置大华设备的OSD

一、OSD介绍

（一）OSD的定义

（二）OSD的设置

1、自定义文本

2、图标和符号

3、定位和叠加

二、代码和解释

（一）代码和注释

（二）代码解释

1、概述

2、代码详细解释

一、OSD介绍

（一）OSD的定义

网络摄像机的OSD（On-Screen Display）定义为在视频输出上叠加文本、图形、图像等信息的显示技术。它主要用于为摄像头用户提供实时的操作反馈、设置信息以及其他重要数据。

通过OSD设置，用户可以自定义要显示在视频画面上的内容，如日期、时间、摄像头分辨率、帧率、亮度、对比度等。这些设置允许用户根据具体需求调整摄像机的输出内容，从而提高监控视频的可读性和可用性。

（二）OSD的设置

网络摄像机的OSD设置允许用户自定义和显示在摄像机视频画面上的各种信息或图标。这些设置通常用于增强摄像机的功能和用户体验。以下介绍OSD设置的一些常见选项。

1、自定义文本

用户可以在OSD设置中定义要显示在视频画面上的文本信息，如日期、时间、位置标识符、摄像机名称等。这有助于在查看监控视频时快速识别摄像机的位置和记录的时间。

2、图标和符号

OSD设置还允许用户添加各种图标和符号，如移动侦测图标、警报状态图标等。这些图标可以直观地显示摄像机的状态或功能，使用户更容易理解。

3、定位和叠加

用户可以通过OSD设置调整文本和图标的位置、大小、颜色等属性，以确保它们不会遮挡视频画面中的重要信息。此外，一些高级OSD设置还支持文本和图标的叠加效果，可以将多个信息项组合在一起显示。

二、代码和解释

（一）代码和注释

以下部分C++代码是用于设置视频流的OSD（On Screen Display，屏幕显示）信息，如用户名等。具体如下：

/***************************************************************************

    // 设置OSD的函数
    // 参数：
    //   bStart：是否开始显示OSD
    //   LoginID：登录ID
    //   channelid：通道ID
    //   pExtPtzInfo：指向TExtPtzInfo结构的指针，可能包含用户名等信息

*****************************************************************************/



int CNetSdkForDaHua::SetOSD(bool bStart, long LoginID, int channelid, TExtPtzInfo* pExtPtzInfo)
{

    if(m_bIsSetOSD == false)
        return 0;
    // 如果m_bIsSetOSD标志为false，则不执行任何操作并返回
    NET_OSD_CUSTOM_TITLE g_stCustomTitle; // 定义OSD自定义标题结构体
    NET_OSD_CUSTOM_TITLE_TEXT_ALIGN g_stTextAlign; // 定义OSD文本对齐结构体
    int channel = channelid - 1; // 通道ID减1，因为通常ID从0开始

    // 获取
    g_stCustomTitle.dwSize = sizeof(g_stCustomTitle); // 设置结构体大小
    g_stCustomTitle.emOsdBlendType = NET_EM_OSD_BLEND_TYPE_MAIN; // 设置OSD混合类型为主
    bool r = CLIENT_GetConfig(LoginID, NET_EM_CFG_CUSTOMTITLE, channel, &g_stCustomTitle, sizeof(g_stCustomTitle)); // 获取配置

    if (r == false)
    {
        DBGPrint(M_DevCtrl, ERROR_LEVEL,"%s fail: error = %llu", __FUNCTION__, _EC(CLIENT_GetLastError())); // 如果获取失败，打印错误信息
        return  -1; // 返回-1表示错误
    }

    g_stCustomTitle.nCustomTitleNum = dahuuseindex + 1; // 设置自定义标题编号
    g_stCustomTitle.dwSize = sizeof(g_stCustomTitle); // 重新设置结构体大小
    if (bStart)
    {
        // 设置
        char szOSDString[DH_VIDEO_OSD_NAME_NUM] = {0}; // 初始化OSD字符串数组
        int iUserNameLength = pExtPtzInfo->UserName.size(); // 获取用户名长度
        if(iUserNameLength <= 0)
        {
            memset(szOSDString, 0, sizeof(szOSDString)); // 如果用户名为空，将OSD字符串数组设置为空

        }
        else
        {

            strncpy(szOSDString, pExtPtzInfo->UserName.c_str(), DH_VIDEO_OSD_NAME_NUM-1); // 否则，复制用户名到OSD字符串
            // 以下注释掉的代码可能是另一种格式化用户名的方式
            // snprintf(szOSDString, DH_VIDEO_OSD_NAME_NUM-1, "用户：%s",pExtPtzInfo->UserName.c_str());

        }

        char OSDOutBuf[DH_VIDEO_OSD_NAME_NUM] = {0}; // 初始化OSD输出缓冲区
        CCodeConvertMgr::CodeConverterToUTF8((unsigned char*)szOSDString,strlen(szOSDString), (unsigned char*)OSDOutBuf, sizeof(OSDOutBuf)); // 将UTF-8转换为另一种编码

        g_stCustomTitle.stuCustomTitle[dahuuseindex].bEncodeBlend = true; // 设置编码混合为真
        g_stCustomTitle.stuCustomTitle[dahuuseindex].stuRect.nLeft = 0; // 设置文本左边界为0
        g_stCustomTitle.stuCustomTitle[dahuuseindex].stuRect.nTop = 6500; // 设置文本顶部边框为6500（可能是像素值）
        g_stCustomTitle.stuCustomTitle[dahuuseindex].stuRect.nRight = 0; // 设置文本右边界为0
        g_stCustomTitle.stuCustomTitle[dahuuseindex].stuRect.nBottom = 6500; // 设置文本底部边框为6500（可能是像素值）
        strcpy(g_stCustomTitle.stuCustomTitle[dahuuseindex].szText, OSDOutBuf); // 将转换后的UTF-8字符串复制到OSD文本缓冲区
    }

    else
    {
        // 如果不启动OSD，则重置相关参数
        g_stCustomTitle.stuCustomTitle[dahuuseindex].stuRect.nLeft = 0; // 设置文本左边界为0
        g_stCustomTitle.stuCustomTitle[dahuuseindex].stuRect.nTop = 6500; // 设置文本顶部边框为6500（可能是像素值）
        g_stCustomTitle.stuCustomTitle[dahuuseindex].stuRect.nRight = 0; // 设置文本右边界为0
        g_stCustomTitle.stuCustomTitle[dahuuseindex].stuRect.nBottom = 6500; // 设置文本底部边框为6500（可能是像素值）
        g_stCustomTitle.stuCustomTitle[dahuuseindex].bEncodeBlend = false; // 设置编码混合为假
    }

    // 设置配置
    r = CLIENT_SetConfig(LoginID, NET_EM_CFG_CUSTOMTITLE, channel, &g_stCustomTitle, sizeof(g_stCustomTitle)); // 应用配置
    if (r == false)
    {

        DBGPrint(M_DevCtrl, ERROR_LEVEL,"%s fail: error = %lu", __FUNCTION__, _EC(CLIENT_GetLastError())); // 如果设置失败，打印错误信息
        return -1; // 返回-1表示错误
    }

    // 获取文本对齐信息
    g_stTextAlign.dwSize = sizeof(g_stTextAlign); // 设置结构体大小
    r = CLIENT_GetConfig(LoginID, NET_EM_CFG_CUSTOMTITLETEXTALIGN, channel, &g_stTextAlign, sizeof(g_stTextAlign)); // 获取对齐配置
    if (r == false)
    {

        DBGPrint(M_DevCtrl, ERROR_LEVEL,"%s fail: error = %lu", __FUNCTION__, _EC(CLIENT_GetLastError())); // 如果获取失败，打印错误信息
        return -1; // 返回-1表示错误
    }

    // 设置文本对齐
    g_stTextAlign.nCustomTitleNum = dahuuseindex + 1; // 设置自定义标题编号
    g_stTextAlign.emTextAlign[dahuuseindex] = EM_TEXT_ALIGNTYPE_LEFT; // 设置文本对齐类型为左对齐
    r = CLIENT_SetConfig(LoginID, NET_EM_CFG_CUSTOMTITLETEXTALIGN, channel, &g_stTextAlign, sizeof(g_stTextAlign)); // 应用对齐配置
    if (r == false)
    {

        DBGPrint(M_DevCtrl, ERROR_LEVEL,"%s fail: error = %lu", __FUNCTION__, _EC(CLIENT_GetLastError())); // 如果设置失败，打印错误信息
        return -1; // 返回-1表示错误
    }

    DBGPrint(M_DevCtrl, DEBUG_LEVEL,"%s dahua net sdk set OSD succeed!", __FUNCTION__); // 如果一切成功，打印成功信息
    return 0; // 返回0表示成功

}

（二）代码解释

1、概述

这段C++代码是一个函数，名为CNetSdkForDaHua::SetOSD，其作用是设置视频流的OSD（On Screen Display，屏幕显示）信息。是大华视频设备OSD设置的一个例子，涉及到了与设备交互、错误处理和日志记录等多个方面。

2、代码详细解释

（1）函数原型

int CNetSdkForDaHua::SetOSD(bool bStart, long LoginID, int channelid, TExtPtzInfo* pExtPtzInfo) 这个函数接受五个参数：一个布尔值bStart，表示是否开始OSD显示；一个长整型LoginID，可能用于登录设备；一个整型channelid，表示视频通道号；一个指向TExtPtzInfo结构的指针pExtPtzInfo，该结构可能包含了用户名等额外信息。

（2）初始检查

if(m_bIsSetOSD == false) return 0; 如果m_bIsSetOSD标志为false，则表示不允许设置OSD，函数直接返回0。

（3）变量定义

NET_OSD_CUSTOM_TITLE g_stCustomTitle; NET_OSD_CUSTOM_TITLE_TEXT_ALIGN g_stTextAlign; 定义了两个结构体变量，用于存储OSD的定制标题和文本对齐信息。

（4）通道号处理

int channel = channelid - 1; 将channelid减1后作为通道号使用。

（5）获取OSD配置

通过CLIENT_GetConfig函数获取当前的OSD配置。

（6）设置OSD显示