Difference between revisions of "Projects/Marble/Placemark"

Jump to: navigation, search
(Overview of Placemarks in Marble)
 
(One intermediate revision by one user not shown)
Line 1: Line 1:
== Overview of Placemarks in Marble ==
+
= Overview of Placemarks in Marble =
  
The {{class|PlaceMarkManager|kdeedu|4.x}} is handled by the {{class|MarbleModel|kdeedu|4.x}} and provides registration of Placemarks from KML data files for Marble (it should handle placemarks for all data files in the future).
+
The {{class|GeoDataPlacemark|kdeedu|4.x}} is the class representing a placemark in Marble, with GeoData classes following kml specification. There are basically 2 kinds of Placemarks: Point Placemarks, and Placemarks containing a Geometry class inheriting {{class|GeoDataGeometry|kdeedu|4.x}}.
  
It depends on the {{class|FileManager|kdeedu|4.x}} which performs the actual file reading and then signals that files have been added/removed.
+
== Registration and use in MarbleModel ==
 +
The {{class|MarbleModel|kdeedu|4.x}} provides registration of Placemarks within a {{class|GeoDataTreeModel|kdeedu|4.x}}. The tree model stores multiple {{class|GeoDataDocument|kdeedu|4.x}} corresponding to the data they hold.
  
The PlaceMarkManager keeps some information related to the data that it presents. It provides a {{class|MarblePlacemarkModel|kdeedu|4.x}} which presents the list of all placemarks of all files
+
It is used currently by 3 frameworks:
  
 +
=== File Management ===
  
The {{class|MarbleRunnerManager|kdeedu|4.x}} is a framework to query external servers for placemarks. The user types the query in the search line of the ControlBox widget, and then the MarbleRunnerManager triggers asynchronous runners which inherit from {{class|MarbleAbstractRunner|kdeedu|4.x}}.
+
The {{class|FileManager|kdeedu|4.x}} performs file reading and then signals that files have been added/removed. It registers its document in the tree model.
 +
The role of the FileManager is:
  
The MarbleRunnerManager holds the resulting Placemarks until another query is input.
+
* Centralise file parsing while relying on the {{class|MarbleRunnerManager|kdeedu|4.x}} to support various file formats thanks to Parsing plugins.
 +
 
 +
* use threading support with FileLoader loading the file asynchronously (should be deprecated since the runner manager handles this already).
 +
 
 +
* provide the results of those parsing to MarbleModel so that Marble can have easy access to the data.
 +
 
 +
=== Placemark Search runners ===
 +
 
 +
The {{class|MarbleRunnerManager|kdeedu|4.x}} is a framework to query external servers for placemarks thanks to Placemark search plugins. The user types the query in the search line of the ControlBox widget, and then the MarbleRunnerManager provides the resulting Placemarks in the tree model.
 +
 
 +
=== Position Provider ===
 +
 
 +
The {{class|PositionProvider|kdeedu|4.x}} class has a document to display the current position, as well as the track stored of past positions. That document belongs in the tree model.
 +
 
 +
 
 +
== Display in the map ==
 +
 
 +
The Point placemarks are displayed thanks to the {{class|PlacemarkLayout|kdeedu|4.x}} which does layouting of the labels, and filtering of the important placemarks to render, based on a popularity ranking.
 +
 
 +
The Geometry placemarks are displayed thanks to the {{class|GeometryLayer|kdeedu|4.x}} which contains a {{class|GeoGraphicsScene|kdeedu|4.x}}.

Latest revision as of 20:41, 26 December 2011

Contents

[edit] Overview of Placemarks in Marble

The GeoDataPlacemark is the class representing a placemark in Marble, with GeoData classes following kml specification. There are basically 2 kinds of Placemarks: Point Placemarks, and Placemarks containing a Geometry class inheriting GeoDataGeometry.

[edit] Registration and use in MarbleModel

The MarbleModel provides registration of Placemarks within a GeoDataTreeModel. The tree model stores multiple GeoDataDocument corresponding to the data they hold.

It is used currently by 3 frameworks:

[edit] File Management

The FileManager performs file reading and then signals that files have been added/removed. It registers its document in the tree model. The role of the FileManager is:

  • Centralise file parsing while relying on the MarbleRunnerManager to support various file formats thanks to Parsing plugins.
  • use threading support with FileLoader loading the file asynchronously (should be deprecated since the runner manager handles this already).
  • provide the results of those parsing to MarbleModel so that Marble can have easy access to the data.

[edit] Placemark Search runners

The MarbleRunnerManager is a framework to query external servers for placemarks thanks to Placemark search plugins. The user types the query in the search line of the ControlBox widget, and then the MarbleRunnerManager provides the resulting Placemarks in the tree model.

[edit] Position Provider

The PositionProvider class has a document to display the current position, as well as the track stored of past positions. That document belongs in the tree model.


[edit] Display in the map

The Point placemarks are displayed thanks to the PlacemarkLayout which does layouting of the labels, and filtering of the important placemarks to render, based on a popularity ranking.

The Geometry placemarks are displayed thanks to the GeometryLayer which contains a GeoGraphicsScene.


This page was last modified on 26 December 2011, at 20:41. This page has been accessed 3,045 times. Content is available under Creative Commons License SA 3.0 as well as the GNU Free Documentation License 1.2.
KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V.Legal