C-Power5200开发API接口手册4.docVIP

C-Power5200开发API接口手册 版本: V1.2 2010.05.22 修订记录： 日期 版本 修改内容 执行人 2009-8-11 V1.0 第一版本 2010-01-28 V1.1 增加多窗口协议数据打包API 增加多窗口协议串口和网络简单应用API 2010-5-22 V1.2 增加下列函数说明： CP5200_Program_AddLafPict CP5200_Program_AddLafVideo CP5200_Program_AddVariable CP5200_MakeGetTypeInfoData CP5200_ParseGetTypeInfoRet CP5200_MakeGetTemperatureData CP5200_ParseGetTemperatureRet CP5200_MakeReadConfigData CP5200_ParseReadConfigRet CP5200_MakeWriteConfigData CP5200_ParseWriteConfigRet CP5200_RS232_GetTemperature CP5200_RS232_GetTypeInfo CP5200_Net_GetTemperature CP5200_Net_GetTypeInfo 1、概述 1.1、数据类型定义 名称 类型 定义 对象句柄 HOBJECT void* 1.2、API接口函数分类 生成节目文件的API接口函数 生成播放列表文件的API接口函数 生成通信数据和解析返回数据的API接口函数 1.3、一般操作步骤 1、生成节目文件 2、生成节目单文件 3、利用生成通信数据和解析返回数据的API接口函数处理通信相关的数据，实现对控制卡的操作。 注意：控制卡启动时只查找节目单文件”playbill.lpp”，若生成数据时保存为其它文件名，在将节目单文件(“.lpp”)发送到卡上的时候，需要改文件名为”playbill.lpp”。 1.4、通信约定 控制卡支持“RS232/485通信方式”和“网络通信方式”。 1.4.1、RS232/485通信方式 数据以RS232/485方式通信时，以0xA5作为开始码，以0xAE作为结束码。在开始码和结束码之间的0xA5, 0xAA, 0xAE数据需要进行转码。 PC端发送数据时将1个码变为2个码: 0xA5 ? 0xAA 0x05 0xAA ? 0xAA 0x0A 0xAE ? 0xAA 0x0E PC端接收数据时将2个码变为1个码： 0xAA 0x05 ? 0xA5 0xAA 0x0A ? 0xAA 0xAA 0xAE ? 0xAE 1.4.2、网络通信方式 发送数据时，需在数据的开始部分加上控制卡的识别码。 1.5、文字、图片显示效果编码 编码 显示效果 0 立即显示 1 左开 2 右开 3 横中开 4 竖中开 5 百叶 6 左移 7 右移 8 上移 9 下移 10 向上滚动 11 向左滚动 12 向右滚动 32768 随机 1.6、文本扩展标记 含扩展标记的文本可以包含以下的扩展标记，所有扩展标记名称必须是小写 扩展标记 说明 size 指定文字的大小,必须带上属性值才起作用，否则被忽略，属性值无效也被忽略。属性值是文字大小。有效值如下： size=8 : 8点阵字 size=16 : 16点阵字 size=24 : 24点阵字 size=32 : 32点阵字 color 指定文字的颜色,必须带上属性值才起作用，否则被忽略，属性值无效也被忽略。属性值是颜色的RGB值，十六进制。 例如： color=#ff0000 : 红色 color=#00ff00 : 绿色 color=#0000ff : 蓝色 p 换行 align 水平对齐方式,必须带上属性值才起作用，否则被忽略，属性值无效也被忽略。有效值如下： align=left : 左对齐 align=center ：居中 align=right ：右对齐 2、生成节目的API接口 2.1、节目生成API接口总览 序号 API接口函数名 接口说明 1 CP5200_Program_Create 创建节目对象 2 CP5200_Program_Destroy 销毁节目对象 3 CP5200_Program_SetProperty 设置节目属性 4 CP5200_Program_SetBackgndImage 设置节目的背景图片 5 CP5200_Program_AddPlayWindow 给节目增加播放窗 6 CP5200_Program_AddText 增加文本项到节目的指定播放窗 7 CP520