5.0动态库函数说明 V1.0.doc

1、接口调用步骤说明 2013_V1.01 启动通讯调用 StartSend,启动与控制器会话,返回会话句柄.2 设置通讯模式和参数若网络模式，调用 SetTransMode 设置通讯模式,SetNetworkPara 设置网络资源 ip。若串口模式，调用 SetTransMode 设置通讯模式,SetSerialPortPara 设置串口通讯资源。3 设置显示内容、控制查询控制器若要更新显示内容,比如添加单行文本，多行文本，时间。节目内容,调用以下函数注: AddControl、AddProgram、SetProgramTimer、AddQuitText、AddFileArea、AddFile、

2、AddTimerArea、AddDClockArea4 发送添加的内容到显示屏调用 SendControl 函数。此函数，转换文件，并发送数据到控制器中。 5 结束通讯会话调用 EndSend 函数。通讯设置1. int StartSend()功能：启动通讯会话返回值：会话句柄,此值供后续程序调用2.int _stdcall EndSend(int handle)功能：结束通讯会话返回值：1：成功2：不成功4. int SetTransMode(int handle,int TransMode,int ConType)功能：设置通讯模式参数：Handle: 会话句柄,StartSend 返回值

3、TransMode：1、网络通讯 2、串口通讯ConType：控制器型号 1、 T1 Net ,T2 Net2、D2,D3,D4,D5返回值：1：成功0：不成功 5. int SetNetworkPara(int handle, int pno, char* ip)功能：设置网络参数参数:Handle: 会话句柄,StartSend 返回值pno:屏号ip:控制器 IP 地址返回值：1：成功2：不成功6. int SetSerialPortPara(int handle,int pno, int port, int rate)功能：设置串口参数参数：Handle: 会话句柄,StartSend

4、 返回值pno:屏号port:端口号rate：波特率返回值：1：成功2：不成功int SendScreenPara(int Handle,int DBColor,int width,int height) /单色 1 双色功能：发送屏参参数：Handle: 会话句柄,StartSend 返回值DBColor：单双色Width：宽度Height：高度返回值：1：发送成功2：通讯失败3：发送过程中出错节目数据组织1. int AddControl(int handle,int pno,int DBColor)功能：添加显示屏参数：Handle: 会话句柄,StartSend 返回值Pno:屏号DB

5、Color：单双色(单色为 1 ，双色为 2,三基色 3)返回值：1、成功2、参数错误3. int AddProgram(int handle, int jno, int playTime)功能：添加节目参数：Handle: 会话句柄,StartSend 返回值jno：节目号playTime：节目播放时间返回值：1、成功2、参数错误4 . int SetProgramTimer(int handle,int jno,int TimingModel,int WeekSelect,int startSecond,int startMinute,int startHour,int startDay,

6、int startMonth,int startWeek,int startYear,int endSecond,int endMinute,int endHour,int endDay,int endMonth,int endWeek,int endYear)功能：设置节目定时参数：Handle: 会话句柄,StartSend 返回值Jno:节目号TimingModel:按时间：为 1按日期：为 2按星期：为 4时间、日期组合：为 3时间、星期组合：为 6日期、星期组合：为 5时间、日期、星期：为 7WeekSelect：从星期一到星期日 (一个字节 0 位到 6 位)startYear：

7、开始日期（年）startMonth： 开始日期（月）startDay： 开始日期（日）startWeek 开始日期（星期）/每年的第几周startHour： 开始时间（时）startMinute： 开始时间（分）startSecond： 开始时间（秒）endYear： 结束日期（年）endMonth： 结束日期（月）endDay： 结束日期（日）endWeek 结束日期（星期）/每年的第几周endHour： 结束时间（时）endMinute： 结束时间（分）endSecond： 结束时间（秒）返回值：1、成功2、参数错误5.int AddQuitText(int handle, int jno

8、, int qno, int left, int top, int width, int height,int FontColor,TChar* fontName, int fontSize,int fontBold,int Italic,int Underline,TChar* text)功能：添加静止文本参数：Handle: 会话句柄,StartSend 返回值jno： 节目号 (=1)qno： 区域号 (=1)left： 区域左上角顶点 x 坐标：8 的倍数，单位：象素top： 区域左上角顶点 y 坐标width： 区域宽度：8 的倍数，单位：象素height： 区域高度fontColo

9、r： 字体颜色 颜色的 RGB 值，如红色为 ：255fontName： 字体名 fontSize： 字体号 fontBold： 字体粗细0：不加粗1：加粗Italic 斜体Underline: 下划线text： 显示字符串返回值：1、成功2、参数错误6.int AddFileArea(int handle, int jno, int qno, int left, int top, int width, int height)功能：添加文件区域参数：Handle: 会话句柄,StartSend 返回值jno： 节目号 (=1)qno： 区域号 (=1)left： 区域左上角顶点 x 坐标：8

10、的倍数，单位：象素top： 区域左上角顶点 y 坐标width： 区域宽度：8 的倍数，单位：象素heigh： 区域高度返回值：1、成功2、参数错误7.int AddFile(int handle,int jno, int qno, int mno, TChar* fileName,int width,int height,int playstyle,int QuitStyle,int playspeed, int delay,int MidText)功能：添加文件到图文区域中参数：Handle: 会话句柄,StartSend 返回值jno： 节目号 (=1)qno： 区域号 (=1)mno：

11、 文件号 (=1)filename： 文件路径width： 文件显示宽度(目前为区域的宽度)height： 文件显示高度(目前为区域的高度)playstyle： 特技类型（特效：见附录）QuitStyle： 退场方式playspeed： 运行速度（单位：毫秒）delay： 停留时间（单位：毫秒）MidText: 多行文本上下居中 1 为正常，2 为上下居中返回值：1、成功2、参数错误8.int AddTimerArea(int handle , int jno, int qno, int left, int top, int width, int height,int fontColor, c

12、har* fontName, int fontSize, int fontBold,int Italic,int Underline, int mode,int DayShow, int CulWeek,int CulDay,int CulHour,int CulMin,int CulSec, int year, int week,int month, int day, int hour, int minute, int second)功能：计时参数：Handle: 会话句柄,StartSend 返回值jno： 节目号 (=1)qno： 区域号 (=1)left： 区域左上角顶点 x 坐标：8

13、 的倍数，单位：象素top： 区域左上角顶点 y 坐标width： 区域宽度：8 的倍数，单位：象素heigh： 区域高度fontColor： 字体颜色 1 为红色，2 为绿色 3 为黄色fontName： 字体名fontSize： 字体号fontBold： 字体粗细0：不加粗1：加粗Italic 斜体Underline: 下划线mode： 计时方式1：正计时；2：倒计时Dayshow: 是否显示天（1：不显示天 2：显示天）CulWeek： 周CulDay： 天CulHour： 时CulMin： 分CulSec： 秒year： （起止时间）年week: （起止时间）星期month: （起止时

14、间）月day: （起止时间）日hour： （起止时间）时minute： （起止时间）分second: （起止时间）秒返回值：1、成功2、参数错误13.int AddDClockArea(int handle , int jno, int qno, int left, int top, int width, int height,int fontColor, TChar* fontName, int fontSize, int fontBold,int Italic,int Underline, int year,int week,int month,int day,int hour,int m

15、inute,int second,int TwoOrFourYear,int HourShow, int format,int spanMode, int Advacehour, int Advaceminute)功能：数字时钟参数：Handle: 会话句柄,StartSend 返回值jno： 节目号 (=1)qno： 区域号 (=1)left： 区域左上角顶点 x 坐标：8 的倍数，单位：象素top： 区域左上角顶点 y 坐标width： 区域宽度：8 的倍数，单位：象素heigh： 区域高度fontColor： 字体颜色 1 为红色，2 为绿色 3 为黄色fontName： 字体名font

16、Size： 字体号fontBold： 字体粗细0：不加粗1：加粗Italic 斜体Underline 下划线year： 年 1 为显示 “年” 0 为不显示“年” （以下一样）week： 星期month： 月day： 日hour： 时minute：分second：秒TwoOrFourYear： /两位年或四位年 1 为 4 位，2 为 2 位年HourShow： /小时制 1 为 24 小时 2 位 12 小时制format： 显示格式 0：格式 xxxx 年 xx 月 xx 日 xx 时 xx 分 xx 秒1：格式 YYYY-MM-DD HH:MM:SS2：格式 MM/DD/YYYY HH:

17、MM:SS3: 格式 DD/MM/YYYY HH:MM:SSspanMode： 时差设置0：无时差1：超前2：滞后Advacehour： （时差）小时Advaceminute： （时差）分返回值：1、成功2、参数错误14.int AddLnTxtString(int handle,int jno,int qno,int left,int top,int width,int height, TCHAR *text, TCHAR *fontname, int fontsize, int fontcolor, bool bold, bool italic, bool underline, int P

18、layStyle, int Playspeed, int times) ;功能：添加单行文本（使用字符串）参数：jno： 节目号 (=1)qno： 区域号 (=1)left： 区域左上角顶点 x 坐标：8 的倍数，单位：象素top： 区域左上角顶点 y 坐标width： 区域宽度：8 的倍数，单位：象素height： 区域高度Fontname 字体名称Fontsize 字体大小Fontcolor 字体颜色（255红色，65280黄色，65535绿色);Bold 是否粗体Italic 是否斜体Underline 是否下划线PlayStyle： 显示特技（支持左移、右移、上移、下移）Playspe

19、ed： 显示速度Times 保留参数（暂未使用）返回值：1、成功2、参数错误15.int AddLnTxtArea(int handle, int jno, int qno, int left, int top, int width, int height,TCHAR* LnFileName,int PlayStyle, int Playspeed,int times);功能：添加单行文本（使用文件）参数：jno： 节目号 (=1)qno： 区域号 (=1)left： 区域左上角顶点 x 坐标：8 的倍数，单位：象素top： 区域左上角顶点 y 坐标width： 区域宽度：8 的倍数，单位：象

20、素height： 区域高度LnFileName 单行文本（信息）文件路径，只支持 rtf 格式文件PlayStyle： 显示特技（支持左移、右移、上移、下移）Playspeed： 显示速度Times 保留参数（暂未使用）返回值：1、成功2、参数错误16. int AddFileString(int handle, int jno, int qno, int mno, char *text, char* fontname, int fontsize, int fontcolor, bool bold, bool italic, bool underline, int align,int widt

21、h, int height, int playstyle, int QuitStyle, int playspeed, int delay, int MidText);功能：添加字符串到图文区域中参数：jno： 节目号 (=1)qno： 区域号 (=1)mno： 文件号 (=1)text： 字符数据Fontname 字体名称Fontsize 字体大小Fontcolor 字体颜色（255红色，65280黄色，65535绿色);Bold 是否粗体(取值 0 或 1)Italic 是否斜体(取值 0 或 1)Underline 是否下划线 (取值 0 或 1)Align 对齐方式(1 左对齐 2 居

22、中 3 右对齐)/Para 段落间距(默认不设置请传递 0.5）必须为 0.5 的倍数width： 文件显示宽度(目前为区域的宽度)height： 文件显示高度(目前为区域的高度)playstyle： 特技类型（特效：见附录）QuitStyle： 退场方式playspeed： 运行速度（单位：毫秒）delay： 停留时间（单位：毫秒）MidText: 多行文本上下居中 1 为正常，2 为上下居中返回值：1、成功2、参数错误16. int SendControl(int handle, int SendType,HWND hwnd);功能：发送数据参数：SendType:发送模式 1 为普通 2

23、 为 SD 卡发送Hwnd:窗口句柄 ,一般取 0 即可返回值：0：原因：1,没有添加节目 2.若为网络发送，则端口被占用 3.若为串口发送则串口被占用或不存在1：发送成功2：通讯失败3：发送过程中出错17.int AdjustTime(int handle);功能：手动校时返回值：1 成功;2 通讯失败;3 发送过程中失败18.int SetPower(int handle,int power);功能：开关机Power： 0 为开屏 1 为关屏返回值：1：发送成功2：通讯失败3：发送过程中出错19.int SetBrightness ( int handle, int value);功能：设

24、置亮度Value:亮度值 11620.int SetBrightnessTimer(int handle, int bTimer,int startHour1, int startMinute1,int endHour1, int endMinute1, int brightness1,int startHour2, int startMinute2,int endHour2, int endMinute2, int brightness2,int startHour3, int startMinute3,int endHour3, int endMinute3, int brightness

25、3);功能：定时亮度调节bTimer：保留参数，暂时不起作用startHour1, startMinute1, endHour1, endMinute1, brightness1(亮度值)：第一组开始、结束时间startHour2, startMinute2, endHour2, endMinute2, brightness2(亮度值)：第二组开始、结束时间startHour3, startMinute3, endHour3, endMinute2, brightness3(亮度值)：第三组开始、结束时间21. int SetTest(int handle, int value)功能：测试参数

26、：Handle: 会话句柄,StartSend 返回值Value：测试值1：全屏黑2：全屏黄3：全屏红4: 全屏绿5: 正斜线6: 负斜线7: 网格线8: 交叉线返回值：1：发送成功2：通讯失败3：发送过程中出错特技：0 随机 1 翻页 2 左覆盖3 右覆盖 4 上覆盖5 下覆盖6 左上角覆盖(斜线)7 右上角覆盖(斜线)8 左下角覆盖(斜线)9 右下角覆盖(斜线) 10 左上角覆盖(直线) 11 右上角覆盖(直线)12 左下角覆盖(直线) 13 右下角覆盖(直线)14 左上角覆盖(边沿)15 右上角覆盖(边沿)16 左下角覆盖(边沿)17 右下角覆盖(边沿)18 水平百叶(左右)19 水平百叶(右左)20 垂直百叶(上下)21 垂直百叶(下上)22 左右对开23 上下对开24 左右闭合25 上下闭合26 上移27 下移28 左移29 右移30 连续上移31 连续下移32 连续左移33 连续右移34 中间向四周(矩形)35 四周向中间(矩形)36 中间向四周(菱形)37 四周向中间(菱形)38 中间向四周(十字)39 四周向中间(十字)255 无 (注：退场方式可以用“无”特技，显示特技没有“无”特技)