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

本文主要是介绍视频监控平台-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; // 设置文本左边界为0g_stCustomTitle.stuCustomTitle[dahuuseindex].stuRect.nTop = 6500; // 设置文本顶部边框为6500（可能是像素值）g_stCustomTitle.stuCustomTitle[dahuuseindex].stuRect.nRight = 0; // 设置文本右边界为0g_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; // 设置文本左边界为0g_stCustomTitle.stuCustomTitle[dahuuseindex].stuRect.nTop = 6500; // 设置文本顶部边框为6500（可能是像素值）g_stCustomTitle.stuCustomTitle[dahuuseindex].stuRect.nRight = 0; // 设置文本右边界为0g_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显示