Marble/Runners/PaintingGeoDataLineString: Difference between revisions

    From KDE TechBase
    No edit summary
     
    (No difference)

    Latest revision as of 21:01, 10 March 2016

    Painting GeoDataLineString: Using the GeoPainter in order to paint a GeoDataLineString object
    Tutorial Series   Marble C++ Tutorial
    Previous   Tutorial 14 - Drawing in Custom Layers
    What's Next   Tutorial 16 - Rendering Ground Overlays
    Further Reading   n/a


    The previous tutorial proved how GeoPainter can be used in order to paint shapes and text at different coordinates of the map (through a GeoDataCoordinates parameter) in a MarbleWidget. Now, we'll show a new way of adding extra content to the globe: by painting GeoDataLineString's using our GeoPainter.

    Briefly, GeoDataLineString is a tool class which implements LineStrings (also referred to as "polylines"), allowing us to store a contiguous set of line segments. As you will see in the example, it consists of several nodes (GeoDataCoordinates points), which are connected through line segments.

    GeoDataLineString allows LineStrings to be tessellated in order to make them follow the terrain and the curvature of the Earth. The tessellation options allow different ways of visualization:

    • Not tessellated, connects each two nodes directly
    • A tessellated line, each segment is bent such that the LineString follows the curvature of the Earth and its terrain. A tessellated line segment connects each two nodes at the shortest possible distance ("along great circles").
    • A tessellated line which follows latitude circles whenever possible: in this case latitude circles are followed as soon as two subsequent nodes have exactly the same amount of latitude. In all other places the line segments follow great circles.


    #include <QtGui/QApplication>
    #include <marble/MarbleWidget.h>
    #include <marble/GeoPainter.h>
    #include <marble/GeoDataLineString.h>
     
    using namespace Marble;
    
    class MyMarbleWidget : public MarbleWidget 
    {
    	public:
    	virtual void customPaint(GeoPainter* painter);
    };
    
    void MyMarbleWidget::customPaint(GeoPainter* painter) {
    
    	GeoDataCoordinates France( 2.2, 48.52, 0.0, GeoDataCoordinates::Degree );
    	painter->setPen( QColor( 0, 0, 0 ) );
    	painter->drawText( France, "France" );
    
    	GeoDataCoordinates Canada( -77.02, 48.52, 0.0, GeoDataCoordinates::Degree );
    	painter->setPen( QColor( 0, 0, 0 ) );
    	painter->drawText( Canada, "Canada" );
    
    	//A line from France to Canada without tessellation
    
    	GeoDataLineString shapeNoTessellation( NoTessellation );
    	shapeNoTessellation << France << Canada;
    
    	painter->setPen( oxygenSkyBlue4 );
    	painter->drawPolyline( shapeNoTessellation );
    
    	//The same line, but with tessellation
    	
    	GeoDataLineString shapeTessellate( Tessellate );
    	shapeTessellate << France << Canada;
    
    	painter->setPen( oxygenBrickRed4 );
    	painter->drawPolyline( shapeTessellate );
    
    	//Now following the latitude circles
    
    	GeoDataLineString shapeLatitudeCircle( RespectLatitudeCircle | Tessellate );
    	shapeLatitudeCircle << France << Canada;
    
    	painter->setPen( oxygenForestGreen4 );
    	painter->drawPolyline( shapeLatitudeCircle );
    }
      
    int main(int argc, char** argv) {
    
    	QApplication app(argc,argv);
    		   
    	// Create a Marble QWidget without a parent
    	MarbleWidget *mapWidget = new MyMarbleWidget();
    				    
    	// Load the OpenStreetMap map
    	mapWidget->setMapThemeId("earth/plain/plain.dgml");
    							 
    	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 globe view similar to this:

    As you can see, the blue line corresponds to the straight-no-tessellation way of visualization, the red one follows the great circles, and the green one sticks to the latitude circles, since the two endpoints have the same latitude.