Draw2D为GEF提供一个轻量级图形显示系统(lightweight)，Draw2D在Eclipse中以插件的形式存在，即org.eclipse.draw2d。Draw2d依附与SWT Canvas heavyweight control 中，负责管理依附于的Canvas中的显示和鼠标事件，并把这些事件分离给 Draw2d的图形。在重量级图形系统（heavyweight graphics system）中，一个图形类似于一个窗口。他们能够拥有任意的、不规则的图形以及图形的嵌套，以此来支持复杂图形和控制的定制。在Draw2d中的图元可以被设置为透明或不透明、并且按照层次关系来放置。在Draw2d系统中的图可以被部分隐藏或者屏蔽某些特点操作。

一个LightweightSystem就是一个Lightweight graphics system，其依附于一个heavyweight control中。在LigweightSystem中的可视化对象都被视为窗口来对待，它们能够获得焦点、被选取、得到鼠标事件、拥有自己的坐标系统以及鼠标形状。他们每次获得一个图形环境（Graphic Context）来进行显示。LightweightSystem与native windows相比更方便。用户能够在其上绘制和操作任意形状的图形。LightweightSystem在heavyweight window中模拟heavyweight graphics system，因此利用他来显示复杂图形时，消耗的系统资源较少。

¨    LightweightSystem 是Draw2d系统的核心，主要提供SWT canvas到Draw2d系统的映射。LightweightSystem包括三个主要构件：

¨    EvnetDispatcher：负责将 SWT Events 转换为 Draw2d Events。跟踪焦点Figure、和鼠标事件的目标Figure、以及Figure的tooltip的激活。

¨    UpdateManager：当LightweightSystem接到一个从SWT canvas发送的绘制请求时，它调用UpdateManager中performUpdate()函数来执行Figure的绘制和更新。UpdateManager维护一个worklist其中包含了所有需要重新绘制或更新的图元。

¨    RootFigure：应用程序的Root figure，继承了依附于的SWT Canvas的图形环境、如字体、前景色、背景色等。

   Draw2d通过LightweightSystem与SWT的canvas（即SWT Composite）相连接，把鼠标和绘图事件传递给Draw2d中的Figures，为用户提供一个更为简单的视窗接口。这个canvas是一般是应用程序的shell，也就是frame。一个Draw2d的应用程序由SWT Composite(canvas)、LightweightSystem、内容(Figures)三个部分组成。其中Figures一般需要用户来提供。一个简单例子：

import org.eclipse.swt.widgets.Shell;

import org.eclipse.swt.widgets.Display;

import org.eclipse.swt.SWT;

import org.eclipse.draw2d.*;

import org.eclipse.draw2d.geometry.*;

public class HelloWorld {

               public static void main(String args[]){

                               Shell shell = new Shell();

                               shell.open();

                               shell.setText("Draw2d Hello World");

                               LightweightSystem lws = new LightweightSystem(shell);

                               IFigure label = new Label("Hello World");

                               lws.setContents(label);

                               Display display = Display.getDefault();

                               while (!shell.isDisposed ()) {

                                              if (!display.readAndDispatch ())

                                                             display.sleep ();

                               }

               }

}

用户需要提供SWT Composite和contents两个内容，剩余的部分LightweightSystem按照默认的设置来实现。其中EventDispatcher将swt composite接收到的消息转化为Draw2d的内部消息，并将其传递给RootFigure。UpdateManager处理图形的位置和显示请求。Root Figure是通过LightWeightSystem的setContents(IFigure figure)函数来设置。在RootFigure中配置了Layout Manager 来负责对后续添加到RootFigure下的孩子Figure的位置进行控制。

 

Figure

  具有的功能如下：

1．   注册和撤销Listener；把图形接收到的鼠标消息发送给Listener。

2． 产生 Structual event ，当图形的位置和大小发生变化。

3． 对位置、大小、Layout Manager、tooltip的获取。

4． 设置鼠标移动到图元上的形状。

5． 删除、添加、获取图元的子图元和父图元。

6． 设置或获得焦点。

7． 控制图形的透明性和可见性。

8． 执行图形的点击点测试、坐标转换、区域重叠计算。

 

Graphics Context

  与其他图形系统类似。用户可以绘制和设置图形或绘制文本，Context中也保存了前景色、背景色、当前字体等信息。Figures的Paint方法是由LightweightSystem来调用，并且将Graphics Context以参数形式传递到这个函数。

 

Draw2d调用Figure的paint()方法来显示图元。paint()方法激活下列三个方法。

¨    paintfigure() — The figure should render itself.

¨    paintclientarea() — The figure should render its children.

¨    paintborder() — The figure should render its border, if any. Clipping is used to protect the border.

具体代码如下，可见字体、前景色、背景色的设置都在此。

public void paint(Graphics graphics) {

       if (getLocalBackgroundColor() != null)

              graphics.setBackgroundColor(getLocalBackgroundColor());

       if (getLocalForegroundColor() != null)

              graphics.setForegroundColor(getLocalForegroundColor());

       if (font != null)

              graphics.setFont(font);

 

       graphics.pushState();

       try {

              paintFigure(graphics);

              graphics.restoreState();

              paintClientArea(graphics);

              paintBorder(graphics);

       } finally {

              graphics.popState();

       }

}

 

Connection router

Connection router用来计算连接两端Anchor的路径。AbstractRouter是所有connection

Router的基类，它实现了ConnectionRouter 接口。以下介绍几种router：

¨    NullConnectionRouter 简单的在两个Anchor之间绘制直线。

¨    BendpointConnectionRouter 支持用户手动加入折点，这些折点由用户通过托拽线段来设置。

¨    ManhattanConnectionRouter 通过垂直或者水平的线段来支持用户连接之间的折点。