HT for Web 中Painter的介绍及用法

鉴于许多同学对Painter不熟悉，所以撰写此文介绍下。Painter的中文意思是画家、漆工，那放到HT里是什么意思呢？很简单，这是HT特有的一种接口，允许开发者在拓扑及其它通用组件上使用Canvas画笔自由绘制内容，现在我们做个例子看一下如何使用Painter。 

这个例子中我们在拓扑组件的背景上绘制马赛克背景，可以在这里试玩，代码如下： 

Js代码  

1. gv.addBottomPainter(function(g) {//g为CanvasRenderingContext2D实例  
2.     var viewRect = gv.getViewRect();// 获取可视范围  
3.         var zoom = gv.getZoom();  
4.   
5.         var startX = viewRect.x;  
6.         var endX = startX + viewRect.width;  
7.         var startY = viewRect.y;  
8.         var endY = startY + viewRect.height;  
9.           
10.         g.save();  
11.         g.beginPath();  
12.         g.fillStyle = "#ddd";  
13.         // 绘制马赛克，只绘制灰色方块，白色方块不绘制以显示网页的白色背景  
14.         for (var i = startX, ii = 0; i < endX; i += 10 / zoom, ii++) {  
15.             for (var j = startY, jj = 0; j < endY; j += 10 / zoom, jj++) {  
16.                 // 绘制规则为奇数行绘制奇数列方块，在偶数行中绘制偶数列方块  
17.                 if ((ii % 2 != 0 && jj % 2 != 0)   
18.                        || (ii % 2 == 0 && jj % 2 == 0)) {  
19.                     g.rect(i, j, 10 / zoom, 10 / zoom);  
20.                 }  
21.             }  
22.         }  
23.         g.fill();  
24.   
25.         g.restore();  
26. });  

可以看到这个接口本身是非常简单的，只要调用addBottomPainter，传入一个函数即可。 
这里我们用到GraphView#addBottomPainter这个API，顾名思义，这是在我们拓扑的底部加一个Painter，示意图如下： 

 

可见BottomPainter是绘制在拓扑原有节点连线下面的，并且我们可以加多个bottomPainter。 

聪明的同学们可能想到了，既然有BottomPainter，那有没有TopPainter呢？答案是：有！TopPainter的结构是下面这样： 

 

可以看到，TopPainter是绘制到拓扑原有节点连线上面的，也就是说它会遮挡拓扑内容。那么TopPainter有什么用呢？一个典型的例子是做版权声明，大家可以试玩这个例子，关键代码如下： 

Js代码  

1. tableView.addTopPainter(function(g) {  
2.         g.beginPath();  
3.         g.strokeStyle = 'cornflowerblue';  
4.         var text = 'XXX版权所有';  
5.         g.font = '24px Arial';  
6.         g.strokeText(text, 60, -tableView.ty() + 50);// 使用ty()以保持文字浮动在固定位置  
7. });  

这个Painter的代码也很简单，用画笔画了一段文字，而且大家应该注意到了，不仅仅拓扑上可以用Painter，表格等通用组件也是可以使用的。 
       
Painter机制给开发者带来了极大的便利，从此组件的展示效果不再被局限到HT的内置样式里，开发者可以发挥想象实现各种绚丽的效果，大家快来试试吧，不如先实现一个网格线背景怎么样？