WWJava FAQ
From World Wind Wiki
| Revision as of 21:22, 12 May 2007 (edit) Mkpl (Talk | contribs) (→Will World Wind Java run on my operating system?) ← Previous diff |
Revision as of 21:32, 12 May 2007 (edit) (undo) Mkpl (Talk | contribs) m Next diff → |
||
| Line 1: | Line 1: | ||
| - | ===What is NASA World Wind Java?=== | + | ==What is NASA World Wind Java?== |
| NASA World Wind Java is an [http://en.wikipedia.org/wiki/Software_development_kit SDK] aimed at developers who want to create their own virtual globe applications. | NASA World Wind Java is an [http://en.wikipedia.org/wiki/Software_development_kit SDK] aimed at developers who want to create their own virtual globe applications. | ||
| - | ===General questions=== | + | ==General questions== |
| - | ====How can I download WWJ?==== | + | ===How can I download WWJ?=== |
| To download the SDK (source code, documentation and sample application) visit [[World Wind Java Download]]. | To download the SDK (source code, documentation and sample application) visit [[World Wind Java Download]]. | ||
| If you only want to play with the sample application go to [http://worldwind.arc.nasa.gov/java/ NASA World Wind Java] page and launch WWJ using Java Web Start technology. | If you only want to play with the sample application go to [http://worldwind.arc.nasa.gov/java/ NASA World Wind Java] page and launch WWJ using Java Web Start technology. | ||
| - | ====Will World Wind Java run on my operating system?==== | + | ===Will World Wind Java run on my operating system?=== |
| The NASA World Wind Java SDK is platform independent. The demo has succesfully been run under Ubuntu, Microsoft Windows, Mac OS X and Fedora Core 6. | The NASA World Wind Java SDK is platform independent. The demo has succesfully been run under Ubuntu, Microsoft Windows, Mac OS X and Fedora Core 6. | ||
| - | =====Running under 64-bit Linux===== | + | ====Running under 64-bit Linux==== |
| - | Without installing the AMD64 version of JOGL you will likely see errors like: | + | Without installing the AMD64 version of JOGL you will likely see errors like |
| ''Exception in thread "main" java.lang.UnsatisfiedLinkError: no gluegen-rt in java.library.path'' | ''Exception in thread "main" java.lang.UnsatisfiedLinkError: no gluegen-rt in java.library.path'' | ||
| - | or: | + | or ''Exception in thread "main" java.lang.UnsatisfiedLinkError: ~/wwj/libgluegen-rt.so: ~/wwj/libgluegen-rt.so: wrong ELF class: ELFCLASS32'' |
| - | ''Exception in thread "main" java.lang.UnsatisfiedLinkError: ~/wwj/libgluegen-rt.so: ~/wwj/libgluegen-rt.so: wrong ELF class: ELFCLASS32'' | + | |
| To get it working: | To get it working: | ||
| Line 21: | Line 20: | ||
| worldwind.jar:./jogl.jar:./gluegen-rt.jar $1 | worldwind.jar:./jogl.jar:./gluegen-rt.jar $1 | ||
| :(Note: the only change is the addition of ''-Djava.library.path=.'') | :(Note: the only change is the addition of ''-Djava.library.path=.'') | ||
| - | + | ===What are the system Requirements?=== | |
| - | ====What are the system Requirements?==== | + | |
| A 3D video card with updated drivers and [http://java.com/getjava Java 1.5 or 1.6] are necessary. World Wind has been tested on Nvidia, ATI/AMD, and Intel platforms using Windows, MacOS 10.4, and Fedora Core 6. | A 3D video card with updated drivers and [http://java.com/getjava Java 1.5 or 1.6] are necessary. World Wind has been tested on Nvidia, ATI/AMD, and Intel platforms using Windows, MacOS 10.4, and Fedora Core 6. | ||
| - | =====How do I update my drivers?===== | + | ====How do I update my drivers?==== |
| Under Microsoft Windows follow the [http://worldwind.arc.nasa.gov/java/video.html NASA Java driver update guide]. | Under Microsoft Windows follow the [http://worldwind.arc.nasa.gov/java/video.html NASA Java driver update guide]. | ||
| - | ====What's the best way to run a World Wind program or demo?==== | + | ===What's the best way to run a World Wind program or demo?=== |
| The README file in the release distribution gives the command-lines to use, or use the Ant | The README file in the release distribution gives the command-lines to use, or use the Ant | ||
| targets given in build.xml. | targets given in build.xml. | ||
| - | You can run the basic demo by double-clicking on worldwind.jar, | + | You can run the basic demo by double-clicking on ''worldwind.jar'', |
| but the demo will run only a minute or two because it requires more Java heap space | but the demo will run only a minute or two because it requires more Java heap space | ||
| than the JVM provides by default. The Ant targets and the command lines given in the README | than the JVM provides by default. The Ant targets and the command lines given in the README | ||
| set the appropriate JVM arguments. | set the appropriate JVM arguments. | ||
| - | ====Are there any JVM arguments that need to be set when running a World Wind program?==== | + | ===Are there any JVM arguments that need to be set when running a World Wind program?=== |
| Yes. The max heap space needs to be set to 512 Mb or better, and the no-direct-draw argument | Yes. The max heap space needs to be set to 512 Mb or better, and the no-direct-draw argument | ||
| needs to be set to tell Java 2D not to use DirectDraw (Windows only). | needs to be set to tell Java 2D not to use DirectDraw (Windows only). | ||
| The README and build.xml show how to set these. | The README and build.xml show how to set these. | ||
| - | ====Why are the World Wind Java demos missing features of World Wind 1.4?==== | + | ===Why are the World Wind Java demos missing features of World Wind 1.4?=== |
| NASA World Wind Java is an SDK. It is meant for developers and not end users. The bundled application and webstart on the NASA Java page are just simple demos to show how to get started with the SDK. | NASA World Wind Java is an SDK. It is meant for developers and not end users. The bundled application and webstart on the NASA Java page are just simple demos to show how to get started with the SDK. | ||
| - | =====What are the controls for the bundled demo?===== | + | ====What are the controls for the bundled demo?==== |
| See the [http://worldwind.arc.nasa.gov/java/index.html NASA World Wind Java page] for the default controls. | See the [http://worldwind.arc.nasa.gov/java/index.html NASA World Wind Java page] for the default controls. | ||
| - | ====Why do I get a blank screen?==== | + | ===Why do I get a blank screen?=== |
| A blank screen is typically caused by out of date graphics drivers. Please update them from the graphics card manufacturer. | A blank screen is typically caused by out of date graphics drivers. Please update them from the graphics card manufacturer. | ||
| - | ====Will there ever be a World Wind Java client?==== | + | ===Will there ever be a World Wind Java client?=== |
| The goal is 100s of World Winds, not one. | The goal is 100s of World Winds, not one. | ||
| That's why NASA created WWJ as a Java component. | That's why NASA created WWJ as a Java component. | ||
| NASA has no plans to create a World Wind Java client similar to World Wind .Net. | NASA has no plans to create a World Wind Java client similar to World Wind .Net. | ||
| They plan only to continue to develop and expand the SDK. | They plan only to continue to develop and expand the SDK. | ||
| - | ====How do I determine whether a World Wind program gives any error or warning messages?==== | + | ===How do I determine whether a World Wind program gives any error or warning messages?=== |
| World Wind uses Java logging exclusively to communicate error and warning messages. | World Wind uses Java logging exclusively to communicate error and warning messages. | ||
| To have the messages printed to standard output, set the JVM argument | To have the messages printed to standard output, set the JVM argument | ||
| - | -Djava.util.logging.config.file=logging.properties and make sure the ".level" line in the | + | -Djava.util.logging.config.file=logging.properties |
| - | logging.properties file (included in the release) says | + | and make sure the ''.level'' line in the ''logging.properties'' file (included in the release) says |
| "FINE", "FINER" or "FINEST". | "FINE", "FINER" or "FINEST". | ||
| - | ===Development specific questions=== | + | ==Development specific questions== |
| - | ====What is the status of the SDK? Is it a pre-alpha, an alpha, a beta or a release... or something else? Is it safe to start coding an application around it?==== | + | ===What is the status of the SDK? Is it a pre-alpha, an alpha, a beta or a release... or something else? Is it safe to start coding an application around it?=== |
| The WWJ release as of May 11, 2007 is an early-access release. | The WWJ release as of May 11, 2007 is an early-access release. | ||
| The code and the API will continue to evolve, although the architecture will remain the same. | The code and the API will continue to evolve, although the architecture will remain the same. | ||
| Line 65: | Line 63: | ||
| The architecture is largely defined by pure interfaces. | The architecture is largely defined by pure interfaces. | ||
| To replace a component, just implement the relevant interface(s). | To replace a component, just implement the relevant interface(s). | ||
| - | ===Bug Reporting=== | + | ==Bug Reporting== |
| - | ====Where do I report bugs or request new features?==== | + | ===Where do I report bugs or request new features?=== |
| You can ask questions on the [http://forum.worldwindcentral.com/forumdisplay.php?f=37 World Wind Java forums], or report specific issues using the [http://issues.worldwind.arc.nasa.gov/browse/WWJ NASA issue tracker]. | You can ask questions on the [http://forum.worldwindcentral.com/forumdisplay.php?f=37 World Wind Java forums], or report specific issues using the [http://issues.worldwind.arc.nasa.gov/browse/WWJ NASA issue tracker]. | ||
Revision as of 21:32, 12 May 2007
What is NASA World Wind Java?
NASA World Wind Java is an SDK aimed at developers who want to create their own virtual globe applications.
General questions
How can I download WWJ?
To download the SDK (source code, documentation and sample application) visit World Wind Java Download. If you only want to play with the sample application go to NASA World Wind Java page and launch WWJ using Java Web Start technology.
Will World Wind Java run on my operating system?
The NASA World Wind Java SDK is platform independent. The demo has succesfully been run under Ubuntu, Microsoft Windows, Mac OS X and Fedora Core 6.
Running under 64-bit Linux
Without installing the AMD64 version of JOGL you will likely see errors like Exception in thread "main" java.lang.UnsatisfiedLinkError: no gluegen-rt in java.library.path or Exception in thread "main" java.lang.UnsatisfiedLinkError: ~/wwj/libgluegen-rt.so: ~/wwj/libgluegen-rt.so: wrong ELF class: ELFCLASS32
To get it working:
- Download the amd64 version of JOGL [1]
- Unzip the downloaded file and copy the content of the lib directory to your WWJ directory (e.g. cp jjogl-1.1.1-pre-20070511-linux-amd64/lib/* /path_to_WWJ/)
- Edit run-demo.bash and replace the last line in the file with:
java -Xmx512m -Dsun.java2d.noddraw=true -Djava.library.path=. -classpath ./src:./classes:./ worldwind.jar:./jogl.jar:./gluegen-rt.jar $1
- (Note: the only change is the addition of -Djava.library.path=.)
What are the system Requirements?
A 3D video card with updated drivers and Java 1.5 or 1.6 are necessary. World Wind has been tested on Nvidia, ATI/AMD, and Intel platforms using Windows, MacOS 10.4, and Fedora Core 6.
How do I update my drivers?
Under Microsoft Windows follow the NASA Java driver update guide.
What's the best way to run a World Wind program or demo?
The README file in the release distribution gives the command-lines to use, or use the Ant targets given in build.xml. You can run the basic demo by double-clicking on worldwind.jar, but the demo will run only a minute or two because it requires more Java heap space than the JVM provides by default. The Ant targets and the command lines given in the README set the appropriate JVM arguments.
Are there any JVM arguments that need to be set when running a World Wind program?
Yes. The max heap space needs to be set to 512 Mb or better, and the no-direct-draw argument needs to be set to tell Java 2D not to use DirectDraw (Windows only). The README and build.xml show how to set these.
Why are the World Wind Java demos missing features of World Wind 1.4?
NASA World Wind Java is an SDK. It is meant for developers and not end users. The bundled application and webstart on the NASA Java page are just simple demos to show how to get started with the SDK.
What are the controls for the bundled demo?
See the NASA World Wind Java page for the default controls.
Why do I get a blank screen?
A blank screen is typically caused by out of date graphics drivers. Please update them from the graphics card manufacturer.
Will there ever be a World Wind Java client?
The goal is 100s of World Winds, not one. That's why NASA created WWJ as a Java component. NASA has no plans to create a World Wind Java client similar to World Wind .Net. They plan only to continue to develop and expand the SDK.
How do I determine whether a World Wind program gives any error or warning messages?
World Wind uses Java logging exclusively to communicate error and warning messages. To have the messages printed to standard output, set the JVM argument
-Djava.util.logging.config.file=logging.properties
and make sure the .level line in the logging.properties file (included in the release) says "FINE", "FINER" or "FINEST".
Development specific questions
What is the status of the SDK? Is it a pre-alpha, an alpha, a beta or a release... or something else? Is it safe to start coding an application around it?
The WWJ release as of May 11, 2007 is an early-access release. The code and the API will continue to evolve, although the architecture will remain the same. When a stable release is established, the APIs will follow the convention of backwards compatibility among "dot" releases. No date for a stable release has been established yet. The components of WWJ are designed to be replaceable. The architecture is largely defined by pure interfaces. To replace a component, just implement the relevant interface(s).
Bug Reporting
Where do I report bugs or request new features?
You can ask questions on the World Wind Java forums, or report specific issues using the NASA issue tracker.
