GTiff2Tiles

GTiff2Tiles is an analogue of gdal2tiles.py and MapTiler on C# for creating tiles.

Table of contents

• GTiff2Tiles
  • Current version
  • Docker Images
  • Build
  • Documentation
  • Examples
  • TODO
  • Contributing
  • License
  • 3rd party resources

Table of contents generated with markdown-toc.

Current version

Release 1.4.1 is the last release to support .NET Standard 2.0. Starting from version 2.0.0 solution targets .NET Core/.NET only!

Current stable version can be found on GitHub Releases page: , on NuGet (GTiff2Tiles.Core only): and GitHub Packages Feed.

Pre-release versions by CI are also available on Releases page, nuget and docker hub.

Information about changes since previous releases can be found in changelog. This project supports SemVer 2.0.0 (template is {MAJOR}.{MINOR}.{PATCH}.{BUILD}).

Previous versions can also be found on releases, tags and branches (source code) pages.

Docker Images

Latest pre-built docker images (from master branch) for GTiff2Tiles.Console are available on GitHub Packages Feed (docker pull docker.pkg.github.com/gigas002/gtiff2tiles/gtiff2tiles-console:latest) and on Docker Hub (docker pull gigas002/gtiff2tiles-console).

You can also build docker image by yourself by running publish-local-docker.ps1 script with your PowerShell/PowerShell Core. It’ll create gtiff2tiles-console image.

Build

Preferred way to build the solution is to use VS2022 (17.0.0+), but you can also build projects, using dotnet CLI in your terminal or in VSCode (1.63.0+) with ms-dotnettools.csharp (1.23.16+) extension. Projects targets .NET 6.0.0, so you’ll need .NET 6.0.100 SDK.

Apps release binaries are made by publish-github-release.ps1 script, nuget package generated by publish-github-nupkg.ps1 script, docker images are created by publish-local-docker.ps1 and publish-github-docker.ps1 scripts. You can run tests and analyze code coverage by using codecov-local.ps1 script. Docs are generated by create-docs.ps1 script.

Note, that running these scripts requires installed PowerShell or PowerShell Core (also available on Linux/OSX systems!).

You'll also find full list for dependencies for all projects on the corresponding pages.

Documentation

Docs are available to browse on GitHub Pages. The offline alternative for core is pdf or generating docs by yourself, using docfx and create-docs.ps1 script. For offline users, you can also read .md files in corresponding directory if each project (info is the same, as on GitHub Pages).

Outdated docs for release 1.4.x Core's API are available on GitHub Wiki.

Examples

In Examples directory you can find GeoTIFFs for some tests. Run codecov-local.ps1 script, and you'll see the new Output folder, in which test results are thrown.

TODO

You can track, what’s planned to do in future releases on projects and milestones pages.

Contributing

Feel free to contribute, make forks, change some code, add issues, etc.

License

Project is licensed under DBAD license.

3rd party resources

Icon is provided by Google’s material design and is used in all of GTiff2Tiles projects.

Examples GeoTIFFs for Tokyo were downloaded using free & opensource SAS Planet from bing maps.