documentation

Version Info

Release date: 04.06.2018

General

This is a prerelease which has fixed various bugs and added some small new features. So it can be concidered as maintenance release.

Bugfixes

• Fixed GetVersionHashString and GetVersionTimestampString function, which were previously only returning empty strings.
• Certain errors (e.g. missing initDataURI file) weren't reported as errors to VLWorkerBehaviour.OnTrackerInitialized listeners.
• It's now possible to set the init pose of the ModelTracker_v1 at runtime without having to wait 20 frames first.
• The camera position for UWP builds should now be reported correctly by the VLAbstractApplicationWrapper.GetDeviceInfo function. The position might still be an empty string or "unknown", if the system can't provide this information.

Enhancements/Features

• Added first support for Mesa OpenGL rendering on Windows.
• ARKit 1.5 integration works properly now on all devices.
• It's now possible to define a camera image source with an empty or missing data object. If such a camera image source is used (useImageSource), then the first available camera will get selected automatically. This makes it possible, to easily switching between automatic camera selection and other image sources.
• Added position parameter for camera image sources. This parameter allows to automatically select a camera based on its position. Supported positions are "front" and "back". Please notice, that this will not work with external cameras and on systems which don't report the camera position.
• The deviceID, position and unit parameters of camera image sources are now interpreted as hints. All of those parameters are optional. If no matching camera can be found, then the first available camera will get selected. Only if no camera can be detected at all, then an error will be reported. The camera hints have the following priority:
  1. deviceID
  2. position
  3. unit
• On UWP the first found camera was always selected. Now it should also be possible to select any other detected camera.
• Better camera support for UWP. Certain cameras weren't working before.
• Loading vl-files now requires less time. This is especially noticeable on the HoloLens.
• Experimental: Extendible tracking with ARKit 1.5 support now also supports the staticScene parameter, which should be set to true. This stabilizes the pose in case the camera is not moved within a certain distance using ARKit. The distance can be configured using the keyFrameDistance parameter in mm or overwriting the _staticScenePrefExtPoseDistance.

Breaking changes

• Restructured the internal image source acquisition. If you have been using one of the following values for the "device" parameter, then please replace "device" with "deviceID": SMG925F, SMG928F, SMT715, SMT800, SMT805, SMT807, SMT805W, SMT810, SMT813, SMT815.

Interfaces

Native

• The vlAbstractApplicationWrapper_GetDeviceInfo function now also returns the available resolutions on Windows (non-UWP) systems.

Unity

• The SimpleCameraCalibrationExample now allows to select the camera resolution on Windows (non-UWP) systems. To activate this feature please set the resolutionSelection attribute of the CameraCalibrationExampleBehaviour to true (the CameraCalibrationExampleBehaviour is attached to the VLCamera GameObject).

Documentation Changes

• Updated the used licenses section in the documentation.