索引

• 概述
• 相对位置
• 偏移和旋转
• 图标参数
• 三维参数

概述

HT的GraphView二维拓扑和Graph3dView三维组件呈现图元信息时，一般可分为中心部位及label、note和icons等辅助部位， 这些附属部位的摆放位置就是本手册要介绍的内容，所有辅助部分都有共性的参数，同时针对不同图元也有特殊的参数， Graph3dView针对三维空间也有其特殊的参数定义，本手册将逐一进行详细说明。

相对位置

相对位置position是HT位置体系中最重要的参数，label.position，note.position以及icons上的position参数， 都是以1~55的数字的信息来描述相对于一个矩形区域的位置，对于ht.Edge和ht.Polyline的连线类型，可理解为高度为0的矩形。

    34                            35
   1 | 2     38     3     39     4 | 5
 ----6-------40-----7-----41-------8----
   9 | 10    42     11    43    12 | 13
     |                             |
     |              44             |
  14 15 16   45  46 17 47  48   18 19 20
     |              49             |
     |                             |
  21 | 22    50     23     51   24 | 25 
 ----26------52-----27-----53------28---
  29 | 30    54     31     55   32 | 33  
    36                            37

偏移和旋转

position相对位置一般会结合offset.x和offset.y参数，在position的基础上进行水平和垂直位置偏移， 如文字的label.offset.x和label.offset.y参数。对于label和icons类型还支持rotation旋转参数， 如文字的label.rotation.

图标参数

icons图标用于在图元上排放一个或一排的图标数组，其具有以下特殊的控制参数：

• gap：指定图标之间的间距
• direction：指定icons的排列方向，默认值为east，可设置为west、east、north或south
• rotationFixed：设置该参数为true将使得图标旋转不考虑连线角度，只由rotation决定
• keepOrien：当图标摆放在Edge和Polyline连线类型图元上时，图标默认自动调整方向以保持最好的阅读效果(比如文字)

例如箭头类型图标一般需要将keepOrien设置为true，保持与连线固定的角度：

'icons': {
    fromArrow: {
        position: 15,
        names: ['arrow'],
        rotation: Math.PI,
        keepOrien: true,
        width: 50,
        height: 25
    },
    toArrow: {
        position: 19,
        names: ['arrow'],
        keepOrien: true,
        width: 50,
        height: 25
    },
}

三维参数

Graph3dView三维组件中位置信息增加了face、t3、r3、rotationMode和autorotate等控制参数， 以label文字为例说明如下：

• label.face：默认值为front，文字在3D下的朝向，可取值left|right|top|bottom|front|back|center
• label.t3：文字在3D下的偏移，格式为[x,y,z]
• label.r3：文字在3D下的旋转，格式为[rotationX,rotationY,rotationZ]
• label.rotationMode：默认值为xzy，文字在3D下的沿三个轴旋转先后顺序，可取值xyz|xzy|yxz|yzx|zxy|zyx
• label.autorotate：默认值为false，文字在3D下是否自动朝向眼睛的方向，可设为true或y，y代表沿着y轴转动

注意：3D下不考虑以下的2D相关参数

• label.offset.x：被label.t3替代
• label.offset.y：被label.t3替代
• label.rotation：被label.r3替代