LibMini Tutorial
Terrain Rendering with LibMini
Libmini is free software that displays geographic terrain data at real-time. This is an example application of integrating libmini in the QT user interface. The application, the libMini QTViewer, primarily uses libmini viewer functions but provides additional camera control. It is free software licensed under the GPL.
Prerequisites
The libMini QTViewer Requires the installation of:
gnu/c++ or MSVC compiler svn/subversion tools qt/qmake
It is highly recommended to build and install QT from source!
For example grab the source tar ball from:
ftp://ftp.qt.nokia.com/qt/source/qt-everywhere-opensource-src-4.7.4.tar.gz
Installation (Unix/Mac)
Type on the unix console in your QT source directory:
./configure -opensource && make && sudo make install
After the build process has finished (go get yourself a cup of coffee), you will be asked to enter your root password for installation of qt.
Installation (Windows):
Open a MSVC command prompt via
Programs → MSVC → Tools → MSVC Command Prompt
Choose an appropriate platform to describe the version of MSVC:
MSVC 8.0 → SET PLATFORM=win32-msvc2005 MSVC 9.0 → SET PLATFORM=win32-msvc2008 MSVC 10.0 → SET PLATFORM=win32-msvc2010
Navigate to the QT source directory and type
configure -platform%PLATFORM%nmake
Add the “bin” directory in your QT directory to your path:
set PATH=\bin;%PATH%
Or add the “bin” directory to your PATH environment variable:
System → Advanced → Environment Variables → PATH
Libmini Dependencies (Unix/Mac)
Get the libMini dependencies from the libMini subversion repository. Type on the unix console in your project directory (e.g. ~/Projects):
svn co http://libmini.googlecode.com/svn/libmini/deps deps (cd deps; ./build.sh)
Libmini Dependencies (Windows)
Precompiled static libraries for Windows MSVC 2005 are provided in the libMini WIN32 directory. In your project directory get the following sub-directory via Tortoise SVN:
http://libmini.googlecode.com/svn/libmini/WIN32
Additionally we need gdal to be installed. In your project directory get gdal via Tortoise SVN:
http://svn.osgeo.org/gdal/tags/1.8.1/gdal
Open the appropriate MSVC solution file in the gdal directory and compile.
Checkout and Compilation (Unix/Mac)
Type on the unix console in your project directory:
svn co http://libmini.googlecode.com/svn/libmini/mini mini svn co http://libmini.googlecode.com/svn/libmini/qtviewer qtviewer (cd qtviewer; ./build.sh)
Checkout and Compilation (Windows)
Get the following subversion repositories via Tortoise SVN:
http://libmini.googlecode.com/svn/libmini/mini http://libmini.googlecode.com/svn/libmini/qtviewer
Open a MSVC command prompt via
Programs → MSVC → Tools → MSVC Command Prompt
Navigate to the qtviewer source directory and type
build.bat