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

接口调用步骤说明 2013_V1.01 启动通讯调用StartSend,启动与控制器会话,返回会话句柄.2 设置通讯模式和参数若网络模式，调用SetTransMode设置通讯模式,SetNetworkPara设置网络资源ip。若串口模式，调用SetTransMode设置通讯模式,SetSerialPortPara设置串口通讯资源。3 设置显示内容、控制查询控制器若要更新显示内容,比如添加单行文本，多行文本，时间。节目内容,调用以下函数注: AddControl、AddProgram、SetProgramTimer、AddQuitText、AddFileArea、AddFile、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返回值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返回值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:屏号DBColor：单双色(单色为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,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：开始日期（年）startMonth：开始日期（月）startDay：开始日期（日）startWeek 开始日期（星期）/每年的第几周startHour：开始时间（时）startMinute：开始时间（分）startSecond：开始时间（秒）endYear：结束日期（年）endMonth：结束日期（月）endDay：结束日期（日）endWeek 结束日期（星期）/每年的第几周endHour：结束时间（时）endMinute：结束时间（分）endSecond：结束时间（秒）返回值：1、成功2、参数错误5.int AddQuitText(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,TChar* text)功能：添加静止文本参数：Handle: 会话句柄,StartSend返回值jno：节目号 (=1)qno：区域号 (=1)left：区域左上角顶点x坐标：8的倍数，单位：象素top：区域左上角顶点y坐标width：区域宽度：8的倍数，单位：象素height：区域高度fontColor：字体颜色 颜色的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的倍数，单位：象素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：文件号 (=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, char* 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的倍数，单位：象素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:（起止时间）月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 minute,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：字体名fontSize： 字体号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: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 PlayStyle, 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： 显示特技（支持左移、右移、上移、下移）Playspeed：显示速度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的倍数，单位：象素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 width, 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居中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为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);功能：设置亮度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 brightness3);功能：定时亮度调节bTimer：保留参数，暂时不起作用startHour1, startMinute1, endHo