palette gef
在模型驱动的开发领域，模型扮演着重要角色。 通常，模型是通过二维图可视化的，UML图可能是最突出的示例。 但是，在某些情况下，二维根本不够。 有时，模型需要三维表示，或者应同时显示多个二维图。 后一种情况可以可视化所谓的图间关系，即不同图的元素之间的连接。 GEF3D [2]框架允许以非常简单的方式创建三维图编辑器。
GEF3D已在作者的博士学位中作为一种工具启动。 该项目，并在2008年秋天成为Eclipse项目。目前，该项目只有两个提交者–我们一直在寻求开源社区的更多帮助！ 由作者实现的图1，给人以GEF3D功能的印象。 正如Holger Voorman所预见的那样，将来在这里可以看到两层抽象，更准确地说是一个用例图，该用例图已转换为健壮性图（请参阅[3]）。 图的元素通过所谓的转换轨迹连接。 迹线是关系图之间关系的典型示例，在这种情况下，迹线连接转换的源元素和目标元素。
在Eclipse的世界中，（几乎总是）使用GEF [4]或GMF [5]（因此GMF基于GEF）创建图形编辑器。 GEF3D的基本思想是扩展GEF，以支持三维编辑器。 因此，可以使用与2D编辑器相同的技术和概念来实现3D编辑器–在大多数情况下，不需要3D编程方面的专门知识。 此外，GEF3D提供了适应现有2D编辑器的技术，以便在3D场景中使用它们-我们称这种现象为2D编辑器的“ 3D定位”。 只需一点努力就可以实现。 总体策略是将2D编辑器的输出投影到3D空间中的平面上，并对它们进行一些调整以启用3D编辑。 GEF3D中提供了一些示例编辑器来演示这一点：ecore编辑器（来自EMF工具[6]）或UML2工具中的类，活动和用例编辑器[7]。 实际上，图1显示了UML2工具编辑器的3D立体版本。
下面，我们将更详细地介绍GEF3D。 在简要解释了GEF之后，我们将描述GEF3D如何扩展GEF。 然后，我们将使用GEF创建一个小型2D编辑器，然后再用3D-fy创建该编辑器。
了解GEF3D需要具备GEF的一些基本知识。 因此，我们首先强调GEF的一些设计特征，其次描述如何将这些特征用于3D合成。 图2作为指导，说明了GEF和GEF3D中使用的主要类别和模式。 不用担心，乍一看这个数字看起来有点不知所措，但是情况很快就会变得清楚起来。 我们将从内到外描述图中所示的元素。
在GEF的中心，我们可以识别模型视图控制（MVC）模式，因此它也显示在图2的中心（浅蓝色背景）。 MVC的实现非常精细，也就是说，对于每个可编辑项，都需要MVC三元组。 例如，对于该图，每个节点，甚至每个应可编辑的标签，您将需要一个MVC三元组。 包含数据的模型可以通过简单的Java类实现，而无需实现任何接口或扩展特殊类。 但是，该模型通常使用Eclipse建模框架（EMF [8]）来实现，如果使用GMF，甚至需要EMF。 视图部分由GEF附带的名为Draw2D的单独插件实现。 元素通过所谓的数字可视化。 图形以树的形式构造，其根包含在名为LightweightSystem的类中。 轻量级系统是图形和SWT之间的一种适配器。 它将数字绘制到SWT画布上，并将事件从SWT委托给GEF。 如前所述，必须为每个可编辑元素提供一个控制器。 控制器由所谓的EditParts实现 ，它们不仅处理事件，还创建图形。 与其他MVC实现相反，控制器是GEF中MVC三元组中最重要的部分，它是图形和模型之间的中介。 特别是，该图不听模型，甚至根本不依赖模型元素。 就像图一样， EditPart也被组织成一棵树。
现在，我们将重点放在下一层，即图2中蓝色背景上绘制的元素。这些元素仍然是GEF的一部分，我们从EditPolicy的右侧开始，并沿逆时针方向在圆周围徘徊。 EditPart（扮演控制器的角色）必须完成许多任务：从管理项目选择到创建元素，再到更多特定于应用程序的任务。 为了避免怪物类（带有意大利面条代码），策略模式（也称为策略模式）用于将功能提取到单独的类中，称为策略类。 如果需要，将“安装”策略并调用该策略以管理特定任务。 除了减小EditPart的大小外，还可以动态更改其行为。 这可以通过简单地安装新策略或在运行时替换现有策略来完成。 我们将进行后者，以便将3D功能添加到已创建的EditParts中。 Apropos创建：从图中可以看出， EditPart是使用工厂模式创建的，工厂在这里称为EditPartFactory 。 EditPartViewer是一个将所有零件放在一起的容器：它包含对工厂的引用，它包含已经说明的LightweightSystem，并且还包含编辑零件树的根（图中未显示）。 查看器本身是GraphicalEditor的一部分，它是Eclipse平台的接口，它通过Eclipse插件机制注册为编辑器。
总而言之，MVC实现了关注点分离，尤其是可视化与内容分离。 可以使用策略来动态修改（控制器的）行为，使用工厂创建控制器本身。 稍后我们将看到，这些设计模式将在以后用于3D-fy现有编辑器。
GEF3D概述
最后但并非最不重要的一点，我们看一下外圈（红色），其中显示了GEF3D提供的类。 这次我们从图2的底部开始，然后顺时针移动。 最本质上，我们必须在二维视图中添加一个新维度。 这意味着我们必须替换MVC三元组的view元素。 由于控制器应该能够使用新的三维视图，因此我们只需扩展原始图形，我们启用3D的子类称为Figure3D。 现在我们不必使用SWT-Canvas绘画，而必须使用OpenGL进行渲染，而现在必须使用称为GLCanvas的3D画布。 实际上，GEF3D不依赖于任何特定的3D渲染库。 相反，必须实现通用接口以适应具体的渲染库。 当前，存在用于LWJGL [10]的适配器，并且计划用于JOGL [11]的适配器。 因此，提供了轻量级系统的3D版本，LightweightSystem3D和对应的GraphicalViewer3D。 查看器是由编辑器创建和配置的，还提供了3D编辑器的基本版本，尽管在大多数情况下，现有的2D编辑器类是子类的，我们将在后面看到。
基本上，这些是GEF3D的最重要的类，并且可以使用这些类构造3D编辑器。 大多数3D特定问题是由GEF3D在后台处理的，对3D编辑器进行编程与对2D编辑器进行编程非常相似。 例如，GEF3D处理3D场景中的元素选择（称为“拾取”）或提供用于导航的摄像机。 对于客户端代码，坐标透明地从2D转换为3D，反之亦然。 当要重用现有的2D代码时，这特别有用，我们将在后面看到。
调整模式
为了为3D编辑器利用GEF的大多数概念和技术，付出了很多努力。 结果，现有的2D编辑器只需很少的更改就可以进行3D处理，编辑器的大部分可以不变地重复使用。 尤其是为了适应现有的编辑器，GEF3D提供了新的模式并利用了现有的模式。 策略模式在所有这些方法中都起着关键作用，因为它可以在运行时修改行为，而无需更改实际代码。 这个想法很简单：适用于二维应用程序的现有策略将由适当的3D版本替换。 幸运的是，由于大多数功能独立于图形表示，因此仅需交换少量策略。
通常，在3D处理过程中不应更改现有的2D代码。 而是将在3D场景中启用原始2D编辑器所需的完整3D相关代码放置在独立的插件中，该插件取决于原始2D插件。 原始类尽可能多地被重用，并且由于代码未更改，因此它们的行为在运行时会更改。 用来更改现有EditParts行为的中央模式称为Borg Factory –如果这使您想起Start Trek，则您并不完全错误。 Borg Factory模式所涉及的类显示在图2的右上方。首先，一个所谓的BorgFactory替换了原始的EditPartFactory，原始工厂嵌套在BorgFactory中–这与代理模式非常相似。 。 为了执行某些修改，可以在BorgFactory注册所谓的同化器。 当要创建一个新元素时，顺序如下：首先，嵌套的原始工厂基于给定的模型元素创建EditPart。 创建EditPart之后，它将传递给已注册的同化器。 他们现在可以修改创建的EditPart，例如，可以添加或删除策略。 如果修改EditPart太难了，甚至可以完全替换它-“电阻是徒劳的”。
当修改的编辑器与其他编辑器结合使用时，需要图2中所示的其他模式，“多工厂”模式和“连接的元素”模式。 这两种模式将在后续文章中进行解释。
图形编辑器示例现在，我们将看一个具体的示例，以说明如何使用GEF3D和新模式。 在下文中，我们将为具有节点（称为顶点）和连接（边缘）的图形实现非常简单的编辑器。 首先，我们将使用GEF实施2D编辑器，然后使用3D-fy编辑器。 最终结果如图3所示。该屏幕截图显示了如何移动两个节点，您可以看到GEF3D显示了3D手柄和3D反馈图形。
无论我们是否创建2D或3D编辑器，都必须首先创建一个模型。 最简单的方法是使用EMF。 用于示例编辑器的EMF模型如图4所示，该模型是使用ecore图表编辑器创建的[6]。
根据该模型，EMF可以自动生成Java实现。 由于我们以后要使用向导来创建模型，因此也将生成编辑和编辑器代码。
现在，我们必须实现作为插件创建的2D编辑器。 广义上讲，我们必须为模型元素实现一个编辑器类，编辑零件工厂以及视图和控制器类。 GEF使用命令模式修改了元素。 也就是说，元素不会由策略类的编辑部分直接更改，而是由策略创建适当的命令，然后执行修改。 因此，我们必须创建一些用于创建或修改元素的命令（在此省略用于删除元素的命令），并实现创建这些命令的相应策略。 下表列出了示例编辑器所需的所有类。 可以在GEF网站[3]上找到有关GEF的更多信息，在EMFs网站[8]上可以找到有关EMF的信息，示例编辑器的源代码是GEF3D示例的一部分（为简化起见，GEF3D图形示例包含非EMC模型，您可以在以下位置找到3D格式的图形编辑器：
org.eclipse.gef3d.examples.graph.editor.GraphEditor2D_3Dfied ）。| 类/文件 | 描述 |
| GraphEditor2D | 插入Eclipse的Editor类，在此处配置了带有其类的编辑器（例如EditPartFactory和Palette），并加载了模型 |
| GraphEditPartFactory | 用于根据给定的模型元素创建EditParts工厂。 |
| GraphEditPart, VertexEditPart, EdgeEditPart | 显示元素的控制器。 控制器为其模型元素提供服务，并相应地刷新视图。 此外，他们负责将模型映射到显示的图形元素。 |
| GraphFigure, VertexFigure, EdgeFigure | 显示模型元素的图。 |
| VertexCreateCommand, VertexResizeCommand, EdgeCreateCommand | 用于创建或更改（模型）元素的命令。 这些命令由下面列出的策略自行创建。 |
| GraphLayoutPolicy, VertexEditPolicy | 用于创建上述命令的策略。 顶点命令由GraphLayoutPolicy创建，边缘命令由VertexEditPolicy 。 策略安装在编辑部分。 |
| plugin.xml | 该编辑器必须在Eclipse平台上注册，其扩展点是org.eclipse.ui.editors 。 |
为了在3D场景中使用先前创建的2D编辑器，只需要进行一些修改即可：不需要三个以上的类。 在GEF3D中，将2D内容投影到3D场景中的平面上。 因此，几乎可以重复使用2D编辑器的几乎所有部分，而无需进行任何修改。 由于我们要使用平面而不是2D区域，因此仅需替换显示图形的图形（在GraphFigure示例中）。 GraphEditPart也必须更改，因为我们必须立即创建3D图形，而不是2D图形。 我们分别将3D类称为GraphFigure3D和GraphEditPart3D 。 GraphEditPart3D是GraphEditPart的子类，修改很小：创建GraphFigure3D而不是创建2D图形。 表2列出了3D-fy编辑器所需的所有三个类（和插件文件）。
| 类/文件 | 描述 |
| GraphEditor3D | 3D编辑器将2D编辑器子类化。 修改了编辑零件的工厂，并创建了新的摄影机工具，以使用户能够在3D场景中导航。 |
| GraphEditPart3D | 3D平面的图表编辑部分是原始2D版本的子类（在这里为GraphEditPart ），唯一的修改是创建3D图形而不是2D图形。 |
| GraphFigure3D | 代替2D图形，将创建3D平面（即长方体）。 该图的元素投影到该平面上。 |
| plugin.xml | 3D编辑器也必须在Eclipse平台上注册，再次使用扩展点org.eclipse.ui.editors 。 |
显示该图本身的图形（即GraphFigure3D ）必须从头开始创建，原始2D图形无法重复使用。 但是，GEF3D提供了一些基础数据，这使其非常简单，在大多数情况下，不需要3D编程知识。 为了给的3D元素是如何与GEF3D中实现的印象，GraphFigure3D的整个代码是下面列出：
public class GraphFigure3D extends ShapeFigure3D {
private ISurface m_surface = new FigureSurface(this);
public GraphFigure3D() {
SurfaceLayout.setDelegate(this, new FreeformLayout());
getPosition3D().setLocation3D(IVector3f.NULLVEC3f);
getPosition3D().setSize3D(new Vector3fImpl(400,300,20));
setBackgroundColor(ColorConstants.white);
setAlpha((byte) 0x44);
}
@Override
public ISurface getSurface() {
return m_surface;
}
@Override
protected Shape createShape() {
return new CuboidFigureShape(this);
}
}- 代替GraphicalViewer ，必须创建GraphicalViewer3D 。
- 为了在3D场景中导航，必须安装摄像头。 这可以通过添加特殊工具（ CameraTool ）来完成。
- 代替2D图元素，必须创建先前创建的3D图图形（及其编辑器部分）。 此外，所有EditPart都将被修改为可在3D视图中进行编辑。 例如，应使用这些项目的3D版本，而不是二维的手柄和反馈图，如图4所示。
@Override
protected void createGraphicalViewer(Composite i_parent) {
GraphicalViewer3DImpl viewer = new GraphicalViewer3DImpl();
Control control = viewer.createControl3D(i_parent);
setGraphicalViewer(viewer);
configureGraphicalViewer();
hookGraphicalViewer();
initializeGraphicalViewer();
control.addDisposeListener(viewer.getLightweightSystem3D());
}protected PaletteRoot getPaletteRoot() {
PaletteRoot root = super.getPaletteRoot();
PaletteDrawer drawer = new PaletteDrawer("GEF3D");
drawer.setDescription("GEF3D tools");
drawer.add(new ToolEntry("Camera", "Camera Tool", null, null,
CameraTool.class) {});
root.add(0, drawer);
return root;
}protected BorgEditPartFactory createBorgFactory(
EditPartFactory originalFactory) {
BorgEditPartFactory borgFactory = new BorgEditPartFactory(originalFactory);
// replace diagram edit part
borgFactory.addAssimilator(new EditPartReplacer(GraphEditPart.class,
GraphEditPart3D.class));
// modify diagram edit part's policies
borgFactory.addAssimilator(new AbstractPolicyModifier() {
public boolean match(EditPart part) {
return part instanceof GraphEditPart3D;
}
public void modifyPolicies(EditPart io_editpart) {
// feedback when creating a node:
io_editpart.installEditPolicy(
ShowLayoutFeedbackEditPolicy3D.ROLE,
new ShowLayoutFeedbackEditPolicy3D());
// handles and feedback when moving or resizing a node
io_editpart.installEditPolicy(
Handles3DEditPolicy.CHILD_DECORATOR,
new Handles3DEditPolicy());
}
});
// modify node edit part's policies
borgFactory.addAssimilator(new IAssimilator.InstanceOf(
NodeEditPart.class) {
public EditPart assimilate(EditPart io_editpart) {
// feedback when drawing a connection
io_editpart.installEditPolicy(
ShowSourceFeedback3DEditPolicy.ROLE,
new ShowSourceFeedback3DEditPolicy());
return io_editpart;
}
});
return borgFactory;
}protected void configureGraphicalViewer() {
super.configureGraphicalViewer();
EditPartFactory originalFactory =
getGraphicalViewer().getEditPartFactory();
BorgEditPartFactory borgFactory = createBorgFactory(originalFactory);
getGraphicalViewer().setEditPartFactory(borgFactory);
ScalableFreeformRootEditPart root = new ScalableFreeformRootEditPart3D();
getGraphicalViewer().setRootEditPart(root);
}- org.eclipse.draw3d
- org.eclipse.draw3d.geometry
- org.eclipse.draw3d.graphics3d
- org.eclipse.draw3d.lwjgl
- org.eclipse.draw3d.ui
- org.eclipse.gef3d
- org.eclipse.gef3d.ext
palette gef
197
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
