search

OpenOrienteering / mapper

OpenOrienteering Mapper is a software for creating maps for the orienteering sport.
https://www.openorienteering.org/apps/mapper/
GNU General Public License v3.0
404 stars 109 forks source link

XML format documentation #182

Open dg0yt opened 11 years ago

dg0yt commented 11 years ago

dg0yt reported on Sourceforge [tickets:#182]:

(Moved from #97.)

Kai pastor or schöps, i would be happy if i could be able to talk to one Of you about the "docomentation" of the XML format? In short, I'm trying to develop a converser between shapefile and a open orienteering-readable file, write to rasmus@dronningvej14.dk, and I'll clearefy :)

dg0yt commented 11 years ago

There is no official documentation of the XML format at the moment, and it is still subject to extension and improvement. However, the format is quite verbose, and when saving with an .xmap extension, files are pretty formatted.

To get a simple example of the file format, I would suggest to copy and paste a simple object, such as a single tree, to an empty map (with empty symbol set), and save the result as .xmap.

It is important to know that we use a streaming XML reader, so the elements need to be in a certain order. But Mapper is not supposed to crash for invalid data, this would be a Mapper bug.

Objects coordinates are given in millimeters on paper only. For this reason it might not be feasible to convert geodata to the Mapper XML format. However we have working basic implementations of importing geodata formats such as GPX, DXF or OSM, unrelated to the XML format.

Kai.

dg0yt commented 6 years ago

Added documentation page skeleton in 950ed5a.

lpechacek commented 5 years ago

Petr Beneš did the file format analysis and produced a XSD for .omap. I'm attaching the file he sent me. Petr also drafted a document describing the file structure (he's calling it "remarks"). I'm checking with him if he's fine with my publishing them here.

oomapper.xsd.gz