Marble/DisplayGeoDataGroundOverlay

    From KDE TechBase
    Search
    Tutorial Series   Marble C++ Tutorial
    Previous   Tutorial 15 - Painting GeoDataLineString: Using the GeoPainter in order to paint a GeoDataLineString object
    What's Next   n/a
    Further Reading   n/a

    In this tutorial, we'll show you how to display a ground overlay with its associated image over the Earth's surface in Marble.

    GeoDataGroundOverlay is the class used in Marble to implement the features of the GroundOverlay KML element. More precisely, an instance references an icon that gets displayed on top of a certain area on the globe and a LatLonBox (GeoDataLatLonBox in Marble) describing its exact surface.

    As in the tutorial for displaying placemarks, we will be using a GeoDataDocument as the the containter for our overlay. The document is afterwards exposed to Marble by having it added to the GeoDataTreeModel.

    The implementation is actually pretty simple and you can have a look at it here:

    #include <QDebug>
    #include <QFileInfo>
    #include <QApplication>
    #include <QImage>
    
    #include <marble/MarbleWidget.h>
    #include <marble/GeoDataDocument.h>
    #include <marble/GeoDataGroundOverlay.h>
    #include <marble/GeoDataTreeModel.h>
    #include <marble/MarbleModel.h>
    
    using namespace Marble;
    
    int main(int argc, char** argv) {
    
        QApplication app(argc,argv);
    
        QFileInfo inputFile( app.arguments().last() );
        if ( app.arguments().size() < 2 || !inputFile.exists() ) {
            qWarning() << "Usage: " << app.arguments().first() << "file.png";
            return 1;
        }
    
        // Create a Marble QWidget without a parent
        MarbleWidget *mapWidget = new MarbleWidget();
    
        // Load the Satellite map
        mapWidget->setMapThemeId( "earth/bluemarble/bluemarble.dgml" );
    
        // Create a bounding box from the given corner points
        GeoDataLatLonBox box( 55, 48, 14.5, 6, GeoDataCoordinates::Degree );
        box.setRotation( 0, GeoDataCoordinates::Degree );
    
        // Create an overlay and assign the image to render and its bounding box to it
        GeoDataGroundOverlay *overlay = new GeoDataGroundOverlay;
        overlay->setLatLonBox( box );
        overlay->setIcon( QImage( inputFile.absoluteFilePath() ) );
    
        // Create a document as a container for the overlay
        GeoDataDocument *document = new GeoDataDocument();
        document->append( overlay );
    
        // Add the document to MarbleWidget's tree model
        mapWidget->model()->treeModel()->addDocument( document );
    
        mapWidget->show();
    
        return app.exec();
    }
    


    Save the above code in a render.cpp file and make sure to create in the same folder a file name CMakeLists.txt looking as below:

    CMAKE_MINIMUM_REQUIRED (VERSION 2.6)
    SET (TARGET render)
    PROJECT (${TARGET})
    
    FIND_PACKAGE (Qt4 4.6.0 REQUIRED QtCore QtGui)
    FIND_PACKAGE (Marble REQUIRED)
    INCLUDE (${QT_USE_FILE})
    INCLUDE_DIRECTORIES (${MARBLE_INCLUDE_DIR})
    SET (LIBS ${LIBS} ${MARBLE_LIBRARIES} ${QT_LIBRARIES})
    
    ADD_EXECUTABLE (${TARGET} render.cpp)
    TARGET_LINK_LIBRARIES (${TARGET} ${LIBS})
    


    Assuming your Marble library is installed to ~/marble/export, you can run the following commands in the terminal to compile and run it:

    cmake -DCMAKE_MODULE_PATH=~/marble/export/share/apps/cmake/modules \
          -DCMAKE_INCLUDE_PATH=~/marble/export/include \
          -DCMAKE_LIBRARY_PATH=~/marble/export/lib \
          .
    make
    ./render your_image_file.png
    


    If everything goes fine, you should be able to get a globe where your chosen image covers the approximate territory of Germany:

    The latest source code of this example can be found at main.cpp and CMakeLists.txt.