Project Looking Glass是Sun公司的3D桌面项目,是一个开放源代码项目,本文档对
这一项目的开发版做了一个介绍,对设置开发环境以及建造Project
Looking Glass及其3D应用程序的方法进行了解释。
如果您尚未设置运行环境,请参阅 开始Project Looking Glass开发版,了解相关信息。请检查您的系统配置,确保 满足Project Looking Glass的最低要求。
要想开发Project Looking Glass应用程序或对其功能进行增强,需要 安装几个组件,还要下载Project Looking Glass的源代码。
Project Looking Glass采用Apache ANT建造工具来管理建造过程。 如果您尚未安装ANT,需要到apache.org网站上下载其二进制文件:
http://ant.apache.org/
在java.net网站下的
LG3D开放源代码项目里
可以找到Project Looking Glass开发版的源代码。
如果您以前未曾在
java.net 网站上注册,那么您先要注册,
然后才能下载开发版的源代码。
下一步就该把Project Looking Glass源代码下载到您配置好的开发环境当中了。
从源代码建造Project Looking Glass的过程是由ANT建造文件(build.xml) 处理的,这个文件就在您的lg3d-core目录下。 进入该目录,运行ant来 建造Project Looking Glass:
% cd ~/projects/lg3d/lg3d-core您可以看到类似下列内容的输出信息:
% ant
Buildfile: build.xml
init:
[mkdir] Created dir: /home/username/projects/lg3d/lg3d-core/build/classes
unpack-x:
[untar] Expanding: /home/username/projects/lg3d/lg3d-core/ext/lg3d-x11.tar.gz into /home/username/projects/lg3d/lg3d-core/ext
compile:
[javac] Compiling 1 source file to /home/username/projects/lg3d/lg3d-core/build-tools
[javac] Compiling 626 source files to /home/username/projects/lg3d/lg3d-core/build/classes
compile-x11:
check-escher:
[javac] Compiling 25 source files to /home/username/projects/lg3d/lg3d-core/build/classes
init:
unpack-x:
native-x11:
[exec] .:/home/username/projects/lg3d/lg3d-core/src/../build/classes
junit-tests:
no-junit-tests:
[echo] Skipping junit tests because junit.jar is not installed in ext-unbundeled
compile-demo-apps:
[javac] Compiling 5 source files to /home/username/projects/lg3d/lg3d-core/build/classes
[copy] Copying 4 files to /home/username/projects/lg3d/lg3d-core/build/classes/org/jdesktop/lg3d/apps/cdviewer/resources
[copy] Copying 1 file to /home/username/projects/lg3d/lg3d-core/build/classes/org/jdesktop/lg3d/apps/tutorial/resources
[copy] Copying 1 file to /home/username/projects/lg3d/lg3d-core/build/classes/org/jdesktop/lg3d/apps/help/resources
jar:
[mkdir] Created dir: /home/username/projects/lg3d/lg3d-core/build/lib
[jar] Building jar: /home/username/projects/lg3d/lg3d-core/build/lib/lg3d-core.jar
all:
BUILD SUCCESSFUL
Total time: 32 seconds
Project Looking Glass可以按两种模式运行:一种是在现有桌面环境下的窗口模式 ,一种是全屏模式。这两种模式在开始Project Looking Glass 开发版文档的运行Project Looking Glass部分有介绍。
如果运行Project Looking Glass当中遇到问题,请参阅 开始Project Looking Glass 开发版文档中的问题解决部分。
要想随时获得Project Looking Glass最新版的源代码,您需要经常访问java.net cvs服务器,更新您的CVS workspace:
现在既然您已经成功建造了Project Looking Glass,何不浏览一下lg3d-core/
的目录结构,熟悉一下源程序?
Project Looking Glass源代码保存在 lg3d-core/src 目录下。 下面是lg3d-core源代码CVS仓库中各种文件的概括:
| 目录 | 描述 |
| build/ | 建造文件保存在这个目录下。 |
| build-tools/ | 建造Project Looking Glass
所需的工具。 |
| build.xml | Ant建造控制文件 |
| ext/ | 随Project
Looking Glass一起发布的各个组件,具体地说,包括escher (X11的Java绑定)
和一个lg3d-x11的稳定版本。 |
| ext-unbundled/ | 您可以把未获得许可
与Project
Looking Glass一起发行的组件放在这个目录下(例如:junit、Java3D loaders,等等)。
您还可以把自己建造的lg3d-x11放在这个目录下,而不用$LGX11HOME。 |
| src/ | lg3d-core源代码树的根目录。 |
| classes/ | 所有.java文件都存在这个目录中。 如欲了解更多信息,请到docs/javadoc/api 目录下,参阅二进制包的java文档。 |
| devscripts/ | 各种 Project Looking Glass开发脚本的源文件。这些脚本用来实现build/ 目录下的类。 |
| HelloUniverse |
在Project Looking Glass会话中运行JAVA 3D旋转立方体演示程序。 |
| README | 这个目录下部分脚本的文档。 |
|
Xtest |
用来测试Java X11类在没有X11支持的情况下运行状态的脚本。 |
| displayserver | 运行显示服务器。 |
| lg3d-dev | 以窗口模式运行Project
Looking Glass会话(这是“开发”模式,或"No X" 模式)。 |
|
lg3d-session |
在X11支持下以全屏模式运行Project
Looking Glass会话。 |
| setup | 供其它脚本使用的帮助脚本。 |
| etc/ | 包含各种配置文件。 |
| jz/ | 废弃。 |
| lg3d/ | |
| README | 各种lgconfig*文件的文档。 |
| lgconfig* | Project Looking Glass
可在其中运行的各种模式的配置脚本。 |
| logging.properties | 配置文件,用来控制显示服务器日志文件/var/tmp/lgserver.log当中日志输出的长度。 |
| displayconfig/ | 提供给高级用户,通过这个目录下的文件,您可以在更复杂的显示环境下运行Project Looking Glass,如多屏幕环境、立体环境或动力墙(power wall)。可选配置选项由lgconfig.xml文件控制。 警告!其它显示选项尚未通过全面测试! |
| native/org/jdesktop/lg3d/displayserver/fws/x11/ | 用于X11
集成的C代码。 |
| resources/images/ | Project Looking Glass
当中用到的各种图片。 |
| scripts/ | 用来运行Project
Looking Glass发行版本的脚本。这些脚本用来实现发行版本jar文件里的类。 |
| displayserver | 运行显示服务器(用户不应直接运行该文件)。 |
| lg3d-dev | 以窗口模式运行Project
Looking Glass会话(这种模式是“开发”模式,或“No X”模式)。 |
| lg3d-session | 在X11支持下以全屏模式运行Project
Looking Glass会话。 |
| setup | 供其它脚本使用的帮助脚本(用户不应直接运行该文件)。 |
| tests/ | Project Looking Glass
的测试软件包以后要放到这个目录下。 |
| www/ | java.net网站的网页以及各种文档。 |
申请LG3D项目的访问权限的过程:
Project Looking Glass包括几个3D程序范例,您可以通过这些例子来学习 怎样编写3D程序,以便充分发挥Project Looking Glass桌面环境的3D特性。 这些例子在lg3d-demo-apps 项目当中可以找到。
参阅:
开始Project
Looking Glass
Project Looking Glass开发版说明
为Project Looking Glass出力