WWJ SDK 是一种构建在 Java OpenGL (JOGL) 扩展之上的 3D 图形地球仪。WWJ 类层次结构的核心是 GLCanvas 的子类 WorldWindowGLCanvas。而 GLCanvas 是一个 Abstract Window Toolkit (AWT) 组件。

WWJ 对 AWT 的依赖性对于想在 Eclipse 应用程序中使用 WWJ 的 GIS 开发人员来讲是一个障碍。您可能知道，Eclipse 使用了 Standard Widget Toolkit (SWT)，而 SWT 与 AWT 不兼容。而且，AWT 和 JOGL 紧密集成，这使得很难从 AWT 移植到 SWT。本文将提供一种解决方案，使您可以在 Eclipse 应用程序中使用 WWJ SDK。

进入 SWT/AWT 桥梁

SWT 因能够快速构建可伸缩和强大的客户端应用程序而迅速成为一种顶级窗口工具包。SWT 和 AWT/Swing 都在争当 Java 用户界面开发的权威。由于它们各有利弊，Eclipse 基金会意识到有必要构建一座允许在 SWT 中嵌入 AWT/Swing 组件的 SWT/AWT 桥梁。从 Eclipse version 3.0 开始，这座桥梁就已成为 SWT 的一部分。这个的 API 位于 org.eclipse.swt.awt 包中（参见 参考资料）。

SWT/AWT 桥梁是通过 SWT 将基于 AWT 的 World Wind 3D Globe 嵌入到 Eclipse 应用程序中所需的关键组件。

WWJ 3D Earth 的 Eclipse 视图

借助 SWT 中已存在的 SWT/AWT 桥梁，可以轻松地将 WWJ 3D Earth 嵌入到您的视图中。清单 1 演示执行此任务的基本 Eclipse 视图：

                
package org.eclipse.plugin.worldwind.views;
_

/**
 * World Wind Eclipse RCP Earth View
 * @author Vladimir Silva
 *
 */
public class EarthView extends ViewPart
{
   private static final Logger logger = Logger.getLogger(EarthView.class);
   
   public static final String ID = EarthView.class.getName(); 
   final WorldWindowGLCanvas world = new WorldWindowGLCanvas();
   

   /**
    * Initialize the default WW layers
    */
   static {
      initWorldWindLayerModel();
   }

   public EarthView() {
      
   }
   
   /**
    * This is a callback that will allow us to create the viewer and initialize
    * it.
    */
   public void createPartControl(Composite parent) 
   {
      // GUI: an SWT composite on top
      Composite top = new Composite(parent, SWT.EMBEDDED);
      top.setLayoutData(new GridData(GridData.FILL_BOTH));
        
      // Swing Frame and Panel
      java.awt.Frame worldFrame = SWT_AWT.new_Frame(top);
      java.awt.Panel panel = new java.awt.Panel(new java.awt.BorderLayout());
      
      worldFrame.add(panel);

      // Add the WWJ 3D OpenGL Canvas to the Swing Panel
      panel.add(world, BorderLayout.CENTER);

      parent.setLayoutData(new GridData(GridData.FILL_BOTH));
        
   }

   /*
    * Initialize WW model with default layers
    */
   static void initWorldWindLayerModel () 
   {
      Model m = (Model) WorldWind.createConfigurationComponent(
            AVKey.MODEL_CLASS_NAME);

      world.setModel(m);
   }

   /**
    * Passing the focus request to the viewer's control.
    */
   public void setFocus() {
   }
   
   public static void repaint() {
      world.repaint();
   }

   @Override
   public void dispose() {
      super.dispose();
   }
   
}

清单 1 首先创建一个顶层 SWT 组件，该组件使用桥梁嵌入 WWJ swing OpenGL 画布：

Composite top = new Composite(parent, SWT.EMBEDDED);
top.setLayoutData(new GridData(GridData.FILL_BOTH));

其次，使用桥梁在顶层 SWT 组件中创建一个子 AWT 框架，用于保存 WWJ OpenGL 画布所需的 Swing panel：

java.awt.Frame worldFrame = SWT_AWT.new_Frame(top);
java.awt.Panel panel = new java.awt.Panel(new java.awt.BorderLayout());

最后，将 WWJ GL 画布添加到 Swing panel：

WorldWindowGLCanvas world = new WorldWindowGLCanvas();
panel.add(world, BorderLayout.CENTER);

图 1 展示了作为 Rich Client Platform (RCP) 应用程序的一部分嵌入到 Eclipse 视图中的 Earth：

在地球仪中飞往某地

如果想让应用程序在 Google Earth 风格下飞往特定的纬度/经度，则需要三个对象：

• View，该对象提供从模型坐标到眼睛坐标的坐标转换，转换规则遵循 OpenGL 的左手坐标系统惯例
  
  
• Globe，该对象表示您看到的世界的 3D 椭球体
  
  
• 您要到达的位置的纬度/经度坐标

可选信息包括飞行方向和倾斜的角度，以及以米为单位的海拔高度。

清单 2 演示如何飞往指定位置：

                
public void flyTo (LatLon latlon) 
{
   View view       = world.getView();
   Globe globe = world.getModel().getGlobe();
   
   view.applyStateIterator(FlyToOrbitViewStateIterator.createPanToIterator(
           (OrbitView)view
           , globe
           , latlon      // bbox
           , Angle.ZERO   // Heading
           , Angle.ZERO   // Pitch
           , 3e3 )       // Altitude/Zoom (m)
           );
}

View 类的 applyStateIterator() 方法移动或缩放地球仪，在地球仪的目标坐标上制造一种平稳飞行和即时缩放效果。

除 Earth 以外，WWJ 还捆绑了其他地球仪；WWJ v0.4.1 中可用的 3D 地球仪包括：

• Earth（参见 参考资料，获取包含的数据集）。
  
• Moon：40xx/30xx 颜色/灰度层，使用一组来自 Clementine 任务的光谱带创建
  
• Mars：包括来自 Mars Orbital Camera (MOC)、Elevation Maps 等任务的高分辨率图像，使用来自 NASA 喷气推进实验室和 NASA Mars Odyssey/THEMIS 的数据创建。

图 2 展示了以三种不同的 Eclipse 视图显示的 Earth、Moon 和 Mars：

回页首

结束语

World Wind Java SDK 是使用 Java 和 OpenGL 编写的 3D 交互式地球查看工具，它允许任何用户从外太空缩放 Earth 上的任何地方。本文介绍了将 WWJ SDK 作为一个 Eclipse 视图嵌入的基本原理，获得了一组在 Eclipse 中进行 GIS 开发的强大工具。

参考资料

学习

• 您可以参阅本文在 developerWorks 全球站点上的 英文原文 。
  
  
• World Wind Central：NASA World Wind SDK 的官方知识库和支持站点。
  
  
• WWJ 捆绑了以下低、中和高分辨率的数据集：
  • Blue Marble（分辨率：1 千米/像素）。
    
    
  • i-cubed Landsat 7（分辨率：15 米/像素），来自马里兰大学高级计算机研究所的 Global Land Cover Facility。
    
    
  • 海拔数据（来源于 SRTM30Plus/SRTMv2/USGS NED 的数据集），来自 NASA 喷气推进实验室的 SRTM 项目。
    
    
  • USGS 地形图、黑白垂直图像和彩色市区图像，由 USGS 和 Microsoft® 研究，可从 TerraServer 获得。
    
    
  • 美国地名，来自 USGS 地理名称信息系统。
    
    
  • 世界地名，来自美国国家地理空间情报局。
  
  
• SWT/AWT 桥梁：SWT_AWT 类的 Javadoc。
  
  
• “Swing/SWT Integration”（Gordon Hirsch，eclipse.org，2007 年）：本文重点讲述了使用 SWT/AWT 桥梁将现有 Swing 组件嵌入到基于 SWT 的 RCP 应用程序中。
  
  
• “利用开源 GIS 确定方位”（Frank Pohlmann，developerWorks，2005 年 5 月）：查阅面向 UNIX® 和 Linux® 用户的 GIS 工具。
  
  
• Eclipse 项目资源：面向 Eclipse 开发人员的丰富资源。
  
  
• 浏览 技术书店，查找关于这些和其他技术主题的图书。
  
  
• developerWorks Java 技术专区：查找关于 Java 编程各个方面的数百篇文章。
  
  

获得产品和技术

• NASA World Wind SDK：下载 World Wind Java SDK。
  
  
• Europa Simultaneous Release 项目：下载免费的 Eclipse Europa 捆绑软件。
  
  

讨论

• 查阅 developerWorks 博客 并加入 developerWorks 社区。
  
  

关于作者

Vladimir Silva 出生在厄瓜多尔的基多。他于 1994 年从 Polytechnic Institute of the Army 获得系统分析学士证书。同年，他为取得 Middle Tennessee State University 计算机科学硕士学位，作为一名交换学生来到美国。毕业后，他加入了 IBM Web Ahead 技术智囊团。目前，他是位于美国北卡州首府罗利的 Lockheed Martin 的一名网格工程师，工作职责是获得高性能和可视化。他还是 “Grid Computing for Developers” 一书的作者。

为本文评分

评论

回页首

内容

• 进入 SWT/AWT 桥梁
• WWJ 3D Earth 的 Eclipse 视图
• 在地球仪中飞往某地
• 结束语
• 参考资料
• 关于作者
• 建议