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 个命令标示
3、 + DATA10050窗口状态数组 + 4 个屏幕信息。1）第一个 DATA0整数为命令标志，DATA0=1 表示回送数据命令。2）接下来的 50*100 为 100 个窗口的属性数据，每个窗口 50 个 Int 整数数据，前 12 个数据为窗口的位置、次序值、信号类型等信息，详细看下面窗口基本操作指令的 PWIN1 PWIN12 （从 0 计数，包含命令标示）依次代表该 12 个数据，其他 PWIN12PWIN49（从 0 计数，不包含命令标示）为扩展属性具体如下（没提到的为备用） 。PWIN14 信号窗口亮度 / 适合视频 RGB/DVI 窗口 T200/6xxx 系列处理器范围 0-1
4、00PWIN15 信号窗口对比度/ 适合视频 RGB/DVI 窗口 T200/6xxx 系列处理器范围 0-100PWIN16 信号窗口色彩 / 适合视频 RGB/DVI 窗口 T200/6xxx 系列处理器范围 0-100PWIN17 信号窗口色调 /只对视频信号 T200/6xxx 系列处理器范围 -180-+180PWIN18 信号窗口相位 / 适用 T100 RGB 窗口 PWIN19 信号窗口采样率 /适用 T200/6xxx 系列处理器PWIN20 信号窗口缩放 / 窗口缩放锁定 PWIN21 信号窗口边框 /无边框为 1 有边框为 0 PWIN22 信号窗口 / T200/6xx
5、x RGB 宽度偏移量(-220,+200) PWIN23 信号窗口水平位移 /RGB 信号水平位移 (0,200)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 采样; P
6、WIN29 信号窗口 DOWNSCALE / 信号采样规模, 1.为 1:1 采样; 2. 为 1:2 采样; 3 为1:4 采样; 4 为: 1:8 采样;PWIN30 保留（设置窗口属性时，用来指定设置什么属性）PWIN31 信号窗口剪修左边 /信号局部放大左边位置PWIN32 信号窗口剪修顶边 /信号局部放大右边位置PWIN33 信号窗口剪修宽度 /信号局部放大宽度PWIN34 信号窗口剪修高度 /信号局部放大高度PWIN35 信号窗口信号行分辨率 PWIN36 信号窗口信号列分辨率 PWIN37 信号窗口信号类型 0.为视频 1; 1 为视频2; 2 为视频 3;3）最后四个整数说明：
7、DATA 5001:代表屏幕横向分辨率（2012-10-8前的老版本为DATA 4101）DATA 5002:代表屏幕纵向分辨率（2012-10-8前的老版本为DATA 4102）DATA 5003:代表视频输入最大数（2012-10-8前的老版本为DATA 4103）DATA 5004:代表RGB输入最大数 （2012-10-8前的老版本为DATA 4104）三、 窗口基本操作指令说明：创建、删除和设置窗口时，客户端发送到 RS 的指令。发送格式：创建窗口的指令为 13 个 Int 数字，这里用数组 PWIN 13来说明第 1 个整数 PWIN0 为命令标志：当 PWIN06 时，表示创建一
8、个新窗口；当 PWIN07 时，表示改变一个窗口属性（如窗口大小，位置及输入信号） ；当 PWIN09 时，表示删除一个窗口；第 2、3、4、5 个整数 PWIN1PWIN4 分别表示窗口对应的坐标数值（以屏幕的左上角为坐标原点，X 轴与水平方向平行， Y 轴与水平方向垂直，方向坐标值为实际位置的分辨率） 。PWIN1为该窗口在 X 轴上的起点值（处理器图形输出口横向分辨率） ；PWIN2为该窗口在 Y 轴上的起点值（处理器图形输出口纵向分辨率） ；PWIN3为该窗口在 X 轴上的终点值（处理器图形输出口横向分辨率） ；PWIN4为该窗口在 Y 轴上的终点值（处理器图形输出口纵向分辨率） 。第
9、 6 个整数 PWIN5 为处理器上的窗口次序值：PWIN5=N，表示为处理器上第N 个窗口。(从 1 开始到 100 时为有效已开窗口；0 为无效窗口或已被删除的窗口，同时允许用来创建窗口)，创建窗口的时候，在 客户端获取服务端的状态中找到该值为 0 的窗口数据段序号，例如窗口状态数据段为数组 DATA10050，当 DATAwinIndex4=0 时，表示第（winIndex+1 ）个窗口可以用来开窗，这里创建窗口的命令 PWIN5赋值为（winIndex+1） 。第 7 个整数 PWIN6 表示该窗口的信号类型：当 PWIN6=1 时，表示该窗口的信号为视频信号；当 PWIN6=2 时，
10、表示该窗口的信号为 RGB 信号；当 PWIN6=3 时，表示该窗口的信号为网络信号。 （网络抓屏已经不常用了）当 PWIN6=4 时，表示该窗口的信号为进程信号。 第 8 个整数 PWIN7表示输入信号的次序值：PWIN7N，表示为第 N 路输入信号(从 0 开始) 。第 9 个整数 PWIN8表示视频窗口的次序值：PWIN8N，表示为第 N 个视频信号窗口( 从 1 开始，0 为无效窗口或已被删除的窗口 )，如果 PWIN6不为视频信号类型值，则该值无效。具体规则与第 6 个整数 PWIN5 为处理器上的窗口次序值一样。第 10 个整数 PWIN9表示 RGB 窗口的次序值：PWIN9N，
11、表示为第 N 个 RGB信号窗口( 从 1 开始，0 为无效窗口或已被删除的窗口 )，如果 PWIN6不为 RGB 信号类型值，则该值无效。具体规则与第 6 个整数 PWIN5 为处理器上的窗口次序值一样。第 11 个整数 PWIN10 表示网络窗口的次序值：PWIN10N，表示为第 N 个网络信号窗口(从 1 开始，0 为无效窗口或已被删除的窗口 )。如果 PWIN6不为网络信号类型值，则该值无效。具体规则与第 6 个整数 PWIN5 为处理器上的窗口次序值一样。第 12 个整数 PWIN11 表示客户端连接 RS 服务时返回的连接 ID 号。 通过客户端 9获取服务端的状态的时候获取连接
12、ID第 13 个整数 PWIN12 表示进程窗口的次序值：PWIN12N ，表示为第 N 个进10程信号窗口(从 1 开始，0 为无效窗口或已被删除的窗口)，如果 PWIN6不为网络信号类型值，则该值无效。具体规则与第 6 个整数 PWIN5 为处理器上的窗口次序值一样。返回值：1） 创建窗口成功时，返回向所有客户端发送 50 个数据窗口数据。如果创建失败，说明想创建窗口的视频/RGB 窗口的次序值超出各自设置的最大窗口数，且向所有客户端回送该客户端发来的数据，且回馈命令标志 PWIN0=9，用于通知所有客户端该窗口是无效的，方便客户端更新窗口状态。2） 修改窗口成功时，如果信号输入口变更将返
13、回 5005 个整数的服务器端所有窗口状态值，回馈命令标示 DATA0=40,实际有效值为前 5001 个，后 4 个整数值忽略(不一定为前面提到的屏幕分辨率等值) ；同时窗口位置大小变化还会向各个客户端发送反馈数据包，详细看主动反馈数据包。修改失败，与创建窗口失败一样，回馈命令标志 PWIN0=9 的 13 个数据，失败原因也是窗口的视频/RGB 窗口的次序值超出各自设置的最大窗口数。3） 删除窗口时，也会向各客户端发送反馈数据包，详细看主动反馈数据包。四、 主动反馈数据包当 RS 服务端的窗口自己发生变化,如鼠标移动窗口,直接在处理器手动开窗 ,会主动反馈数据给所有客户端。数据长度一般为
14、12 个整数的窗口基本信息（有些由于 BUG，只有 11个整数或 16 个整数） 。第 1 个整数 PWIN0 为反馈命令标志：当 PWIN06 时，表示创建一个新窗口；当 PWIN02 时，表示改变一个窗口属性（如窗口大小，位置及输入信号等） ；当 PWIN09 时，表示删除一个 RGB 或视频窗口；当 PWIN08 时，表示删除一个网络窗口。五、 刷新所有窗口状态属性，一起发送数据包：当客户端需要一起创建窗口并同时删除原来显示窗口时,可同时向服务端 rs 发送1+50*10=5001 个整数, 在此用 SEND5001来代表 5001 个整数；第一个SEND0=8表示一起发送数据包的命令.
15、以后每 50 个整数表示一个窗口的属性，客户端在发送时可按连接时接受的 ECHO5005数据基础上把 ECHO0改成 8,然后对每个窗口属性的前 13 位数据填上所要显示的值.六、 设置单个 RGB/视频信号参数状态说明：前面窗口基本操作指令的修改指令主要修改的是基本窗口信息，这里是主要有设置RGB/视频信号的详细参数。发送格式：51 个整数，第一个整数 DATA0=41 为设置视频参数、DATA0=42 为设置RGB 参数。后面的 50 个参数为窗口状态属性，前面已经描述过，前 12 个参数为窗口的基本信息，这些参数在客户端发送时，最好保持原来的参数。其余的规则如下：1） DATA0=41
16、设置视频参数 ：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 以 PWIN19、PWIN31 PWIN34的值设置信号采样率和窗口剪切大小
17、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的值设置信号窗口垂直位移返回值：无七、 连接检查说明：用于确认 RS 服务端是
18、否连接着发送格式：发送二个整数 254 + 连接 ID返回值：服务端会返回 三个整数 254+连接 ID+254八、 读取窗口属性命令发送格式：客户端的程序向服务端发送一个 40 整数返回值：服务端回送1+50*100=5001个整数，在此用ECHO 5001来代表5001个整数；第一个ECHO0=40，为命令标志，表示回送窗口属性参数。以后每50个整数表示一个窗口的属性。九、 窗口最小化和恢复发送格式：1个命令标示整数+12个窗口基本信息整数DATA0=21 为窗口最小化 DATA0=22 窗口还原返回值：向所有客户端反馈数据包，详细看主动反馈数据包十、 获取可开窗的程序名单说明：用户进程开
19、窗的程序在RS服务端配置，详细看注意事项中的 3） ，当对某进程开窗时，在发送指令时PWIN7（包含命令标示PWIN0）写入需要开窗的程序名单Index。发送格式：一个整数56返回值：4字符 + ProcList3080，开头四个char都为1，后面为30个字符串，每个字符串（最大长度为80Char）代表一个进程名。十一、 字幕设置与关闭1） 字幕开启，先发送一个 1001 整数, 间隔 10ms 后再把以下结构发过去.显示字幕的结构定义: struct word_setupint left ; /字幕区域左边 int top; /字幕区域上边 int width; /字幕区域宽度int he
20、ight; /字幕区域高度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，然后返回以上字幕结构数据。
21、十二、 断开连接前指令说明：断开前必须发送该指令，标示将要断开连接。发送格式：两个整数，第一个为 10，第二个为连接 ID 号。返回值：无十三、 关闭 RS 服务端程序说明：用于关闭 RS 服务端程序。发送格式：发送一个整数 255返回值：无十四、 注意事项：1） 客户端连接数上限为 202） 客户端在关闭 Socket 连接前，必须先尝试接收完所有服务端发回的数据，否则服务端可能由于客户端强制断开，报 10053 的错误。3） 网络信号开窗其实是启动 RS 安装目录下 net 文件夹下的 PCAnywhere 远程连接文件的快捷键（实际上就是远程抓屏到处理器上） ，因此必须安装 PCAnyw
22、here 和设置相应连接远程电脑的快捷键，允许的快捷键上限个数为 30。对应配置文件为stringnet.dat，配置文件中依次每行写入快捷键名称。但是基本上已不再使用网络信号，快废弃了。4） 远程开进程，其实与网络信号一样，在 RS 安装目录下 Proc 文件夹下的界面应用程序的快捷键，允许的快捷键上限个数为 30。对应配置文件为 stringproc.dat，配置文件中依次每行写入快捷键名称。5） 回馈给客户端的数据长度，可能存在不一致的情况，长度 1351，013 主要是窗口的基本属性，1451 为扩展属性，第一个整数反馈命令标示，对于以上提到的所有反馈信息中，返回的数据有可能比描述的长一些，多余的数据可以忽略。 如果比描述少，也只少后面备用的数据，不影响实际应用的参数。6） 在发送窗口属性时，有可能对于某条指令大多数参数是无关的，但是也不能是任意值，这些值的默认应该是从服务器上读下来的状态，或客户端修改过的最终状态值。
