Blue MarbleViewer
on Open Scene Graph
Key Bindings.........................Mailing Lists..................................
Configuration File ................
The project is currently in development, but early copies may be obtained from this site. The run-time depends on Open Scene Graph and Open Producer and instructions for building and installation can be obtained here.
Windows users can obtain the software in two downloadable binary packages.
BlueMarbleViewer-0.8.6-1.exe (32.71 MB)
BlueMarbleViewer-Data.exe (263.3 MB)
The first package installs the run-time software, some auxilary data, and levels 0-2 of the base imagery. The package is about 32 MBs in size. The second package installs levels 3 and 4 of the base imagery and is about 260 MB in size. See Getting The Blue Marble Data for details.
The latest release of the source code can be obtained as a gzipped tar archive.
BlueMarbleViewer-0.8.6-1.tar.gz
You may also check out latest revisions via cvs:
cvs -d :pserver:cvsguest@dburns.dhs.org:/cvs/bmv login
Password: <just hit return>
cvs -d :pserver:cvsguest@dburns.dhs.org:/cvs/bmv co BlueMarbleViewer
Before downloading BMV, please download and install the dependencies.
Instructions for installing Open Scene Graph are here.
Instructions for installing Open Producer are here.
Instructions for downloading source and building Blue Marble Viewer are here.
Before running BMV, you must obtain the data. The current version uses 5 levels of detail ranging from a virtual image of 2560 x 1280 pixels (level 0) to 40960 x 20480 pixels (level 4). Windows users using the installer will have three levels (0-2) and an animation example installed with the first package. Levels 3 and 4 are installed with the second package. If you've installed both windows installer packages, then you have the data. If, however, you're building from source code, you must follow these instructions to get the rest of the data.
The data is a collection of 256x256 pixel tiles in 5551 format, which have been derived by preprocessing the original Blue Marble data. The preprocessing converts the large images ( land_shallow_topo_east.tif and land_shallow_topo_west.tif ) to tiles at the varying levels of detail, separating these levels of detail in subdirectories named '0', '1', '2', '3', and '4'.
(To get the NASA tiff images, go here, click on the 21600x21600 images - both Western and Eastern hemisphere then follow the links, or send email requesting them)
You can download the preprocessed data as a gzipped tar file from here:
Either download all levels at once:
alllevels.zip (287.39 MB)or a level at a time:
0.zip (1.09 MB)Unpack the data to the subdirectory in BlueMarbleViewer named data/Land. If you downloaded all levels unpack like this
1.zip (4.09 MB)
2.zip (15.6 MB)
3.zip (58.8 MB)
4.zip(208.02 MB)
% cd BlueMarbleViewer/data/Layer0If you downloaded a level at a time, unpack like this:
% unzip alllevels.zip
% cd BlueMarbleViewer/data/Layer0The data will expand to over 2 GB when extracted. If you placed the data in the directory specified above, then you are ready to go. Otherwise, you will need to edit the BMV.config file (copy BMV.config.sample, if BMV.config does not exist) and change the line that reads:
% unzip 1.zip
% unzip 2.zip
% unzip 3.zip
% unzip 4.zip
% unzip 5.zip
DataBase data/Landsubsituting "data/Land" with the directory where you extracted the data.
If you are running from a command line, from the top level directory of BlueMarbleViewer, copy BMV.config.sample to BMV.config and run the executable:
% bin/bmvThe application should fill the screen and begin playing through a recorded demonstration path, which zooms in and pans around to various locations on the globe. To exit demo mode, use the 'd' key. The application can now be controlled with the mouse, using the right button to zoom in and out and the left button to rotate the earth or pan East/West/North/South.
Key |
Operation |
| 'ESC' |
Quit |
| <space bar> |
Reset to default position
when using mouse control |
| 'a' |
Toggle cloud animation |
| 'c' |
Toggle clouds |
| 'd' |
Toggle demo mode |
| 'g' |
Toggle 'Grid' which outlines
roughly the borders of the tiles. (DEBUG) |
| 'i' |
Toggle force of default
texture for cache misses (DEBUG and DISABLED) |
| 'l' |
Toggle lighting |
| 'm' |
Print lattitue longitude
and altitude to console window. Useful for building demo
paths |
| 'p' |
Toggle printing of lattitude,
longitude and altitude in lower left corner of screen |
| 'r' |
Toggle printing of tile
ID's with tiles (DEBUG) |
| 't' |
Toggle texturing |
| 'w' |
Toggle through filled, wireframe
and point polygon modes. |
| '1' |
Default (mouse) trackball
mode |
| '2' |
Inventor-like trackball
mode |
| '3' |
Performer-like trackball
mode |
| '7' |
Black background |
| '8' |
White background |
| '9' |
Open Scene Graph "blue"
background |
| '<' |
If Atmosphere animation is enabled, start animation
backward |
| '>' |
If Atmosphere animation is enabled, start animation
forward |
| ',' |
If Atmosphere animation is enabled, rewind animation |
| '.' |
If Atmosphere animation is enabled, wind animation
to end |
| '+' |
If Atmosphere animation is enabled, double animation
frame rate |
| '-' (minus) |
If Atmosphere animation is enabled, divide animation
frame rate by two. |
| UP ARROW |
Set earth spin rate to default (real-time) |
| DOWN ARROW |
If Atmosphere anmiation is enabled, stop
the animation. If Atmosphere animation is disabled, stop earth spin0 |
| LEFT ARROW |
If Atmosphere anmiation is enabled, and
stopped, step backward one frame in animation. If Atmosphere animation is disabled, decrement (divide by 2) earth spin rate |
| RIGHT ARROW |
If Atmosphere anmiation is enabled, and
stopped, step forward one frame in animation. If Atmosphere animation is disabled, increment (multiply by 2) earth spin rate |
| F1 |
Cache miss mode to WAIT (DEBUG) |
| F2 |
Cache miss mode to DEFAULT
(DEBUG) |
| F3 |
Cache miss mode to USE_LOW_RES
(DEBUG) |
| Attribute |
Default Value |
Description |
| CameraConfigFile |
(commented out) |
Specify a Producer CameraConfig file. When
this value is commented out, BMV uses the default Producer configuration,
which is usually full screen. If the value is present, the camera config
file will be used for display configuration. |
| RunAsynchronousICache |
True |
Run the Image Cache asynchronously. Values
are True or False |
| RunMultithreadedCameraGroup |
True |
Run the Producer Camera Group multi-threaded. Values
are True or False. When set to True, this provides the best performance
results when there is more than one display on the system. |
| DataBase |
data/Land |
The location of the Land based Virtual Texture |
| DemoPath |
data/demo.path |
The name of a path file that is used to run BMV
in demo mode. Entries in the pathfile are time (seconds) position
(x y z) and Attitude (specified by a quaternion qx qy qz qw). |
| LogoFile |
data/bmv.logo |
The file specifying the logo image and location
on the screen to display the image. If left blank no logo will be
displayed. |
| BeginInDemoMode |
True |
Values are True or False. If set to True,
BMV will start up automatically playing through the pathfile. If set
to False, BMV starts with trackball mouse control. |
| AtmosphereBaseImage |
data/clouds_1024.inta |
Specify the base image file for the Atmosphere layer |
| AtmosphereAnimation |
hawaii.anim |
Specify an animation file to play in the Atmosphere
layer |