documentation

Release 19.7.1

Version Info

Release date: 26.07.2019 Release info: Maintenance Release

General

This release is a maintenance release. It fixes a lot of issues regarding stability and maintainability.

Bugfixes

  • Fixing an issue, where the SDK listed cameras twice under UWP.
  • Threading problems regarding the camera interface under UWP/HoloLens while shutting down the vlSDK has been fixed.
  • The image provided by the vlSDK on HoloLens has been changed to RGBA (as given by the GetFormat function of the VLImageWrapper)
  • Fixed a typo in the "quality" attribute of camera calibration. The best calibration quality is now stated as awesome instead of awsome. Please make sure to adapt your code to the correct spelling, if it relied on the misspelled variant.

Android

  • Increased default image resolution on Android.
  • Fixed failing camera aquisition on some Android devices.

HoloLens

  • Specifying "deviceID": "HoloLens" disabled the automatic camera calibration on the HoloLens (using "device": "HoloLens", as shown in our documentation, is fine). In some cases this led to a misalignment of the displayed model. Now "deviceID": "HoloLens" works as expected and the automatic camera calibration provided by the HoloLens will be used. Since the usage of "device" is deprecated, we urge everyone to switch to "deviceID".
  • Defining "device": "HoloLens" or "deviceID": "HoloLens" in HoloLens tracking configurations isn't necessary anymore. The system now automatically detects, that it's running on a HoloLens and uses the correct camera configuration.
  • Removed "device": "HoloLens" in the provided HoloLens example tracking configuration.
  • Fixed some transformation problems in the model streaming for HoloLens.
  • Fixed a bug on the HoloLens, which in rare occasions would cause a crash before and after the application was suspended.

Windows

  • Fixed a problem in model streaming from Unity to vlSDK which mirrored the models arround the z-axis
  • Systems which only support OpenGL 3.0 were producing corrupted line-models. The line-model generation on those systems should work fine now.

Enhancements/Features

  • Timestamps have been added for all platforms and are available in the tracking states.
  • Added a new init issue indicating that the choosen camera has been removed or is used by another process.

Platform specific changes

MacOS

  • An issue has been resolved, where the FaceTime camera could not be accessed on MacBook.
  • Cameras now also support high resolution mode (by setting resolution:"high" in the input section). This will yield in using a HD resolution.

Native

  • Added an example, which show how to perform the tracking under UWP using the native C-API of the vlSDK. For a detailed tutorial see Building the UWP Example.

Unity

  • Removed unnecessary GameObjects from SimpleCameraCalibrationExample scene.
  • Moved camera calibration related scripts in SimpleCameraCalibrationExample scene to a separate CameraCalibration GameObject to make them easier to find.
  • Removed the UpdateWorldAnchor function from VLHoloLensTrackerBehaviour.cs.
  • Reduced the computational effort in Unity for HoloLens applications during the initialization phase.
  • Set the framerate in the provided HoloLens example tracking configurations to 30 (was 5). This is now sensible, due the aforementioned performance enhancements.
  • The VLRenderBackgroundImageBehaviour now explicitly deletes the "VLBackground" GameObject and its children on destruction. This was causing a memory leak.
  • Removed warning messages, which occurred after doing a successful camera calibration without an already existing calibration.json file. The calibration was still written correctly, just the warning messages were mistakenly produced.
  • BREAKING CHANGE iOS builds now use an embedded library (vlSDK.framework) when creating the project. When you have updated the plugin, it is recommended recreating your Xcode projects from scratch. You will need to remove the libvlSDK.a file from the Plugins/iOS folder.
  • BREAKING CHANGE The LegoExample folder has been renamed to buildingBricks. Please also rename (or remove) the LegoExample folder in Models and in Scripts before updating the vlUnitySDK.

Android

  • Added support for 64bit ARM builds