Marble/MarbleCPlusPlus

The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

Editing Projects/Marble/MarbleCPlusPlus

Hello Marble

Tutorial Series	Marble C++ Tutorial
Previous	C++, Qt
What's Next	Tutorial 2 - Marble's GeoPainter
Further Reading	n/a

Hello Marble!

The Marble API allows a very easy integration of a map widget into your application. Let's prove that with a tiny "Hello world"-like example:

include <QtGui/QApplication>
include <marble/MarbleWidget.h>

using namespace Marble;
int main(int argc, char** argv)
{

   QApplication app(argc,argv);

   // Create a Marble QWidget without a parent
   MarbleWidget *mapWidget = new MarbleWidget();

   // Load the OpenStreetMap map
   mapWidget->setMapThemeId("earth/openstreetmap/openstreetmap.dgml");

   // Set a server for downloading map data, if needed
   mapWidget->setDownloadUrl("http://download.kde.org/apps/marble/");
   mapWidget->show();

   return app.exec();

Save the code above as my_marble.cpp and compile it:

g++ -I /usr/include/qt4/ -o my_marble my_marble.cpp -lmarblewidget -lQtGui

If things go fine, execute ./my_marble and you end up with a fully usable OpenStreetMap application:

Here's a little checklist to tackle some problems that might arise when compiling the code above:

You need Qt and Marble development packages (or comparable SVN installations)
If you're running Marble from SVN, remove the setDownloadUrl() function call. It's obsolete and not needed anymore.
If Qt headers are not installed in /usr/include/qt4 on your system, change the path in the g++ call above accordingly.
Likewise, add -I /path/to/marble/headers if they're not to be found in /usr/include