Changes between Initial Version and Version 1 of LibKML

Timestamp:

Jun 22, 2010, 8:08:07 PM (14 years ago)

Author:

ilucena

Comment:

--

LibKML

@@ +1 @@
+= LibKML =
+
+ * http://www.gdal.org/ogr/drv_libkml.html
+
+= Build with libkml =
+
+The author of the OGR/LibKML driver suggest to build against the trunk version of LibKML. The source code is maintained by SVN at http://libkml.googlecode.com/svn/trunk, so you should use SVN command line or TortoiseSVN. 
+
+The LibKML source code comes with two Visual Studio 2005. Use the one at the "msvc" folder.
+
+{{{
+.\libkml\msvc\libkml.sln
+}}}
+
+That solution does not include all the needed project, so you should do it after loading the solution on VS 2005.
+
+{{{
+.\libkml\msvc\libkmlxsd.vcproj
+.\libkml\third_party\zlib-1.2.3\contrib\minizip\minizip_static.vcproj
+}}}
+
+Note that from the SVN checkout there are more than source code but also some pre-build third part libraries.
+
+{{{
+.\libkml\third_party\expat.win32\libexpat.lib
+.\libkml\third_party\expat.win32\libexpatMT.lib
+.\libkml\third_party\expat.win32\libexpatw.lib
+.\libkml\third_party\expat.win32\libexpatwMT.lib
+.\libkml\third_party\googletest-r108.win32\debug\gtest.lib
+.\libkml\third_party\googletest-r108.win32\release\gtest.lib
+.\libkml\third_party\uriparser-0.7.5.win32\debug\uriparser.lib
+.\libkml\third_party\uriparser-0.7.5.win32\release\uriparser.lib
+.\libkml\third_party\zlib-1.2.3.win32\lib\minizip.lib
+.\libkml\third_party\zlib-1.2.3.win32\lib\zdll.lib
+.\libkml\third_party\zlib-1.2.3.win32\lib\zlib.lib
+}}}
+
+Now, you should update the file "nmake.opt" at GDAL root folder, uncommenting the lines related to libkml and changing LIBKML_DIR to reflect where LibKML is in your system.
+
+{{{
+# Uncomment out the following lines to enable LibKML support.
+LIBKML_DIR = C:/Folder Path/libkml
+LIBKML_INCLUDE = -I$(LIBKML_DIR)/src -I$(LIBKML_DIR)/third_party/boost_1_34_1
+LIBKML_LIBRARY = $(LIBKML_DIR)/msvc/Release
+LIBKML_LIBS =   $(LIBKML_LIBRARY)/libkmlbase.lib \
+                $(LIBKML_LIBRARY)/libkmlconvenience.lib \
+                $(LIBKML_LIBRARY)/libkmldom.lib \
+                $(LIBKML_LIBRARY)/libkmlengine.lib \
+                $(LIBKML_LIBRARY)/libkmlregionator.lib \
+                $(LIBKML_LIBRARY)/libkmlxsd.lib \
+                $(LIBKML_LIBRARY)/minizip_static.lib \
+                $(LIBKML_DIR)/third_party\expat.win32/libexpat.lib \
+                $(LIBKML_DIR)/third_party\uriparser-0.7.5.win32/debug/uriparser.lib \
+                $(LIBKML_DIR)/third_party\zlib-1.2.3.win32/lib/minizip.lib \
+                $(LIBKML_DIR)/third_party\zlib-1.2.3.win32/lib/zlib.lib
+}}}
+
+Now you can either rebuild, clean and build, all the GDAL project.
+
+{{{
+nmake -f makefile.vc clean
+nmake -f makefile.vc 
+nmake -f makefile.vc install
+}}}
+
+Or you can move to the driver folder and build the driver as a OGR plugin and copy the dll to gdalplugins folder.
+
+{{{
+.\gdal> cd ogr\ogrsf_frtms\libkml
+.\gdal\ogr\ogrsf_frtms\libkml> nmake -f makefile.vc ogr_LIBKML.dll
+.\gdal\ogr\ogrsf_frtms\libkml> copy ogr_LIBKML.dll <gdal path>\bin\gdalplugins
+}}}
+
+= Testing the driver =
+
+To test if the driver is been loaded:
+
+{{{
+.\> ogrinfo --formats
+Supported Formats:
+  -> "ESRI Shapefile" (read/write)
+  -> "MapInfo File" (read/write)
+  -> "UK .NTF" (readonly)
+  -> "SDTS" (readonly)
+  -> "TIGER" (read/write)
+  -> "S57" (read/write)
+  -> "DGN" (read/write)
+  -> "VRT" (readonly)
+  -> "REC" (readonly)
+  -> "Memory" (read/write)
+  -> "BNA" (read/write)
+  -> "CSV" (read/write)
+  -> "GML" (read/write)
+  -> "GPX" (read/write)
+  -> "LIBKML" (read/write)
+}}}
+
+And if you have a sample file:
+
+{{{
+.\> ogrinfo sample.kmz
+INFO: Open of `sample.kmz'
+      using driver `LIBKML' successful.
+1: 0
+}}}