外置图象处理器网络集成控制协议10.20

1、外置图象处理器网络控制协议（协议 TCP/IP 端口号 ：1003）一、 初次登录时指令说明：客户端为了连接后获取屏幕分辨率信息和权限标记使用该指令:发送格式：46(Int)+ ”I111”(字符串) +“username”(20个字符不到20个用空格填满)+”password”(20个字符不到20个用空格填满)” 返回值: 1）4个整数: 第一个整数为返回识别码19, 第二个整数为屏幕行分辨率, 第三个整数为屏幕列分辨率, 第四个整数为操作权限; 2）如果用户名不存在时，返回数据：102(Int)+0(Int)+ 0(Int)+ 0(Int)+”无该用户”(字符串) 3）如果密码错误时，返回

2、数据：102(Int)+0(Int)+ 0(Int)+ 0(Int)+”密码错误”(字符串)二、 客户端获取服务端的状态说明：状态数据主要是服务端所有窗口的参数，每个窗口占用50个INT数据，且最多可以开100个窗，即窗口资源只有100个，当第N窗口是否已经使用（已开窗或已删除），用该窗口数据段中的状态数据来体现。因此该数据对于客户端非常重要，对于窗口的改动、开窗和删除窗口等信息，必须与服务端保持同步一致，且在创建窗口和删除窗口时各种次序值作为新次序值的参考数值。发送格式： 发送整数66返回值：返回1 + 50*100 + 4个整数，即 1个命令标示 + DATA10050窗口状态数组 + 4

3、个屏幕信息。1） 第一个DATA0整数为命令标志，DATA0=1表示回送数据命令。2） 接下来的50*100为100个窗口的属性数据，每个窗口50个Int整数数据，前12个数据为窗口的位置、次序值、信号类型等信息，详细看下面窗口基本操作指令的PWIN1 PWIN12 （从0计数，包含命令标示）依次代表该12个数据，其他PWIN12PWIN49（从0计数，不包含命令标示）为扩展属性具体如下（没提到的为备用）。PWIN14 信号窗口亮度 / 适合视频 RGB/DVI窗口 T200/6xxx系列处理器范围 0-100PWIN15 信号窗口对比度/ 适合视频 RGB/DVI窗口 T200/6xxx系列

4、处理器范围 0-100PWIN16 信号窗口色彩 / 适合视频 RGB/DVI窗口 T200/6xxx系列处理器范围 0-100PWIN17 信号窗口色调 /只对视频信号 T200/6xxx系列处理器范围 -180-+180PWIN18 信号窗口相位 / 适用T100 RGB窗口 PWIN19 信号窗口采样率 /适用 T200/6xxx系列处理器PWIN20 信号窗口缩放 / 窗口缩放锁定 PWIN21 信号窗口边框 /无边框为1 有边框为0 PWIN22 信号窗口 / T200/6xxx RGB 宽度偏移量(-220,+200) PWIN23 信号窗口水平位移 /RGB信号水平位移 (0,2

5、00)PWIN24 信号窗口垂直位移 /RGB信号垂直位移 (0,600)PWIN25 信号窗口相位(RGB信号) / RGB信号采样相位 (0,32)PWIN26 信号窗口窗口置顶 /0正常; 1 为置顶; 2为置底; PWIN27 信号窗口滤波方式 /视频信号FILTER 方式 1.单场 2.震荡 3.交织PWIN28 信号窗口DOWNSAMPLE / 信号降频采样, 1.为1:1 采样; 2. 为1:2采样; 3为1:4采样; 4为: 1:8采样; PWIN29 信号窗口DOWNSCALE / 信号采样规模, 1.为1:1 采样; 2. 为1:2采样; 3为1:4采样; 4为: 1:8采

6、样;PWIN30 保留（设置窗口属性时，用来指定设置什么属性）PWIN31 信号窗口剪修左边 /信号局部放大左边位置PWIN32 信号窗口剪修顶边 /信号局部放大右边位置PWIN33 信号窗口剪修宽度 /信号局部放大宽度PWIN34 信号窗口剪修高度 /信号局部放大高度PWIN35 信号窗口信号行分辨率 PWIN36 信号窗口信号列分辨率 PWIN37 信号窗口信号类型 0.为视频1; 1为视频2; 2为视频3;3）最后四个整数说明：DATA 5001:代表屏幕横向分辨率（2012-10-8前的老版本为DATA 4101）DATA 5002:代表屏幕纵向分辨率（2012-10-8前的老版本为D

7、ATA 4102）DATA 5003:代表视频输入最大数（2012-10-8前的老版本为DATA 4103）DATA 5004:代表RGB输入最大数 （2012-10-8前的老版本为DATA 4104）三、 窗口基本操作指令说明：创建、删除和设置窗口时，客户端发送到RS的指令。发送格式：创建窗口的指令为13个Int数字，这里用数组PWIN 13来说明第1个整数 PWIN0 为命令标志： 当PWIN06时，表示创建一个新窗口； 当PWIN07时，表示改变一个窗口属性（如窗口大小，位置及输入信号）；当PWIN09时，表示删除一个窗口；第2、3、4、5个整数PWIN1PWIN4 分别表示窗口对应的坐

8、标数值（以屏幕的左上角为坐标原点，X轴与水平方向平行，Y轴与水平方向垂直，方向坐标值为实际位置的分辨率）。 PWIN1为该窗口在X轴上的起点值（处理器图形输出口横向分辨率）； PWIN2为该窗口在Y轴上的起点值（处理器图形输出口纵向分辨率）； PWIN3为该窗口在X轴上的终点值（处理器图形输出口横向分辨率）； PWIN4为该窗口在Y轴上的终点值（处理器图形输出口纵向分辨率）。第6个整数 PWIN5 为处理器上的窗口次序值：PWIN5=N，表示为处理器上第N个窗口。(从1开始到100时为有效已开窗口；0为无效窗口或已被删除的窗口，同时允许用来创建窗口)，创建窗口的时候，在客户端获取服务端的状态中

9、找到该值为0的窗口数据段序号，例如窗口状态数据段为数组DATA10050，当DATAwinIndex4=0时，表示第（winIndex+1）个窗口可以用来开窗，这里创建窗口的命令PWIN5赋值为（winIndex+1）。第7个整数 PWIN6 表示该窗口的信号类型： 当PWIN6=1时，表示该窗口的信号为视频信号； 当PWIN6=2时，表示该窗口的信号为RGB信号； 当PWIN6=3时，表示该窗口的信号为网络信号。（网络抓屏已经不常用了） 当PWIN6=4时，表示该窗口的信号为进程信号。 第8个整数 PWIN7表示输入信号的次序值：PWIN7N，表示为第N路输入信号(从0开始)。第9个整数 P

10、WIN8表示视频窗口的次序值：PWIN8N，表示为第N个视频信号窗口(从1开始，0为无效窗口或已被删除的窗口)，如果PWIN6不为视频信号类型值，则该值无效。具体规则与第6个整数 PWIN5 为处理器上的窗口次序值一样。第10个整数PWIN9表示RGB窗口的次序值：PWIN9N，表示为第N个RGB信号窗口(从1开始，0为无效窗口或已被删除的窗口)，如果PWIN6不为RGB信号类型值，则该值无效。具体规则与第6个整数 PWIN5 为处理器上的窗口次序值一样。第11个整数 PWIN10 表示网络窗口的次序值：PWIN10N，表示为第N个网络信号窗口(从1开始，0为无效窗口或已被删除的窗口)。如果P

11、WIN6不为网络信号类型值，则该值无效。具体规则与第6个整数 PWIN5 为处理器上的窗口次序值一样。第12个整数 PWIN11 表示客户端连接RS服务时返回的连接ID号。 通过客户端获取服务端的状态的时候获取连接ID第13个整数 PWIN12 表示进程窗口的次序值：PWIN12N，表示为第N个进程信号窗口(从1开始，0为无效窗口或已被删除的窗口)，如果PWIN6不为网络信号类型值，则该值无效。具体规则与第6个整数 PWIN5 为处理器上的窗口次序值一样。返回值：1） 创建窗口成功时，返回向所有客户端发送50个数据窗口数据。如果创建失败，说明想创建窗口的视频/RGB窗口的次序值超出各自设置的最

12、大窗口数，且向所有客户端回送该客户端发来的数据，且回馈命令标志PWIN0=9，用于通知所有客户端该窗口是无效的，方便客户端更新窗口状态。2） 修改窗口成功时，如果信号输入口变更将返回5005个整数的服务器端所有窗口状态值，回馈命令标示DATA0=40,实际有效值为前5001个，后4个整数值忽略(不一定为前面提到的屏幕分辨率等值)；同时窗口位置大小变化还会向各个客户端发送反馈数据包，详细看主动反馈数据包。修改失败，与创建窗口失败一样，回馈命令标志PWIN0=9的13个数据，失败原因也是窗口的视频/RGB窗口的次序值超出各自设置的最大窗口数。3） 删除窗口时，也会向各客户端发送反馈数据包，详细看主

13、动反馈数据包。四、 主动反馈数据包当RS服务端的窗口自己发生变化,如鼠标移动窗口,直接在处理器手动开窗,会主动反馈数据给所有客户端。数据长度一般为12个整数的窗口基本信息（有些由于BUG，只有11个整数或16个整数）。第1个整数 PWIN0 为反馈命令标志： 当PWIN06时，表示创建一个新窗口； 当PWIN02时，表示改变一个窗口属性（如窗口大小，位置及输入信号等）； 当PWIN09时，表示删除一个RGB或视频窗口； 当PWIN08时，表示删除一个网络窗口。五、 刷新所有窗口状态属性，一起发送数据包：当客户端需要一起创建窗口并同时删除原来显示窗口时,可同时向服务端rs发送1+50*10=50

14、01个整数, 在此用SEND5001来代表5001个整数； 第一个SEND0=8表示一起发送数据包的命令. 以后每50个整数表示一个窗口的属性，客户端在发送时可按连接时接受的ECHO5005数据基础上把ECHO0改成8,然后对每个窗口属性的前13位数据填上所要显示的值.六、 设置单个RGB/视频信号参数状态说明：前面窗口基本操作指令的修改指令主要修改的是基本窗口信息，这里是主要有设置RGB/视频信号的详细参数。发送格式：51个整数，第一个整数DATA0=41为设置视频参数、DATA0=42为设置RGB参数。后面的50个参数为窗口状态属性，前面已经描述过，前12个参数为窗口的基本信息，这些参数在

15、客户端发送时，最好保持原来的参数。其余的规则如下：1） DATA0=41设置视频参数 ： PWIN30=1 以PWIN14的值设置亮度 PWIN30=2 以PWIN15的值设置对比度 PWIN30=3 以PWIN17的值设置色调 PWIN30=4 以PWIN16的值设置色彩 PWIN30=51 以PWIN27的值设置滤波方式 PWIN30=52 以PWIN28的值设置信号降频采样 PWIN30=53 以PWIN29的值设置信号采样规模 PWIN30=7 以PWIN21和PWIN20的值设置窗口缩放锁定和边框 PWIN30=9 以按照所有属性（50个整数）的值一并设置 PWIN30= 10 以P

16、WIN19、PWIN31 PWIN34的值设置信号采样率和窗口剪切大小2） PWIN30=42设置RGB参数 PWIN30=1 与视频相同 PWIN30=2与视频相同 PWIN30=4与视频相同 PWIN30=51与视频相同 PWIN30=52与视频相同 PWIN30=53与视频相同 PWIN30=7 与视频相同 PWIN30=9 与视频相同 PWIN30=10 与视频相同 PWIN30=3 以PWIN22的值设置RGB 宽度偏移量 PWIN30=8 以PWIN25的值设置RGB信号采样相位 PWIN30=5 以PWIN23的值设置信号窗口水平位移 PWIN30=6 以PWIN24的值设置信号

17、窗口垂直位移返回值：无七、 连接检查说明：用于确认RS服务端是否连接着发送格式：发送二个整数 254 + 连接ID返回值：服务端会返回 三个整数 254+连接ID+254八、 读取窗口属性命令发送格式：客户端的程序向服务端发送一个40整数返回值：服务端回送1+50*100=5001个整数，在此用ECHO 5001来代表5001个整数；第一个ECHO0=40，为命令标志，表示回送窗口属性参数。以后每50个整数表示一个窗口的属性。九、 窗口最小化和恢复发送格式：1个命令标示整数+12个窗口基本信息整数 DATA0=21 为窗口最小化 DATA0=22 窗口还原返回值：向所有客户端反馈数据包，详细看

18、主动反馈数据包十、 获取可开窗的程序名单说明：用户进程开窗的程序在RS服务端配置，详细看注意事项中的3），当对某进程开窗时，在发送指令时PWIN7（包含命令标示PWIN0）写入需要开窗的程序名单Index。发送格式：一个整数56返回值：4字符 + ProcList3080，开头四个char都为1，后面为30个字符串，每个字符串（最大长度为80Char）代表一个进程名。十一、 字幕设置与关闭1） 字幕开启，先发送一个1001整数, 间隔10ms 后再把以下结构发过去.显示字幕的结构定义: struct word_setupint left ; /字幕区域左边 int top; /字幕区域上边 i

19、nt width; /字幕区域宽度int height; /字幕区域高度long direct; /字幕区域方向int time; /字幕移动间隔char word1000;/ 字母内容 String word; int size ; /字体大小int style; /字体类型long color; /字体颜色int hide; /保留char name50;/字体名字 String name;int space; /字母间隔int count; / 字幕行数 WORD_SETUP;2） 字幕关闭，发送一个1002整数3） 获取当前字幕属性，发送一个1003整数，将先返回2个整数，且第一个为1003，然后返回以上字幕结构数据。十二、 断开连接前指令说明：断开前必须发送该指令，标示将要断开连接。发送格式：两个整数，第一个为1