最新软件版本: MaintainTool-v0.0.1-20241107.

如所用软件低于该版本,本文档描述可能有所差异,请索取最新版本软件再阅读本文档.

(软件右上角处查看软件版本)

一、基础知识

这里结合一个示例工程来进行说明.

所用灯带: 使用两种型号的线条灯, XT1(一米八段，即8个像素点), XT1b(一米两段，即2个像素点).  两种线条灯都是RGBW类型.

布局方式: 使用这两种型号的线条灯, 围绕楼体一圈, 一圈一共1128个像素点.   考虑电源及布线使用两个DMX控制器, 分别命名为A和B,这里都使用每个控制器的后5个端口即Port4~Port8.

总体效果如下所示(图中的一些标注在后续说明):

1.灯矩阵

        示例工程中,以左上角(即楼体的北立面与东立面交界点)作为这一圈像素点的起点,然后顺时针方向来对像素点做索引定位(即像素点1~1128).  

        如果我们把这一圈像素点拉直并二维化，那就可以得到一个(宽1128x高1)的点阵(也可以理解为列1128x行1的点阵).----->这里就将其称之为一个灯矩阵.

        其中每个像素点在这个点阵里面有一个(x,y)坐标,  比如左上角点 坐标为(x=1,y=1),右上角 点坐标为(x=202,y=1).

2.灯单元

  示例工程中每个色块表示一个灯单元，如左上角红色的这个"b+15"灯单元，一个XT1b+15个XT1连接而成，这个"b+15"灯单元有2*1+8*15=122个像素点,每个像素点颜色通道为RGBW即一个像素点占4个DM512通道.

        DMX512编址:为这个"b+15"灯单元进行DMX512编址1~244.    这里根据DMX512的通道地址与前面提到的(宽1128x高1)像素点阵中点的对应关系, 有两种编址方向: 像素点阵中(x=1,y=1)的点对应DMX512地址为1~4, 即像素点坐标与DMX512通道同向;  像素点阵中(x=122,y=1)的点对应DMX512地址为1~4,即像素点坐标与DMX512通道反向.即如下图：

为了方面描述，我们把这个"b+15"灯单元称为第1单元，然后按顺时针顺序剩下灯单元称为第2~10单元.那么对这个这一圈灯, 控制器A管理灯矩阵的第10单元+第1~4单元,控制器B管理灯矩阵的第5~9单元.

二、软件基本说明

布局如上图,功能区呈T型分布.上为功能按键,下右为功能导航区(灯矩阵树及效果树),下右为编辑区.

1.功能键

用来管理工程，依次为"新建工程"、"打开已有工程"、"保存工程"、"另存为工程".

用来管理灯矩阵,依次为"新建灯矩阵"、"删除选中的灯具或者灯矩阵".

用来管理效果,依次为"新建工程效果"、"删除选中的工程效果"、"复位选中的内置效果"、"复位所有内置效果(如果没有内置效果则生成全部的内置效果)".

以上按键如果为灰色则表明不可用，需要切换功能导航区或者需要选中相应的灯单元\灯矩阵\效果后才能使用.

2.功能导航区

        点击"Fixtues"和"Effects"在灯矩阵树及效果树间进行切换,相应的影响功能按键及编辑区.

3.编辑区

        在功能导航区为"Effects"时候，对效果参数进行编辑.效果分为内置效果和工程效果,内置效果仅用来编辑有限参数，用户无法删除和增加。用户可以增加和删除工程效果.

三、灯矩阵操作说明

        这里以示例工程说明.

        打开该软件, 会处在新建工程状态，先点击"新建灯矩阵"按键来建立灯矩阵，根据工程布局填入参数：

         工程名称(Project Name)

        线条灯的颜色通道顺序:这里根据使用线条灯类型选择RGBW.      

        Martix Width(Columns)填入灯矩阵的宽度1128, Martix Height(Rows)填入灯矩阵的高度1.

        然后点击"Add Fixture"添加灯单元.

        比如左上角红色的这个"b+15"灯单元:

                起名为"第1单元"

                连接到A控制器的端口5,所以Port选5.

                DMX512编址1~244，所以DMX起始地址填入1.

                像素点坐标与DMX512通道反向则Map选1，同向则Map选0.

                这个单元一共122个像素点，所以 DotsCouts处填122.

                该单元的像素坐标为(1,1)~(122,1)，所以  Dots Start  Column填1.   Dots Row填1.

        那么控制器A管理灯矩阵的第10单元+第1~4单元，总体配置如下:

        配置完后会看到灯矩阵树：

四、编辑效果

         在上面增加完灯矩阵后，在功能导航区点击"Effects"进行效果编辑。 对一个新建工程来说，效果树里面为空.

        先点击"复位所有内置效果(如果没有内置效果则生成全部的内置效果)"按键来添加内置效果.

        再点击"新建工程效果"来添加工程效果.(目前限定工程效果个数最大32).

对效果有以下参数可编辑.

效果名:

        这里分为Name1(用来填英文名)和Name2(用来填中文名).

        注意名称中不要有下划线"_".

效果类型(Pattern):

        "Static" 静态效果，显示一个颜色.

         "Steps" 跳变效果，在多个颜色间进行跳变.

        "Breathing" 呼吸效果,有暗变亮再变暗，且在多个颜色间交替.

        "Grandient"渐变效果,多个颜色间明暗交替

         "MarqueeFlow"跑马灯流动

         "ChasingFlow"追光流动

         "TrailFlow"拖尾流动

         "StreamFlow"流水流动

         "TransitionFlow" 明暗过渡流动

        "GradientFlow"渐变流动

   帧时间(Frame Durtaion):

            效果一帧画面维持的时间，通过调整该参数，可以控制效果速度. 40ms~60000ms可调.   

   色值数组(color arrays)  :

            可以多种色值,数据类型string,且使用十六进制方式(RGB值)，相邻色值用"_"连接.
            例如红色 "0xFF0000",绿色"0x00FF00".

            例如有红绿蓝3个颜色"0xFF0000_0x00FF00_0x0000FF".
            注意:理论上色值个数可以有很多，这里限定一下色值个数最多为16. 最少色值个数根据效果而定，有的最少1个色值，有的最少2个色值.          

       运行顺序(Run Order):

                可选 循环(Loop)、单次(Single Shot)、往复(PingPong).  默认循环(Loop)即可.

        方向(Direction)：

                可选正向(Forward)、反向(Backward).默认正向(Forward)即可.

        其余参数根据集体效果而定.

1.静态及跳变效果

         改变公共参数即可.

 2.呼吸效果

          最小亮度(min percent), 0%~90%,默认0%, 表示colorArrays中的色值最小百分比.
          最大亮度(max percent), 10%~100%,默认100%, 表示colorArrays中的色值最大百分比
          注意: min percent < max percent;这两参数用来微调效果中暗灭时候的显示，可维持默认值不动.
           min steps ,0~500,默认50步. 表示维持minPercent的步数(1步的时长即frame duration毫秒).
    
    例如color arrays=0xFF0000,min percent=0,max percent=100,min steps=50,duration=40ms时
    表示红色呼吸效果，亮度最低时候为0%*0xFF0000即黑，亮度最高时候为100%*0xFF0000即纯红.效果先[从0%(即黑)到100%(即纯红)一共101步，耗时101*40ms=4秒],然后再[从100%(即纯红)到0%(即黑)一共101步，耗时101*40ms=4秒],然后[维持0%(即黑)50步，耗时50*40ms=2s]
    表现为从黑到纯红(4s)，再到黑(4s)，然后维持黑2s.然后再从黑到红...

  3.渐变效果

       最小亮度(min percent), 0%~90%,默认0%, 表示colorArrays中的色值最小百分比.
       最大亮度(max percent), 10%~100%,默认100%, 表示colorArrays中的色值最大百分比
       注意: min percent < max percent;用来微调效果中暗灭时候的显示,可维持默认值不动.
       cross steps, 0~20,default 5步,表示颜色切换时候两种交错的步数.(1步的时长即frame duration毫秒).

4.跑马流动

        Hilite Length,5~100, default 30, 单位为像素点个数,即流动中明亮部分像素点个数.
        Dark Length,1~100, default 30, 单位为像素点个数,即流动中黑色部分像素点个数.

        Orientation ,"Horizontal"或者"Vertical", 默认"Horizontal",表示布局方向. Horizontal:水平布局，Vertical：垂直布局.
        Direction , "Right or Down" 或者 "Left or Up", 默认"Right or Down", 表示流动的方向.  
        当orientation=Horizontal时候，"Right or Down"表示从向右流动,"Left or Up"表示向左流动
        当orientation=Vertical时候，"Right or Down"表示从向下流动,"Left or Up"表示向上流动

5.追光流动

        Orientation,Direction,同跑马流动.

6.拖尾流动

         Hilite Length,Dark Length,Orientation,Direction,同跑马流动.

7.流水流动\明暗过渡流动 \渐变流动

         Hilite Length,Orientation,Direction,同跑马流动.

五、导出配置

        编辑完后，点击"保存工程"并命名导出配置. 此时会根据点击保存按键的时间戳在导出配置所选目录下生成一个名称形如"projectCfg_20241107_171653"的文件夹，用来做配置备份.

        如需将该配置下发给DMX控制器，则进入"projectCfg_20241107_171653"文件夹下，选中所有文件并压缩成zip包，然后通过平台或者APP下发给控制器.

        注意：zip压缩包下不要有多级目录,应该如下只有单层目录.

六、灯单元举例

灯单元指在灯矩阵中x坐标连续且y坐标一致的若干像素点,可以是一个线条灯也可以是多个线条灯.

在物理上这些线条灯连接在控制器的同一个端口的信号线上,在同一个DMX512编址范围内.几种举例如下(线条灯都为一米8个像素点，RGBW类型):

        a.一个32*3的灯矩阵，虽然只用了一个端口来控制所有像素,但是应该划分成了3个灯单元，即第1行、第2行、第3行.

        b.一个32*3的灯矩阵，每个端口控制一行像素点，划分成了3个灯单元，即第1行、第2行、第3行.如下图：

        c.一个384*1的灯矩阵，由于每个端口对RGBW类型灯来说最多控制512/4=128个像素点，所以用3个端口来分别控制行中的一部分.划分成了3个灯单元，即第1行的左段、第1行的中间段、第1行的右段.如下图：