Version 2.0.0 of the TanvasTouch SDK changes some APIs in the goal of simplifying application development. This page describes the changes in the SDK and how to adjust your application code to account for these changes.
The TanvasTouch Engine Dashboard requires a user license for development features
The use of development features of the TanvasTouch Engine Dashboard now requires a user license.
If you purchased a Mimo Vue with TanvasTouch screen prior to December 2019, you should have received a user license key in your email. If you purchased a Mimo Vue with TanvasTouch screen prior to December 2019 and did not receive a user license key, please contact us.
.NET API Changes
Now shipping NuGet packages
The .NET API is now available as a set of NuGet packages on the NuGet Package Gallery. Here are links to the packages:
- Tanvas.TanvasTouch: the core .NET API
- Tanvas.TanvasTouch.WpfUtilities: convenience functions for building TanvasTouch applications using WPF
To convert a .NET application to use the NuGet package, please see the page “Using the .NET API NuGet Packages“.
Application licensing is no longer required
The following methods have been removed:
TanvasTouch.API.WaitForLicensingTanvasTouch.API.GetLicenseStatus
Remove any calls to these methods from your code.
The TanvasTouch.API.Initialize(string app_id, string license_key, string engine_name) method has been marked as deprecated. It has been replaced with TanvasTouch.API.Initialize(string engine_name = null). Calls to the three-argument form of initialize can be converted to the one-argument form by deleting the app_id and license_key arguments.
Version 2.0.0 of the SDK no longer requires application IDs or license keys, so these can also be removed from your application code.
The .NET API namespace is now Tanvas.TanvasTouch
The .NET API namespaces have been changed to be more consistent with Microsoft’s namespace guidelines:
| Old Namespace | New Namespace |
|---|---|
TanvasTouch.API | Tanvas.TanvasTouch.API |
TanvasTouch.Resource | Tanvas.TanvasTouch.Resource |
TanvasTouch.Error | Tanvas.TanvasTouch.Error |
TanvasTouch.Service | Tanvas.TanvasTouch.Service |
New WPF utility library
SDK 2.0.0 contains the first release of the Tanvas.TanvasTouch.WpfUtilities library. This library contains routines built on WPF for matching TView and window positions and converting PNG data to TTextures. For more information on this library, see the C# API documentation.
C++ API Changes
Application licensing is no longer required
The following functions have been removed:
tanvastouch::reinitializetanvastouch::wait_for_licensingtanvastouch::get_license_status
Remove any calls to these functions from your code.
The tanvastouch::initialize(std::string app_id, std::string license_key, std::optional<std::string> engine_name) function has been replaced by tanvastouch::initialize(std::optional<std::string> engine_name = std::nullopt). Calls to the three-argument form of initialize can be converted to the one-argument form by deleting the app_id and license_key arguments.
Version 2.0.0 of the SDK no longer requires application IDs or license keys, so these can be removed from your application code.
C API Changes
Application licensing is no longer required
The following functions have been removed without replacement:
tanvastouch_wait_for_licensingtanvastouch_get_license_status
The tanvastouch_open(const char* engine_name, const char* app_id, const char* license_key, tanvastouch_ctx** p_ctx) function has been modified to tanvastouch_open(const char* engine_name, tanvastouch_ctx** p_ctx). Calls to the four-argument form of tanvastouch_open can be converted to the two-argument form by deleting the app_id and license_key arguments.
Version 2.0.0 of the SDK no longer requires application IDs or license keys, so these can be removed from your application code.