Multiple changes, read updated README and CHANGELOG. Release 1.0.0.

CHANGELOG.md

@@ -0,0 +1,12 @@
+# 30.12.2018 - Released 1.0.0
+
+Changes since beta:
+
+- Changed solution architecture: previous project split upon GTiff2Tiles library and GTiff2Tiles.Test console application for running tests;
+- Fixed typo;
+- Updated GDAL and GDAL.Native from 2.3.2 to 2.3.3;
+- Moved from packages.config to PackageReference;
+- Updated README;
+- `GTiff2Tiles` class is no longer static and implements `IDisposable`;
+- FIxed some minor issues.
+

GTiff2Tiles.Test/GTiff2Tiles.Test.csproj

@@ -0,0 +1,97 @@
+<?xml version="1.0" encoding="utf-8"?>
+<Project ToolsVersion="15.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
+  <Import Project="$(MSBuildExtensionsPath)\$(MSBuildToolsVersion)\Microsoft.Common.props" Condition="Exists('$(MSBuildExtensionsPath)\$(MSBuildToolsVersion)\Microsoft.Common.props')" />
+  <PropertyGroup>
+    <Configuration Condition=" '$(Configuration)' == '' ">Debug</Configuration>
+    <Platform Condition=" '$(Platform)' == '' ">AnyCPU</Platform>
+    <ProjectGuid>{C7B939E1-C874-4F4A-8E31-86248569506E}</ProjectGuid>
+    <OutputType>Exe</OutputType>
+    <RootNamespace>GTiff2Tiles.Test</RootNamespace>
+    <AssemblyName>GTiff2Tiles.Test</AssemblyName>
+    <TargetFrameworkVersion>v4.7.2</TargetFrameworkVersion>
+    <FileAlignment>512</FileAlignment>
+    <AutoGenerateBindingRedirects>true</AutoGenerateBindingRedirects>
+    <Deterministic>true</Deterministic>
+    <NuGetPackageImportStamp>
+    </NuGetPackageImportStamp>
+  </PropertyGroup>
+  <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Debug|AnyCPU' ">
+    <PlatformTarget>AnyCPU</PlatformTarget>
+    <DebugSymbols>true</DebugSymbols>
+    <DebugType>full</DebugType>
+    <Optimize>false</Optimize>
+    <OutputPath>bin\Debug\</OutputPath>
+    <DefineConstants>DEBUG;TRACE</DefineConstants>
+    <ErrorReport>prompt</ErrorReport>
+    <WarningLevel>4</WarningLevel>
+  </PropertyGroup>
+  <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Release|AnyCPU' ">
+    <PlatformTarget>AnyCPU</PlatformTarget>
+    <DebugType>pdbonly</DebugType>
+    <Optimize>true</Optimize>
+    <OutputPath>bin\Release\</OutputPath>
+    <DefineConstants>TRACE</DefineConstants>
+    <ErrorReport>prompt</ErrorReport>
+    <WarningLevel>4</WarningLevel>
+  </PropertyGroup>
+  <PropertyGroup Condition="'$(Configuration)|$(Platform)' == 'Debug|x64'">
+    <DebugSymbols>true</DebugSymbols>
+    <OutputPath>bin\x64\Debug\</OutputPath>
+    <DefineConstants>DEBUG;TRACE</DefineConstants>
+    <DebugType>full</DebugType>
+    <PlatformTarget>x64</PlatformTarget>
+    <ErrorReport>prompt</ErrorReport>
+    <CodeAnalysisRuleSet>MinimumRecommendedRules.ruleset</CodeAnalysisRuleSet>
+    <Prefer32Bit>true</Prefer32Bit>
+    <LangVersion>latest</LangVersion>
+    <CheckForOverflowUnderflow>true</CheckForOverflowUnderflow>
+  </PropertyGroup>
+  <PropertyGroup Condition="'$(Configuration)|$(Platform)' == 'Release|x64'">
+    <OutputPath>bin\x64\Release\</OutputPath>
+    <DefineConstants>TRACE</DefineConstants>
+    <Optimize>true</Optimize>
+    <DebugType>none</DebugType>
+    <PlatformTarget>x64</PlatformTarget>
+    <ErrorReport>prompt</ErrorReport>
+    <CodeAnalysisRuleSet>MinimumRecommendedRules.ruleset</CodeAnalysisRuleSet>
+    <Prefer32Bit>true</Prefer32Bit>
+    <LangVersion>latest</LangVersion>
+    <CheckForOverflowUnderflow>true</CheckForOverflowUnderflow>
+  </PropertyGroup>
+  <PropertyGroup>
+    <StartupObject>GTiff2Tiles.Test.Program</StartupObject>
+  </PropertyGroup>
+  <ItemGroup>
+    <Reference Include="System" />
+    <Reference Include="System.Core" />
+    <Reference Include="System.Xml.Linq" />
+    <Reference Include="System.Data.DataSetExtensions" />
+    <Reference Include="Microsoft.CSharp" />
+    <Reference Include="System.Data" />
+    <Reference Include="System.Net.Http" />
+    <Reference Include="System.Xml" />
+  </ItemGroup>
+  <ItemGroup>
+    <Compile Include="GdalConfiguration.cs" />
+    <Compile Include="Program.cs" />
+    <Compile Include="Properties\AssemblyInfo.cs" />
+  </ItemGroup>
+  <ItemGroup>
+    <None Include="App.config" />
+  </ItemGroup>
+  <ItemGroup>
+    <PackageReference Include="GDAL">
+      <Version>2.3.3</Version>
+    </PackageReference>
+    <PackageReference Include="GDAL.Native">
+      <Version>2.3.3</Version>
+    </PackageReference>
+  </ItemGroup>
+  <ItemGroup>
+    <ProjectReference Include="..\GTiff2Tiles\GTiff2Tiles.csproj">
+      <Project>{79237cdc-654a-4cb3-983c-5e5138e0dadc}</Project>
+      <Name>GTiff2Tiles</Name>
+    </ProjectReference>
+  </ItemGroup>
+  <Import Project="$(MSBuildToolsPath)\Microsoft.CSharp.targets" />
+</Project>

GTiff2Tiles.Test/GdalConfiguration.cs

@@ -0,0 +1,230 @@
+/******************************************************************************
+ *
+ * Name:     GdalConfiguration.cs.pp
+ * Project:  GDAL CSharp Interface
+ * Purpose:  A static configuration utility class to enable GDAL/OGR.
+ * Author:   Felix Obermaier
+ *
+ ******************************************************************************
+ * Copyright (c) 2012-2018, Felix Obermaier
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a
+ * copy of this software and associated documentation files (the "Software"),
+ * to deal in the Software without restriction, including without limitation
+ * the rights to use, copy, modify, merge, publish, distribute, sublicense,
+ * and/or sell copies of the Software, and to permit persons to whom the
+ * Software is furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included
+ * in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+ * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
+ * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+ * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+ * DEALINGS IN THE SOFTWARE.
+ *****************************************************************************/
+
+using System;
+using System.Diagnostics;
+using System.IO;
+using System.Reflection;
+using System.Runtime.InteropServices;
+using OSGeo.GDAL;
+using OSGeo.OGR;
+
+namespace GTiff2Tiles.Test
+{
+    /// <summary>
+    /// Class for configurating gdal's environment variables.
+    /// </summary>
+    public static class GdalConfiguration
+    {
+        #region Properties and fields
+
+        /// <summary>
+        /// Shows if ogr configured.
+        /// </summary>
+        private static bool IsOgrConfigured { get; set; }
+
+        /// <summary>
+        /// Shows if gdal configured.
+        /// </summary>
+        private static bool IsGdalConfigured { get; set; }
+
+        /// <summary>
+        /// Gets a value indicating if the GDAL package is set up properly.
+        /// </summary>
+        public static bool Usable { get; private set; }
+
+        [DllImport("kernel32", CharSet = CharSet.Auto, SetLastError = true)]
+        static extern bool SetDefaultDllDirectories(uint directoryFlags);
+        //               LOAD_LIBRARY_SEARCH_USER_DIRS | LOAD_LIBRARY_SEARCH_SYSTEM32
+        private const uint DllSearchFlags = 0x00000400 | 0x00000800;
+
+        [DllImport("kernel32.dll", CharSet = CharSet.Unicode, SetLastError = true)]
+        [return: MarshalAs(UnmanagedType.Bool)]
+        static extern bool AddDllDirectory(string lpPathName);
+
+        #endregion
+
+        #region Constructor
+
+        /// <summary>
+        /// Construction of Gdal/Ogr
+        /// </summary>
+        static GdalConfiguration()
+        {
+            string executingDirectory = null, gdalPath = null, nativePath = null;
+            try
+            {
+                if (!IsWindows)
+                {
+                    const string notSet = "_Not_set_";
+                    string tmp = Gdal.GetConfigOption("GDAL_DATA", notSet);
+                    Usable = tmp != notSet;
+                    return;
+                }
+
+                string executingAssemblyFile = Assembly.GetExecutingAssembly().Location;
+                executingDirectory = Path.GetDirectoryName(executingAssemblyFile);
+
+                if (string.IsNullOrEmpty(executingDirectory))
+                    throw new InvalidOperationException("cannot get executing directory");
+
+                // modify search place and order
+                SetDefaultDllDirectories(DllSearchFlags);
+
+                gdalPath = Path.Combine(executingDirectory, "gdal");
+                nativePath = Path.Combine(gdalPath, GetPlatform());
+                if (!Directory.Exists(nativePath))
+                    throw new DirectoryNotFoundException($"GDAL native directory not found at '{nativePath}'");
+                if (!File.Exists(Path.Combine(nativePath, "gdal_wrap.dll")))
+                    throw new FileNotFoundException(
+                                                    $"GDAL native wrapper file not found at '{Path.Combine(nativePath, "gdal_wrap.dll")}'");
+
+                // Add directories
+                AddDllDirectory(nativePath);
+                AddDllDirectory(Path.Combine(nativePath, "plugins"));
+
+                // Set the additional GDAL environment variables.
+                string gdalData = Path.Combine(gdalPath, "data");
+                Environment.SetEnvironmentVariable("GDAL_DATA", gdalData);
+                Gdal.SetConfigOption("GDAL_DATA", gdalData);
+
+                string driverPath = Path.Combine(nativePath, "plugins");
+                Environment.SetEnvironmentVariable("GDAL_DRIVER_PATH", driverPath);
+                Gdal.SetConfigOption("GDAL_DRIVER_PATH", driverPath);
+
+                Environment.SetEnvironmentVariable("GEOTIFF_CSV", gdalData);
+                Gdal.SetConfigOption("GEOTIFF_CSV", gdalData);
+
+                string projSharePath = Path.Combine(gdalPath, "share");
+                Environment.SetEnvironmentVariable("PROJ_LIB", projSharePath);
+                Gdal.SetConfigOption("PROJ_LIB", projSharePath);
+
+                Usable = true;
+            }
+            catch (Exception e)
+            {
+                Usable = false;
+                Trace.WriteLine(e, "error");
+                Trace.WriteLine($"Executing directory: {executingDirectory}", "error");
+                Trace.WriteLine($"gdal directory: {gdalPath}", "error");
+                Trace.WriteLine($"native directory: {nativePath}", "error");
+
+                //throw;
+            }
+        }
+
+        #endregion
+
+        #region Methods
+
+        #region Private
+
+        /// <summary>
+        /// Function to determine which platform we're on
+        /// </summary>
+        private static string GetPlatform() => Environment.Is64BitProcess ? "x64" : "x86";
+
+        /// <summary>
+        /// Gets a value indicating if we are on a windows platform
+        /// </summary>
+        private static bool IsWindows => !(Environment.OSVersion.Platform == PlatformID.Unix ||
+                                           Environment.OSVersion.Platform == PlatformID.MacOSX);
+
+        /// <summary>
+        /// Prints available OGR drivers in DEBUG.
+        /// </summary>
+        private static void PrintDriversOgr()
+        {
+            if (!Usable) return;
+
+            int num = Ogr.GetDriverCount();
+            for (int i = 0; i < num; i++)
+            {
+                OSGeo.OGR.Driver driver = Ogr.GetDriver(i);
+                Trace.WriteLine($"OGR {i}: {driver.GetName()}", "Debug");
+            }
+        }
+
+        /// <summary>
+        /// Prints available GDAL drivers in DEBUG.
+        /// </summary>
+        private static void PrintDriversGdal()
+        {
+            if (!Usable) return;
+            int num = Gdal.GetDriverCount();
+            for (int i = 0; i < num; i++)
+            {
+                OSGeo.GDAL.Driver driver = Gdal.GetDriver(i);
+                Trace.WriteLine($"GDAL {i}: {driver.ShortName}-{driver.LongName}");
+            }
+        }
+
+        #endregion
+
+        #region Public
+
+        /// <summary>
+        /// Method to ensure the static constructor is being called.
+        /// </summary>
+        /// <remarks>Be sure to call this function before using Gdal/Ogr/Osr</remarks>
+        public static void ConfigureOgr()
+        {
+            if (!Usable) return;
+            if (IsOgrConfigured) return;
+
+            // Register drivers
+            Ogr.RegisterAll();
+            IsOgrConfigured = true;
+            #if DEBUG
+            PrintDriversOgr();
+            #endif
+        }
+
+        /// <summary>
+        /// Method to ensure the static constructor is being called.
+        /// </summary>
+        /// <remarks>Be sure to call this function before using Gdal/Ogr/Osr</remarks>
+        public static void ConfigureGdal()
+        {
+            if (!Usable) return;
+            if (IsGdalConfigured) return;
+
+            // Register drivers
+            Gdal.AllRegister();
+            IsGdalConfigured = true;
+            #if DEBUG
+            PrintDriversGdal();
+            #endif
+        }
+
+        #endregion
+
+        #endregion
+    }
+}