Projects/Marble/PNTFiles - Revision history

Tackat at 11:31, 19 May 2012

2012-05-19T11:31:53Z

Tackat at 11:28, 19 May 2012

2012-05-19T11:28:12Z

Tackat at 10:20, 19 May 2012

2012-05-19T10:20:20Z

Tackat at 10:09, 19 May 2012

2012-05-19T10:09:39Z

Tackat at 10:09, 19 May 2012

2012-05-19T10:09:12Z

Tackat at 10:07, 19 May 2012

2012-05-19T10:07:04Z

Tackat at 10:06, 19 May 2012

2012-05-19T10:06:42Z

Tackat at 10:01, 19 May 2012

2012-05-19T10:01:14Z

Tackat at 09:57, 19 May 2012

2012-05-19T09:57:31Z

Tackat at 09:48, 19 May 2012

2012-05-19T09:48:13Z

@@ Line 64: / Line 64: @@
 </source>
-and then restart Marble. The modified line should appear now. Note that if you want to replace a second line in addtion then you need to call the pntreplace tool on the modified TEST.PNT file! This could be done like this:
+and then restart Marble. The modified line should appear now. Note that if you want to replace a second line in addtion then you need to call the '''pntreplace''' tool on the modified TEST.PNT file! This could be done like this:
 <source lang="bash">

@@ Line 64: / Line 64: @@
 </source>
-and then restart Marble. The modified line should appear now. Note that if you want to replace a second line in addtion then you need to call the pdfreplace tool on the modified TEST.PNT file! This could be done like this:
+and then restart Marble. The modified line should appear now. Note that if you want to replace a second line in addtion then you need to call the pntreplace tool on the modified TEST.PNT file! This could be done like this:
 <source lang="bash">

← Older revision		Revision as of 10:20, 19 May 2012
Line 81:		Line 81:

	In addition to the tools mentioned there are also two other ones: '''svg2pnt''' which converts a whole svg (with proper canvas size) to a pnt file or appends it to an existing one. And there is '''pntdel''' that allows to delete polylines with a certain PNT header id from an existing PNT file.		In addition to the tools mentioned there are also two other ones: '''svg2pnt''' which converts a whole svg (with proper canvas size) to a pnt file or appends it to an existing one. And there is '''pntdel''' that allows to delete polylines with a certain PNT header id from an existing PNT file.
		+
		+	Last but not least here is the manually adjusted svg file:

	[[Media:indiapnt.svg]]		[[Media:indiapnt.svg]]
		+
		+	In the associated [https://bugs.kde.org/show_bug.cgi?id=300125 bug report] you can download the ready-made PNT file from this example.
		+
		+	''
		+	Note that for the officially distributed version of Marble we try to stick to the most recent internationally accepted country boundaries only! You are however free to create, publish and deploy your own modified PNT files. And we are certainly interested in receiving any modified versions.''

← Older revision		Revision as of 10:09, 19 May 2012
Line 82:		Line 82:
	In addition to the tools mentioned there are also two other ones: '''svg2pnt''' which converts a whole svg (with proper canvas size) to a pnt file or appends it to an existing one. And there is '''pntdel''' that allows to delete polylines with a certain PNT header id from an existing PNT file.		In addition to the tools mentioned there are also two other ones: '''svg2pnt''' which converts a whole svg (with proper canvas size) to a pnt file or appends it to an existing one. And there is '''pntdel''' that allows to delete polylines with a certain PNT header id from an existing PNT file.

−	[[Media:~~india~~.svg]]	+	[[Media:indiapnt.svg]]

← Older revision		Revision as of 10:09, 19 May 2012
Line 81:		Line 81:

	In addition to the tools mentioned there are also two other ones: '''svg2pnt''' which converts a whole svg (with proper canvas size) to a pnt file or appends it to an existing one. And there is '''pntdel''' that allows to delete polylines with a certain PNT header id from an existing PNT file.		In addition to the tools mentioned there are also two other ones: '''svg2pnt''' which converts a whole svg (with proper canvas size) to a pnt file or appends it to an existing one. And there is '''pntdel''' that allows to delete polylines with a certain PNT header id from an existing PNT file.
		+
		+	[[Media:india.svg]]

@@ Line 6: / Line 6: @@
 First you go into the directory marble/tools/pnt2svg which is located in Marble's source code. You then need to type "qmake" and press the Enter key. Afterwards you need to press "make" and the Enter key. After successful compilation you should now have a tool that allows to convert PNT files to SVG files. You can convert a whole PNT file to SVG or just portions of it by specifying a bounding rect. The PNT file that describes the border lines for Marble is located at marble/data/mwdbii/PDIFFBORDER.PNT inside the sources. Inside the marble/tools/pnt2svg directory you can now execute the following command:
 <source lang="bash">
@@ Line 13: / Line 12: @@
 Now start up inkscape via
 <source lang="bash">
@@ Line 20: / Line 18: @@
 And you can see all the boundaries of the world inside inkscape in full glory. But as described above we just want to change the indian boundaries. So we close inkscape again and try to limit the exported boundaries by specifying a bounding box:
 <source lang="bash">

@@ Line 7: / Line 7: @@
 First you go into the directory marble/tools/pnt2svg which is located in Marble's source code. You then need to type "qmake" and press the Enter key. Afterwards you need to press "make" and the Enter key. After successful compilation you should now have a tool that allows to convert PNT files to SVG files. You can convert a whole PNT file to SVG or just portions of it by specifying a bounding rect. The PNT file that describes the border lines for Marble is located at marble/data/mwdbii/PDIFFBORDER.PNT inside the sources. Inside the marble/tools/pnt2svg directory you can now execute the following command:
 ./pnt2svg -i ../../data/mwdbii/PDIFFBORDER.PNT -o world.svg
 Now start up inkscape via
 inkscape world.svg
 And you can see all the boundaries of the world inside inkscape in full glory. But as described above we just want to change the indian boundaries. So we close inkscape again and try to limit the exported boundaries by specifying a bounding box:
 ./pnt2svg -i ../../data/mwdbii/PDIFFBORDER.PNT -cw 65 -ce 130.00 -cn 60.00 -cs 20.00
 By default if no output file is specified pnt2svg will save the data into "output.svg".
 So the latest command will create an svg file called "output.svg" which contains just those boundary lines which are fully located inside the bounding box 60°N, 65°E, 130°E, 20°N. We can again open the file using inkscape by calling
 inkscape output.svg
 [[File:pnt1.jpg |500px]]
@@ Line 46: / Line 57: @@
 Now we want to replace the original paths with our modified versions. In order to do this we need the pntreplace tool. Just like with "pnt2svg" we go into the directory marble/tools/pntreplace and we call "qmake" and "make" there. Now our tool is ready for use. We now call:
 ./pntreplace -i ../../data/mwdbii/PDIFFBORDER.PNT -o TEST.PNT -s ../pnt2svg/output.svg -id 9083 -path path62_9083
 This will create a new PNT file called "TEST.PNT" which has the boundary with the PNT header id "9083" replaced by the path "path62_9083" from our modified SVG file. You can now copy the file TEST.PNT over into your system directory (be careful and note that your system directory will likely be a different one!)
 sudo cp TEST.PNT /usr/local/share/apps/marble/data/mwdbii/PDIFFBORDER.PNT
 and then restart Marble. The modified line should appear now. Note that if you want to replace a second line in addtion then you need to call the pdfreplace tool on the modified TEST.PNT file! This could be done like this:
 ./pntreplace -i TEST.PNT -o TEST2.PNT -s output.svg -id 9063 -path path48_9063
 and afterwards you could copy the result over into the marble system data directory:
 sudo cp TEST2.PNT /usr/local/share/apps/marble/data/mwdbii/PDIFFBORDER.PNT
 Once done you can start Marble again and enjoy your newly modified PNT file.

@@ Line 1: / Line 1: @@
 Since the beginning of the Marble Virtual Globe we've used the [http://www.ngdc.noaa.gov/ecosys/cdroms/ged_iib/datasets/b14/mw.htm Microworld II Database (MWDBII)] as a resource for vector data. This dataset has the advantage that it's small and can easily get shipped with Marble. One of the disadvantages has been that it hasn't been updated since 1995 and is provided in the PNT format. So far there have been no tools available to edit these PNT files. This however is especially important for editing country borders.
-In order to allow editing of PNT files we've recently created a set of PNT editing tools. These allow users to modify PNT files using [http://www.inkscape.org Inkscape]. Here is an example on how to make use of these:
+In order to allow editing of PNT files we've recently created a set of '''PNT editing tools'''. These allow advanced users to modify PNT files using [http://www.inkscape.org Inkscape]. Here is an example on how to make use of these:
 You need a recent checkout of the [http://edu.kde.org/marble/obtain.php Marble Source Code] and a recent version of the Qt library and its development files. For illustration we'll replace the internationally recognized boundaries of India inside Marble by those which are used on Indian official maps as an example:
@@ Line 64: / Line 64: @@
 [[File:pnt4.jpg |500px]]
-In addition to the tools mentioned there are also two other ones: svg2pnt which converts a whole svg (with proper canvas size) to a pnt file or appends it to an existing one. And there is pntdel that allows to delete polylines with a certain PNT header id from an existing PNT file.
+In addition to the tools mentioned there are also two other ones: '''svg2pnt''' which converts a whole svg (with proper canvas size) to a pnt file or appends it to an existing one. And there is '''pntdel''' that allows to delete polylines with a certain PNT header id from an existing PNT file.

@@ Line 27: / Line 27: @@
 Once you have just one or two lines left you can save your work already. Before you save it's absolutely necessary that you adjust the Inkscape settings: ''Go into "File->Inkscape Preferences". Look for "SVG Output" on the left and '''uncheck''' "Allow relative coordinates" and '''check''' "Force repeat commands".''
 If you look at the saved file with a text editor there should only be very few (one or two) "path" xml tag elements inside the file.
@@ Line 34: / Line 36: @@
 [[File:pnt2.jpg |500px]]
-In our example we just move the nodes and border lines a bit to match the desired shape. You could import a (properly licensed) bitmap map as a "template". Note however that the map you import needs to be in "Equirectangular Projection" / "Plate Carree Projection". Once you are done, save your work. Open up the SVG file with a text editor. Inside you'll still find the path xml elements. Look for a string that looks like this (just with other numbers): id="path62_9083". You need to remember your path id for later use. The second number (here: "9083") resembles the header id in the PNT file.
+In our example we just move the nodes and border lines a bit to match the desired shape. You could import a (properly licensed) bitmap map as a "template". Note however that the map you import needs to be in "Equirectangular Projection" / "Plate Carree Projection". Once you are done, save your work.
 [[File:pnt3.jpg |500px]]
 Now we want to replace the original paths with our modified versions. In order to do this we need the pntreplace tool. Just like with "pnt2svg" we go into the directory marble/tools/pntreplace and we call "qmake" and "make" there. Now our tool is ready for use. We now call: