From 45221db0bc20d9c6d5d73189a7162c0ee6f86ee6 Mon Sep 17 00:00:00 2001 From: Robert Osfield Date: Tue, 10 Aug 2004 13:19:04 +0000 Subject: [PATCH] Added osgdem quick usage guide --- doc/contents.html | 1 + doc/data.html | 1 + doc/dependencies.html | 1 + doc/documentation.html | 1 + doc/examples.html | 1 + doc/index.html | 174 +++++++++---------- doc/install.html | 1 + doc/introduction.html | 1 + doc/osgdem.html | 373 +++++++++++++++++++++++++++++++++++++++++ doc/osgviewer.html | 1 + doc/plan.html | 1 + doc/stereo.html | 1 + index.html | 4 +- 13 files changed, 468 insertions(+), 93 deletions(-) create mode 100644 doc/osgdem.html diff --git a/doc/contents.html b/doc/contents.html index 17dc4634b..cdfb9105d 100644 --- a/doc/contents.html +++ b/doc/contents.html @@ -19,6 +19,7 @@ Data Viewer Stereo + osgdem Plan Reference Guides diff --git a/doc/data.html b/doc/data.html index b3a8c66b6..0c0907b3d 100644 --- a/doc/data.html +++ b/doc/data.html @@ -22,6 +22,7 @@ Data Viewer Stereo + osgdem Plan Reference Guides diff --git a/doc/dependencies.html b/doc/dependencies.html index 175f14729..e8efbbb40 100644 --- a/doc/dependencies.html +++ b/doc/dependencies.html @@ -22,6 +22,7 @@ Data Viewer Stereo + osgdem Plan Reference Guides diff --git a/doc/documentation.html b/doc/documentation.html index aad69803e..ad006f204 100644 --- a/doc/documentation.html +++ b/doc/documentation.html @@ -22,6 +22,7 @@ Data Viewer Stereo + osgdem Plan Reference Guides diff --git a/doc/examples.html b/doc/examples.html index f8baf2866..4ae5847ae 100644 --- a/doc/examples.html +++ b/doc/examples.html @@ -26,6 +26,7 @@ Viewer Stereo +osgdem Plan diff --git a/doc/index.html b/doc/index.html index 24f88b488..a568d905b 100644 --- a/doc/index.html +++ b/doc/index.html @@ -1,109 +1,99 @@ - + - - - OSG Documentation + + + OSG Documentation - - - + +
+
- - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + +
IndexIntroductionContentsInstallDependenciesexamplesDataViewerStereoPlanReference Guides
IndexIntroductionContentsInstallDependenciesexamplesDataViewerStereoosgdemPlanReference Guides
-

Index

- - - - - + + + - - - - - - - - - - - - - - - - - - + + + + + + + + + + + - - - - - - + + + - - - - - - + + + - - - - - - + + + - - - - - - + + + - - - - - - - - - - - - - + + + + + + + + + + + + + +
IntroductionIntroduction to Scene Graph in general, the OpenSceneGraph project +
IntroductionIntroduction to Scene Graph in general, the OpenSceneGraph +project itself and how to use it.
ContentsA list of the directories in the distribution.
InstallA guide of how to compile and install on all the supported platforms.
DependenciesListing of all the dependencies of the project, with links of where +
ContentsA list of the directories in the distribution.
InstallA guide of how to compile and install on all the supported +platforms.
DependenciesListing of all the dependencies of the project, with links of +where to download them.
examplesThumbnails and info on all the demo applications which come with this +
examplesThumbnails and info on all the demo applications which come +with this distribution.
DataList of websites where one can download interesting and useful data +
DataList of websites where one can download interesting and +useful data from.
ViewerList of key bindings support by the osgProducer::Viewer and hence osgviewer and +
ViewerList of key bindings support by the osgProducer::Viewer and +hence osgviewer and the rest of demos.
StereoDocumentation on the commandline parameters and environmental variables +
StereoDocumentation on the commandline parameters and environmental +variables which control stereo.
PlanDetails of development plans.
Reference GuidesReference guides of the core libraries.
osgdem
+ 		Documentation on how to use the +osgdem utility
+
PlanDetails of development plans.
Reference GuidesReference guides of the core libraries.
- diff --git a/doc/install.html b/doc/install.html index ece960e40..0893b71a1 100644 --- a/doc/install.html +++ b/doc/install.html @@ -22,6 +22,7 @@ Data Viewer Stereo + osgdem Plan Reference Guides diff --git a/doc/introduction.html b/doc/introduction.html index 6644b921c..f20e1d4c0 100644 --- a/doc/introduction.html +++ b/doc/introduction.html @@ -21,6 +21,7 @@ Data Viewer Stereo + osgdem Plan Reference Guides diff --git a/doc/osgdem.html b/doc/osgdem.html new file mode 100644 index 000000000..5f2c094a1 --- /dev/null +++ b/doc/osgdem.html @@ -0,0 +1,373 @@ + + + + + + examples + + + + + + + + + + + + + + + + + + + + +
IndexIntroductionContentsInstallDependenciesexamplesDataViewerStereoosgdemPlanReference Guides
+

+Using osgdem to generate geospatial +terrain databases

+
    +
  1. Quick step by step guide
    2. +
  2. osgdem options
    3. +
+
+

Quick step by step guide:

+Follows are a the steps required to get osgTerrain/osgdem compiling and +an example of how to use it to process imagery and dem's to gernerate a +paged databases.
+
+1) Download, compile & install GDAL.
+ 
+2) Get the latest OSG in CVS.
+
+3) For unix Make users, make a copy of Make/dependencies and change the +GDAL_INSTALL entry to:
+
+
set +GDAL_INSTALL = true
+
+
+    Then tell the build to use you custom +dependencies by setting the environmental variable OSG_DEPENDENCIES to +the absolute path to your file i.e.:
+
+
export +OSG_DEPENDENCIES=/home/billgates/my_osg_dependencies
+
+ 
+4) Rebuild the OSG & install (if you havn't already used
+ 
+5) Oh make sure you have a couple Gb of spare disk space,  because +you going need it :-)
+ 
+6) Download some data, for this example I'm using the PegoutSound data +at:
+ 
+        http://www.cc.gatech.edu/projects/large_models/ps.html +
+ 
+        Download Elevation Map: +16385 × 16385 PNG: 188MB
+         Download Texture Map: +16384 × 16384 PNG: 268MB  
+
+7) To avoid aliasing artifcates when accessing data I use GDAL +utilitiy +programs to generate overviews (basically mip maps stored in the +.tif) +via:
+ 
+
+
gdal_translate +ps_height_16k.png +ps_height_16k.tif
+gdaladdo -r average ps_height_16k.tif +2 4 8 16 32
+  
+gdal_translate ps_texture_16k.png +ps_texture_16k.tif
+gdaladdo -r average ps_texture_16k.tif +2 4 8 16 32
+
+ 
+
+8) Now its time to run the osgdem example to generate your PagedLOD +database, the more levels you generate the longer it will take +(exponentially so), osgdem is just a front end to osgTerrain::DataSet +where all the hard work happens. Here's what to run :
+
+
osgdem +--xx 10 --yy 10 -t ../ps_texture.tif \
+        +    +--xx 10 --yy 10 -d ../ps_height.tif \
+          +  +-l 8 \
+         +  -v 0.1 \
+           +-o pegout.ive
+
+
+Then go away for lunch, afternoon and tea, as generating this much data +takes a while... If you don't wish to wait for the full database then +reduce the number of levels it generates by setting the -l option to a +lower value such as 3.
+
+The command line options used above are:
+
 
+The first part the --xx and --yy is specifying the size of the pixels +in meters, since these png/tif don't have any geospatial data of their +own, if you have geospetialised files then you won't need this.
+
+The second part -t <filename> is the option for specificing the +texture maps to use, you can use as many as you wish, +osgTerrain::DataSet will moziac them into a single database.  
+
+The third part -d is the option for specificying the digital elevation +maps to use, as with the textures you can use as many as you like.
+ 
+The -l option specificies the maximum number of levels to generate, if +you use a large number then the database generation will stop once the +max resolution of you source data is matched by the outputed database. +The database generation will decend further where there is high res +source +data, decend less where there is lower res data.
+
+The -v option specifies the scaling factor which the height is +multiplied by.
+
+And finally the -o <filename> is the output format to generat the +databases in. This will be the name of the topmost file in the one you +should load. It can be a .ive or a .osg. The .ive is faster and has +embedded files. 
+
+
+9) Time to play, simply load the database in your app (make sure it +support the osgDB::DatabasePager see osgsimplepager +example for detaiils). The standard osgviewer works just fine so +here goes:
+ 
+   osgviewer output.ive
+ 
+
+10) You don't actually have to wait for osgdem to complete before you +can browse the database, since osgdem generates +the topmost tiles first. Its not totally robust since osgviewer can end +up +loading tiles that are still being written by osgdem, but it doesn't +crash +here under Linux, so you might be lucky too.
+
+11) If you imagery and dem's have geospatial coords associated with +them then the -xx, --yy and -v options will not be required making the +it much simplier to specify - you just need to specifiy options such as +-t imge.tif and -d terran.dt0 +without any need to set to coordinate system.
+
+12) osgdem can automatically handle moziacing of sets of files, these +can be specified via a sequence of -t +<filename> and -d +<filename> pairs on the commandline, or via -t <directoryname> and -d <directoryname>.
+ 
+
+

osgdem options

+There are of osgdem options to use, to list the full ranges of options +do:
+
+
osgdem +--help
+
+
+And you should see:
+
+

+osgdem --help
+Usage: osgdem [options] filename +...
+Options:
+  +--HEIGHT_FIELD                          +Create a height field database
+  +--LOD                                   +Create a LOD'd database
+  +--POLYGONAL                             +Create a height field database
+  +--PagedLOD                              +Create a PagedLOD'd database
+  +--RGB-16                                +Use 16bit RGB destination imagery
+  +--RGB-24                                +Use 24bit RGB destination imagery
+  +--comment                               +Added a comment/description string to
+                                          +the top most node in the dataset
+  +--compressed                            +Use OpenGL compression on destination
+                                          +imagery
+  --cs <coordinates +system string>        Set the +coordinates system of source
+                                          +imagery, DEM or destination database.
+                                          +The string may be any of the usual
+                                          +GDAL/OGR forms, complete WKT, PROJ.4,
+                                          +EPS
+  +--max-anisotropy                        +Max anisotropy level to use when
+                                          +texturing, defaults to 1.0.
+  +--max-visible-distance-of-top-level     Set the +maximum visible distance that
+                                          +the top most tile can be viewed at
+  +--mip-mapping-hardware                  +Use mip mapped textures, and generate
+                                          +the mipmaps in hardware when
+                                          +available.
+  +--mip-mapping-imagery                   +Use mip mapped textures, and generate
+                                          +the mipmaps in imagery.
+  +--no-mip-mapping                        +Disable mip mapping of textures
+  +--radius-to-max-visible-distance-ratio  Set the maximum visible +distance ratio
+                                          +for all tiles apart from the top most
+                                          +tile. The maximum visuble distance is
+                                          +computed from the ratio * tile radius.
+  --skirt-ratio +<float>                   +Set the ratio of skirt height to tile
+                                          +size
+  +--tile-image-size                       +Set the tile maximum image size
+  +--tile-terrain-size                     +Set the tile maximum terrain size
+  --wkt <WKT +string>                      +Set the coordinates system of source
+                                          +imagery, DEM or destination database
+                                          +in WellKownText form.
+  --wkt-file <WKT +file>                   +Set the coordinates system of source
+                                          +imagery, DEM or destination database
+                                          +by as file containing WellKownText
+                                          +definition.
+  -d +<filename>                           +Specify the digital elevation map
+                                          +input file to process
+  -e <x> <y> +<w> +<h>                      +Extents of the model to generate
+  -h or +--help                            +Display this information
+  -l +<numOfLevels>                        +Specify the number of PagedLOD levels
+                                          +to generate
+  -m +<filename>                           +Specify the 3D database model input
+                                          +file to process
+  -o +<outputfile>                         +Specify the output master file to
+                                          +generate
+  -t +<filename>                           +Specify the texture map input file to
+                                          +process
+  +-v                                      +Set the vertical multiplier
+
+
+
+ + diff --git a/doc/osgviewer.html b/doc/osgviewer.html index 3a7eabbe5..fdd76c4f3 100644 --- a/doc/osgviewer.html +++ b/doc/osgviewer.html @@ -20,6 +20,7 @@ Data Viewer Stereo + osgdem Plan Reference Guides diff --git a/doc/plan.html b/doc/plan.html index 614f17214..7aa2736d3 100644 --- a/doc/plan.html +++ b/doc/plan.html @@ -26,6 +26,7 @@ Viewer Stereo +osgdem Plan diff --git a/doc/stereo.html b/doc/stereo.html index 993932335..88e139fc3 100644 --- a/doc/stereo.html +++ b/doc/stereo.html @@ -22,6 +22,7 @@ Data Viewer Stereo + osgdem Plan Reference Guides diff --git a/index.html b/index.html index ed31fc6c7..b53e4d110 100644 --- a/index.html +++ b/index.html @@ -23,10 +23,12 @@ Data -Viewer +Viewer Stereo +osgdem + Plan Reference Guides