Release Notes

This page contains release notes and download instructions for the Tinman 3D SDK.

SDK packages can be browsed in the public download repository.

The SDK package files are password protected.
The password can be found by reading the Terms and Conditions.

Versions

These are the Tinman 3D SDK versions that are available for download.

If you are a new user, please download the 2022/10/05 - V1.0 RC4 version, unless you have specific reason to use the 2022/10/05 - PREVIEW version.

2022/10/05 - PREVIEW

This is the latest stable build of the Tinman 3D SDK.

The preview packages are updated frequently and provide the newest features and fixes.

2022/10/05 - V1.0 RC4

This is the latest official release of the Tinman 3D SDK.

The latest stable build will become the next official release.

On the date of an official release, the latest stable build is always identical to the official release, in terms of features and fixes.

2017/10/06 - V1.0 RC3

This is the previous official release of the Tinman 3D SDK.

API changes are documented against this release.

Changes

The following page represents the changelog of the Tinman 3D SDK, up to the latest stable build (2022/10/05 - PREVIEW):

API changes between the previous release (2017/10/06 - V1.0 RC3) and the latest stable build (2022/10/05 - PREVIEW) are documented here:

Breaking API change

Existing code may need to be refactored to the new API with moderate effort. For example:

  • Use a different class model for an equivalent feature.

  • Use a factory method instead of a constructor.

  • Use a builder instead of a factory method.

Trivial API change

Existing code may need to be adjusted slightly with trivial effort. For example:

  • Use a different identifier for a class, method or field.

  • Swap or re-order arguments of a method call.

No API change

Existing code does not need to be updated. Binaries usually need to be recompiled.

Please contact support@tinman3d.com if you run into problems or difficulties while adapting to API changes after updating to a newer Tinman 3D SDK version.

Version Numbering

The major version number increases if a breaking API change is introduced by a release.

The minor version number increases as long as API compatibility with the previous release is retained.

A release candidate version - tagged RC1 through RC9 - represents a milestone towards its target version along the roadmap.

Breaking API changes may be introduced by preview releases and release candidates.
Trivial API changes may be introduced by any SDK release.

Download

Before downloading and using the Tinman 3D SDK, please read and accept the Terms and Conditions.

Please refer to Getting Started and Contact and Support for instructions on how to start using the Tinman 3D SDK and how to solve common problems.

The Demo Application streams geodata over the web and caches it locally. You can bulk download all geodata for offline use from the Geodata Examples page.

No 3rd-party input geodata for the Geodata Examples is included in the SDK download.Please refer to the linked 3rd party websites for information on how to obtain this data.

Preview (Web)

The Tinman 3D SDK preview packages may be downloaded using the links below.

Please refer to the readme.txt file for additional information after downloading the packages.
Table 1. Preview package download links
URL Description

https://download.tinman3d.com/?dir=sdk/STABLE-PREVIEW

The Demo Application, packaged as a stand-alone C# application, including source code

https://download.tinman3d.com/?dir=tools

.NET 4.8 binaries of the Tinman 3D SDK tools: Workshop Application, Geodata Processor, Licence Bakery

Release (Web)

The Tinman 3D SDK release packages may be downloaded using the links below.

Please refer to the Getting Started page for additional information after downloading.
Table 2. Release packages
Filename Description

Tinman3D.SDK.zip
Tinman3D.SDK.md5

This is the primary SDK package.

Tinman3D.SDK.Source-Cs.zip.lic
Tinman3D.SDK.Source-Cs.zip.md5

This is the locked C# source code package.

Tinman3D.SDK.Source-Cpp.zip.lic
Tinman3D.SDK.Source-Cpp.zip.md5

This is the locked C++ source code package.

Tinman3D.SDK.Source-Cs.zip
Tinman3D.SDK.Source-Cs.md5

This is the unlocked C# source code package.

Tinman3D.SDK.Source-Cpp.zip
Tinman3D.SDK.Source-Cpp.md5

This is the unlocked C++ source code package.

Table 3. Release package download links
URL Version

https://download.tinman3d.com/?dir=sdk/1.0/RC4

Tinman 3D SDK RC4

https://download.tinman3d.com/?dir=sdk/1.0/RC3

Tinman 3D SDK RC3 + Hotfixes

https://download.tinman3d.com/?dir=sdk/1.0/RC2

Tinman 3D SDK RC2

https://download.tinman3d.com/?dir=sdk/1.0/RC1

Tinman 3D SDK RC1

Release (Git)

The Tinman 3D SDK release package may be accessed via Git.

The source code packages are not included in the Git repository. Please use the web downloads instead.

To clone the Tinman 3D SDK repository, run this:

git clone download-tinman3d-sdk@git.hidrive.strato.com:/public/tinman3d.sdk.git

The following branches are available:

Table 4. Release branches
Branch name Description

master

Tinman 3D SDK RC4

release/1.0/rc3

Tinman 3D SDK RC3 + Hotfixes

release/1.0/rc2

Tinman 3D SDK RC2

release/1.0/rc1

Tinman 3D SDK RC1

To checkout a specific branch, run this:

git checkout <branch-name> (1)
1 Replace <branch-name> with the branch name of your choice.

To download all updates, run this:

git pull --all