Marble: Difference between revisions
No edit summary |
|||
(53 intermediate revisions by 11 users not shown) | |||
Line 1: | Line 1: | ||
[[Image:Marble_logo.png]] | [[Image:Marble_logo.png]] | ||
== About Marble == | == About Marble == | ||
;[[/Devices_and_Use_Cases|Devices and Use Cases]] | |||
;[[/FAQ|Marble FAQ]] | ;[[/FAQ|Marble FAQ]] | ||
== | == Success Stories: 3rd party applications using the Marble Library== | ||
;[[/MarbleUsedBy| | ;[[/MarbleUsedBy|Software that makes use of Marble]] | ||
== Tutorials: How to use the Marble Widget in your application == | |||
;[[/MarbleDesigner|with Qt Designer]] | |||
;[[/MarbleWindows|On Windows, with Qt Creator/Qt Designer]] | |||
=== With C++ === | |||
;[[/MarbleCPlusPlus|Hello World]] | |||
;[[/MarbleMarbleWidget|Changing basic map properties]] | |||
;[[/MarbleSignalsSlots|Creating a window with controls]] | |||
;[[/MarbleGeoPainter|Painting onto the map]] | |||
;[[/LayerInterface|Drawing in Custom Layers]] | |||
;[[/Routing/BasicRouting|Basic Routing]] | |||
;[[/Runners/Search|Searching for Points of Interest]] | |||
;[[/Runners/ReverseGeocoding|Reverse Geocoding]] | |||
;[[/Runners/Parse|Parsing Files]] | |||
;[[/Runners/PaintingGeoDataLineString|Painting LineString]] | |||
;[[/Runners/DisplayGeoDataPlacemark|Displaying GeoData Documents]] | |||
;[[/MarblePython|with Python]] | ;[[/MarblePython|with Python]] | ||
Line 26: | Line 40: | ||
;[[/GoMarble|How to become a Marble Developer]] | ;[[/GoMarble|How to become a Marble Developer]] | ||
== Compiling Marble == | |||
;[[/LinuxCompiling|Compiling on Linux]] | |||
;[[/WindowsCompiling|Compiling on Windows]] | |||
;[[/MaemoEnvironment|Compiling on Maemo]] | |||
;[[/MeeGoEnvironment|Compiling on MeeGo]] | |||
;[[/PlasmaActiveEnvironment|Compiling for Plasma Active]] | |||
;[[/MacCompiling|Compiling on Mac OS]] | |||
;[[/QtCreator|Setting up QtCreator for Marble Development]] | |||
== Packaging Marble == | == Packaging Marble == | ||
Here is some advice about how packaging is supposed to happen on the various | ;[[/NewMarbleMoldules|New Marble Modules]] (future packaging advice) | ||
Here is some advice about how packaging is supposed to happen on the various platforms that are supported. | |||
;[[/LinuxPackaging|Packaging for Linux]] | |||
;[[/WindowsPackaging|Packaging for Windows]] | |||
;[[/MaemoPackaging|Packaging for Maemo]] | |||
;[[/MeeGoPackaging|Packaging for MeeGo]] | |||
;[[/MacPackaging|Packaging for Mac]] | ;[[/MacPackaging|Packaging for Mac]] | ||
Line 36: | Line 65: | ||
Here are some tools and checks that are performed on marble code: | Here are some tools and checks that are performed on marble code: | ||
;[https://bugs.kde.org/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=marble&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&cmdtype=doit&order=Importance Marble Open Bugs] | |||
;[http://reviewboard.kde.org/groups/marble/ Review Board] | ;[http://reviewboard.kde.org/groups/marble/ Review Board] | ||
;[http://api.kde.org/4.x-api/kdeedu-apidocs/marble/html/index.html API Docs (KDE Trunk)] | ;[http://api.kde.org/4.x-api/kdeedu-apidocs/marble/html/index.html API Docs (KDE Trunk)] | ||
Line 44: | Line 74: | ||
Here are a few links to various issues we are working on: | Here are a few links to various issues we are working on: | ||
;[[/Gsoc2010| Gsoc Students projects 2010]] | |||
;[[/GsocGit| Use of git(orious) for GSOC]] | |||
;[[/TODO|TODO list]] | |||
;[[/MaemoTODO|Maemo specific TODO list]] | |||
;[[/GSoC2011| GSoC Students' projects 2011]] | |||
;[http://community.kde.org/SoCiS/2011/Ideas#Marble_Virtual_Globe ESA SoCIS 2011 ideas] | |||
;[[/GSoC2012| GSoC Students' projects 2012]] | |||
=== Translation === | |||
;[[/MapTranslation|Map Translation]] | |||
;[[/UiTranslation|UI Translation]] | |||
;[[/GeoDataCoordinatesTranslation|GeoDataCoordinates Translation]] | |||
=== User Interface === | === User Interface === | ||
;[[/Mockups|Mockups]] | ;[[/Mockups|Mockups]] | ||
;[[/IconStatus|Icon Status]] | |||
=== Texture Mapping === | === Texture Mapping === | ||
Line 52: | Line 97: | ||
=== GeoData Library / KML === | === GeoData Library / KML === | ||
;[[/GeoData|GeoData]] | The base classes to manipulate geographic data | ||
;[[/GeoData|GeoData Presentation]] | |||
;[[/GeoData/GeoDataUse|Use cases for GeoData classes]] | |||
;[http://websvn.kde.org/*checkout*/trunk/KDE/kdeedu/marble/src/lib/geodata/data/README.html GeoData API Description] | |||
;[[/GeoData/GeoDataParsing|Parsing GeoData]] | |||
;[[/GeoData/GeoDataWriter|Writing GeoData]] | |||
;[[/GeoData/PointerVsImplicitShare|Pointer vs. Implicit Share]] | |||
;[[/KMLStatus|KML Status]] | ;[[/KMLStatus|KML Status]] | ||
;[[/GPXStatus|GPX Status]] | ;[[/GPXStatus|GPX Status]] | ||
Using GeoData: | |||
;[[/Placemark|Placemarks Management]] | ;[[/Placemark|Placemarks Management]] | ||
;[[/ModelView|Review of Model-View use in marble]] | ;[[/ModelView|Review of Model-View use in marble]] | ||
Line 80: | Line 131: | ||
=== Online Services === | === Online Services === | ||
;[[/OnlineServices|Creating new Online Services]] | ;[[/OnlineServices|Creating new Online Services]] | ||
;[[/ListOfPossibleOnlineServices|List of possible Online Services]] | |||
=== Projections === | === Projections === | ||
;[[/WinkelIii|Winkel III]] | ;[[/WinkelIii|Winkel III]] | ||
;[[/RobinsonProjection|Robinson projection]] | |||
[http://www.radicalcartography.net/?projectionref A little overview of map projections] | |||
=== Tile Download === | === Tile Download === | ||
;[[/VectorTilingProposal|Vector Tiling Proposal]] | |||
;[[/TileDownload|Tile Download]] | ;[[/TileDownload|Tile Download]] | ||
=== Documentation === | === Documentation === | ||
;[[/CustomMaps|How to customize maps]] | ;[[/CustomMaps|How to customize maps]] | ||
;[[/PNTFiles|How to change the PNT files used by Marble]] | |||
;[[/MarblesSecrets|Marble's Secrets]] | ;[[/MarblesSecrets|Marble's Secrets]] | ||
;[[/ProxyConnection|How to use the Proxy]] | ;[[/ProxyConnection|How to use the Proxy]] | ||
Line 94: | Line 150: | ||
=== GeoClue / GPS === | === GeoClue / GPS === | ||
;[[/GeoClue|GeoClue support in Marble]] | ;[[/GeoClue|GeoClue support in Marble]] | ||
=== XDG Base Directory Specification === | |||
;[[/xdg|XDG Base Directory Specification]] | |||
== Mapping Coordination == | == Mapping Coordination == | ||
Possible maps we could use: | |||
* [http://pelagios.dme.ait.ac.at/maps/greco-roman/ Tiled map of the classical world] see the [http://pelagios-project.blogspot.co.uk/2012/09/a-digital-map-of-roman-empire.html authors blog] for details | |||
* [http://www.unearthedoutdoors.net/global_data/true_marble/download TrueMarble Global 250m images] | |||
* [http://onearth.jpl.nasa.gov/ OnEarth NASA satellite images] | |||
* [http://worldwindcentral.com/wiki/Add-on:ZoomIt! ZoomIt! (in parts proprietary)] | |||
* [http://sos.noaa.gov/datasets/ NOAA Science on a Sphere] | |||
* [http://efele.net/maps/tz/world/ Olsen Time Zone map in Shapefile format]. Public Domain. Scripted to generate from current tz file. | |||
=== Natural Earth Vector Map === | |||
;[[/NaturalEarth|A proposal to use the Natural Earth vector map]] | |||
=== Documentation === | === Documentation === | ||
;[[/HistoricalMaps|How to create Historical Maps]] | ;[[/HistoricalMaps|How to create Historical Maps]] | ||
;[[/CustomMaps|How to create Custom Maps]] | |||
;[[/PalaeoMaps|Global Palaeogeography]] | ;[[/PalaeoMaps|Global Palaeogeography]] | ||
== Routing == | == Routing == | ||
;[[/ | ;[[/OnlineRoutingImplementation|Implementation of Online-Routing]] | ||
;[[/MaemoOfflineRouting|Installation of Marble and Gosmore on Maemo]] | |||
;[[/RoutingRoadmap|Routing Roadmap]] | |||
;[[/RoutingInstructions|Routing Instructions]] | |||
== valgrind == | == valgrind == | ||
Line 112: | Line 187: | ||
Summaries and logs of scheduled Marble meetings can be found on the following pages: | Summaries and logs of scheduled Marble meetings can be found on the following pages: | ||
;[[/MarbleMeeting20081029|Wednesday Nov. 10th, 2008]] | ;[[/MarbleMeeting20081029|Wednesday Nov. 10th, 2008]] | ||
;[[/MarbleMeeting20101107|Marble Weekend Sprint, Nov. 5-7]] |
Revision as of 20:50, 19 September 2012
About Marble
Success Stories: 3rd party applications using the Marble Library
Tutorials: How to use the Marble Widget in your application
With C++
- Hello World
- Changing basic map properties
- Creating a window with controls
- Painting onto the map
- Drawing in Custom Layers
- Basic Routing
- Searching for Points of Interest
- Reverse Geocoding
- Parsing Files
- Painting LineString
- Displaying GeoData Documents
How to become a Marble developer ("Marblehead")
So you are new to Marble development ...
Welcome!
Here you'll get all the information you need to start Marble development:
Compiling Marble
- Compiling on Linux
- Compiling on Windows
- Compiling on Maemo
- Compiling on MeeGo
- Compiling for Plasma Active
- Compiling on Mac OS
- Setting up QtCreator for Marble Development
Packaging Marble
- New Marble Modules (future packaging advice)
Here is some advice about how packaging is supposed to happen on the various platforms that are supported.
Tools for Marble
Here are some tools and checks that are performed on marble code:
Programming Coordination
Here are a few links to various issues we are working on:
Translation
User Interface
Texture Mapping
GeoData Library / KML
The base classes to manipulate geographic data
- GeoData Presentation
- Use cases for GeoData classes
- GeoData API Description
- Parsing GeoData
- Writing GeoData
- Pointer vs. Implicit Share
Using GeoData:
Geo Graphics View
GeoPainter / DGML
Plugin Interfaces
Marble Runner
Online Services
Projections
A little overview of map projections
Tile Download
Documentation
- How to customize maps
- How to change the PNT files used by Marble
- Marble's Secrets
- How to use the Proxy
GeoClue / GPS
XDG Base Directory Specification
Mapping Coordination
Possible maps we could use:
- Tiled map of the classical world see the authors blog for details
- TrueMarble Global 250m images
- OnEarth NASA satellite images
- ZoomIt! (in parts proprietary)
- NOAA Science on a Sphere
- Olsen Time Zone map in Shapefile format. Public Domain. Scripted to generate from current tz file.
Natural Earth Vector Map
Documentation
Routing
- Implementation of Online-Routing
- Installation of Marble and Gosmore on Maemo
- Routing Roadmap
- Routing Instructions
valgrind
if you want to fix memory leaks, you can run valgrind with:
valgrind --leak-check=full --track-origins=yes --num-callers=30 marble 2>&1 | tee MARBLE_MEMCHECK
Meetings
Summaries and logs of scheduled Marble meetings can be found on the following pages: