C-Power5200开发API接口手册.docx
《C-Power5200开发API接口手册.docx》由会员分享,可在线阅读,更多相关《C-Power5200开发API接口手册.docx(99页珍藏版)》请在淘文阁 - 分享文档赚钱的网站上搜索。
1、C-Power5200开发API接口手册版本:V 1.22010.05.22修订记录:日期版本修改内容执行人2009-8-11V1.0第一版本2010-01-28VI.11 .增加多窗口协议数据打包API2 .增加多窗口协议串口和网络简单应用API2010-5-22V1.2增加下列函数说明:1. CP5200_Program_AddLafPict2. CP5200_Program_AddLafVideo3. CP5200_Program_AddVariable4. CP5200_MakeGetTypeInfoData5. CP5200_ParseGetTypeInfoRet6. CP5200_
2、MakeGetTemperatureData7. CP5200_ParseGetTemperatureRet8. CP5200_MakeReadConfigData9. CP5200_ParseReadConfigRet10. CP5200_MakeWriteConfigData11. CP5200_ParseWriteConfigRet12. CP5200_RS232_GetTemperature13. CP5200_RS232_GetTypeInfo14. CP5200_Net_GetTemperature15. CP5200_Net_GetTypeInfo1、概述1.1、 数据类型定义名
3、称类型定义对象句柄HOBJECTvoid*1.2、 API接口函数分类 生成节目文件的API接口函数 生成播放列表文件的API接口函数 生成通信数据和解析返回数据的API接口函数1.3、 一般操作步骤1、生成节目文件2、生成节目单文件3、利用生成通信数据和解析返回数据的API接口函数处理通信相关的数据, 实现对控制卡的操作。注意:捽制卡启动时只查找节目单文件”playbill. Ipp”,若生成数据时保存 为其它文件名,在将节目单文件(“.1PP”)发送到卡上的时候,需要改文件 名为playbill. Ipp”。1.4、 通信约定控制卡支持“RS232/485通信方式”和“网络通信方式”。1.
4、4.1、 RS232/485 通信方式数据以RS232/485方式通信时,以0xA5作为开始码,以OxAE作为结束码。在开始码和结束码之间的0xA5, OxAA, OxAE数据需要进行转码。PC端发送数据时将1个码变为2个码:0xA5 f OxAA 0x05OxAA f OxAA OxOAOxAE f OxAA OxOEPC端接收数据时将2个码变为1个码:OxAA 0x05 f 0xA5OxAA OxOA 今 OxAAOxAA OxAE - OxAE1.4.2、 网络通信方式发送数据时,需在数据的开始部分加上控制卡的识别码。1.5、 文字、图片显示效果编码编码显示效果0立即显示1左开2右开3横
5、中开4竖中开5百叶6左移7右移8上移9下移10向上滚动11向左滚动12向右滚动32768随机1.6、 文本扩展标记含扩展标记的文本可以包含以下的扩展标记,所有扩展标记名称必须是小写扩展标记说明指定文字的大小,必须带上属性值起作用,否则被忽略,属性值无效也被忽略。属性值是文字大小。有效值如下: : 8 点阵字 : 16 点阵字 : 24 点阵字 : 32 点阵字指定文字的颜色,必须带上属性值起作用,否则被忽略, 属性值无效也被忽略。属性值是颜色的RGB值,十六进制。例如: :红色 :绿色 :蓝色换行水平对齐方式,必须带上属性值起作用,否则被忽略,属性值无效也被忽略。有效值如下:align=lef
6、t:左对齐 : 居中 :右对齐2、生成节目的API接口2.1 节目生成API接口总览序号API接口函数名接口说明1CP5200_Program_Create创建节目对象2CP5200_Program_Des troy销毁节目对象3CP5200_Program_SetProperty设置节目属性4CP5200_Program_SetBackgndImage设置节目的背景图片5CP5200_Program_AddPlayWindow给节目增加播放窗6CP5200 Program AddText增加文本项到节目的指定播放窗7CP5200_Program_AddTagText增加包含扩展标记的文本项到
7、节目的指定播 放窗8CP5200 Program AddPicture增加图片项到节目的指定播放窗9CP5200_Program_AddLa fPict添加LAF图片项到节目的指定播放窗10CP5200 Program AddLafVideo添加LAF动画项到节目的指定播放窗11CP5200_Program_AddAnimator增加动画项到节目的指定播放窗12CP5200_Program_AddC1ock增加时钟项到节目的指定播放窗13CP5200_Program_AddTemperature增加温度项到节目的指定播放窗14CP5200 Program AddVariable增加自定义变量数
8、据到指定播放窗15CP5200_Program_SaveToFile保存节目到文件本类函数的使用步骤如下:创建节目对象增加播放窗增加播放项到指定播放窗 保存节目到文件销毁节目对象2.2 、节目生成API接口详细描述CP5200_Program_CreateHOBJECT CP5200 Program_Create(WORD width, WORD height, BYTE color)作用创建节目对象参数width:显示屏宽度,以点为单位height:显示屏高度,以点为单位color:颜色和灰度级别。现版本只支持256级灰度全彩(0x77)返回值节H对象句柄,供本类API接口函数使用返回“空”
9、表示创建失败其它说明对象创建成功并不再使用时,必须将对象销毁CP5200_Program_Destroyint CP5200_Program_Destroy(HOBJECT hObj)作用销毁节目对象参数hObj:要销毁的节目对象句柄返回值0:无错误-1:不正确的节目对象句柄其它说明CP5200_Program_SetPropertyint CP5200_Program_SetProperty(HOBJECT hObj, int nPropertyValue, DWORD nPropertylD)作用设置节目属性参数hObj:节目对象句柄nPropertyValue:属相值,根据属性识别参数的
10、不同有不同的含义节目循环播放次数的范围是1-65535节目播放时间的单位是秒,取值范围165535nPropertylD:属性识别,可以是以下值之1:节目循环播放次数2:节目播放时间返回值-1:不正确的节目对象句柄0:不认识的属性识别0:设置成功其它说明“节目循环播放次数”和节目播放时间”二者只有一个有效,以最 后一次的设置为有效。CP5200_Program_SetBackgndImageint CP5200_Program SetBackgndImage(HOBJECT hObj, const BYTE* plmgDat, WORD wlmgWidth,WORD wlmgHeight, B
11、YTE color, int nMode, int nCompress)作用设置节目的背景图片参数hObj:节目对象句柄plmgDat:图片数据缓冲区。根据参数color的值确定有哪种颜色的数 据,以及数据的格式。多种颜色的数据同时存在时,先红色 数据,再放绿色数据,最后是蓝色数据。对于每个颜色的数据,先放第1行的数据,再放第二行的数 据,每个像素的数据表示根据color参数的高4位来确定。wlmgWidth:图片寛度的点数wlmgHeight:图片高度的点数color:图片数据包含哪些颜色的数据,以及数据的格式。最4位表示包含哪些颜色的数据,可以是以下值的组合:0x01:存在红色数据0x02
12、:存在绿色数据0x04:存在蓝色数据高4位表示数据的格式(灰度级别),支持2种格式:0x0:二值图像。按照图像的水平行,每8个点的数据组成一个 字节,行末不足8点时,以补足一个字节;一种颜色 的数据量(单位:字节)是:(图片宽度+7)/8)图片高 度。0x7: 256级灰度数据。每个点用1字节表示;种颜色的数据 量(单位:字节)是:图片宽度*图片高度。例如:0x71表示256级灰度图片,只存在红色数据nMode:显示时的处理方式0:居中1:按比例缩放2:拉伸3:平铺nCompress:压缩图片数据。现只支持不压缩的方式0:不压缩返回值-1:不正确的节目对象句柄-4 :内存不足其它说明CP520
13、0_Program_AddPlayWindowint CP5200_Program_AddPlayWindow(HOBJECT hObj, WORD x, WORD y, WORD ex, WORD cy)作用给节H增加播放窗参数hObj:节目对象句柄x:播放窗起始X坐标y:播放窗起始Y坐标CX:播放窗宽度cy:播放窗高度返回值- =0:播放窗号- 1:不正确的节目对象句柄- 3:参数错误其它说明CP5200_Program_AddTextint CP5200_Program AddText (HOBJECT hObj, int nW inNo, const char* pText, int
14、nFontSize,COLORREF crColor, int nEffect, int nSpeed, int nStay)作用增加文本项到指定播放窗参数hObj:节目对象句柄nWinNo:播放窗号pText:文本字符串nFontSize:文字大小crColor:文字颜色nEffect:文字显示效果nSpeed:文字显示速度nStay:停留时间返回值0:无错误- 1:不正确的节目对象句柄- 3:播放窗号无效- 4:内存不足其它说明CP5200_Program_AddTagTextint CP5200_Program_AddTagText(HOBJECT hObj, int nWinNo, c
15、onst char* pText, int nFontSize, COLORREF crColor, int nEffect, int nSpeed, int nStay)作用增加文本项到指定播放窗参数hObj:节目对象句柄nWinNo:播放窗号pText:文本字符串,可包含扩展标记。参见“1.6”节nFontSize:文字大小crColor:文字颜色nEffect:文字显示效果nSpeed:文字显示速度nStay:停留时间返回值0:无错误- 1:不正确的节目对象句柄- 3:播放窗号无效- 4:内存不足其它说明缺省使用参数中的文字大小、颜色等属性值,若文本中包含扩展标记, 则从扩展标记开始,使
16、用扩展标记指定的值。CP5200_Program_AddPictureint CP5200_Program_AddPicture(HOBJECT hObj, int nWinNo, const char* pPictFile, intnMode, int nEffect, int nSpeed, int nStay, int nCompress)作用增加图片项到指定播放窗参数hObj:节目对象句柄nWinNo:播放窗号pPictFile:图片文件路径和名称nMode:显示时的处理方式0:居中1:按比例缩放2:拉伸3:平铺nEffect:图片显示效果nSpeed:效果展示速度。最快nStay:停
17、留时间,单位为秒nCompress:压缩图片数据0Z不压缩1:转换为256色图片并压缩数据返回值0:无错误- 1:不正确的节目对象句柄- 3:播放窗号无效- 4:内存不足其它说明CP5200_Program_AddLafPictint CP5200 Program AddLafPict(HOBJECT hObj, int nWinNo, const char* pLafFile, int nMode, int nEffect, int nSpeed, int nStay, int nCompress)作用添加LAF图片项到节目的指定播放窗参数hObj:节目对象句柄nWinNo:播放窗号pLaf
18、File:图片文件路径和名称nMode:显示时的处理方式0:居中1:按比例缩放2:拉伸3:平铺nEffect:图片显示效果nSpeed:效果展示速度。最快nStay:停留时间,单位为秒nCompress:压缩图片数据0:不压缩1;转换为256色图片并压缩数据返回值0:无错误- 1:不正确的节目对象句柄- 3:播放窗号无效- 4:内存不足其它说明CP5200_Program_AddLafV ideoint CP5200_Program_AddLafVideo(HOBJECT hObj, int nWinNo, const char* pLafFile, int nMode, int nRepea
19、t)作用添加LAF动画项到节目的指定播放窗参数hObj:节目对象句柄nWinNo:播放窗号pLafFile:动画文件路径和名称nMode:显示时的处理方式0:居中1:按比例缩放2:拉伸3:平铺nRepeat:动画循环播放的次数返回值0:无错误- 1:不正确的节目对象句柄- 3:播放窗号无效- 4:内存不足其它说明CP5200_Program_AddAnimatorint CP5200 Program AddAnimator(HOBJECT hObj, int nWinNo, const char* pAniFile, int nMode, i nt nRepeat)作用增加动画项到指定播放窗参
20、数hObj:节目对象句柄nWinNo:播放窗号pAniFile:动画文件(.gif)路径和名称nMode:显示时的处理方式0:居中1:按比例缩放2:拉伸3:平铺nRepeat:动画循环播放的次数返回值0:无错误- 1:不正确的节目对象句柄- 3:播放窗号无效- 4:内存不足其它说明CP5200_Program_AddClockint CP5200_Program_AddClock (HOBJECT hObj, int nW inNo, const char* pText, int nFontSize,COLORREF crColor, int nStay, WORD wAttr)作用增加时钟项
21、到指定播放窗参数hObj:节目对象句柄nWinNo:播放窗号pText:文本字符串nFontSize:文字大小crColor:文字颜色nStay:停留时间wAttrib:时钟属性,可以是以下值的组合0x0001显示年0x0002显示月0x0004显示日0x0008显示小时0x0010显示分钟0x0020显示秒0x0040显示星期0x0080显示指针0x0100 24小时制0x0200两位年份0x0400分行显示0x0000 一般格式:2006年1月1日10点分秒0x1000 简单格式:2006-01-01 10:00:000x2000 英文格式:Thu,Apr 17,2008 10:00:00
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- Power5200 开发 API 接口 手册
限制150内