Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
Visage Technologies strives to minimize changes in API and configuration files when releasing new versions of the SDK. The inevitable changes are listed here, together with specific instructions for developers who have the existing applications built with older versions.
For each visage|SDK release, the incremental changes in relation to the previous release are listed. To apply the changes correctly, apply them in order from the older version to the newer version without skipping intermediary versions.
Contents
Table of Contents | ||||||
---|---|---|---|---|---|---|
|
visage|SDK 9.1
Landmark detection changes:
Expand | ||
---|---|---|
| ||
Additional eyebrows landmarks
Additional eyes landmarks
Additional lips landmarks
For more details please see FDP documentation. |
Changes in configuration file:
Expand | ||
---|---|---|
| ||
enable_smoothing configuration parameter added. Controls whether the tracker output is smoothed with the smoothing_factors parameter or not.
|
Expand | ||
---|---|---|
| ||
temporally_denoise_input configuration parameter added. Controls whether the input frames are denoised in the time domain. This parameter is used to minimize noise (such as small variations in the light or electrical noise coming from the camera) in the input images to increase feature point stability and precision.
|
Expand | ||
---|---|---|
| ||
Major changes in fitting related parameters:
For detailed description of these changes consult VisageTracker Configuration Manual, section 2.1. for additional information. |
API changes:
Expand | ||
---|---|---|
| ||
C++ API Introducing new functions for getting and setting
Introducing new functions for getting and setting
Introducing major changes in fitting related parameters API.
The following API methods have been removed:
Introducing new functions for getting and setting pose_fitting_model_configuration, au_fitting_model_configuration, mesh_fitting_model_configuration parameters respectively:
C# API is updated accordingly. |
Expand | ||
---|---|---|
| ||
C++ API
Additional information pertaining eyes and lips tracking are documented under paragraph Landmark detection changes. Please note: FDP files saved with visage|SDK 9.1 will not be backwards compatible with previous versions due to the addition of new FDP points. C# API is updated accordingly. |
Data files changes:
Expand | ||
---|---|---|
| ||
Modified
Projects using older versions of these files should be updated to contain the newest data files from the data folder. |
Sample changes:
Expand | ||
---|---|---|
| ||
Samples displaying feature points are updated to draw additional lip points. |
visage|SDK 9.1b3
Changes in configuration file
Expand | ||
---|---|---|
| ||
temporally_denoise_input configuration parameter added. Controls whether the input frames are denoised in the time domain. This parameter is used to minimize noise (such as small variations in the light or electrical noise coming from the camera) in the input images to increase feature point stability and precision.
For detailed description of these changes consult VisageTracker Configuration Manual, section 2.1. for additional information. |
API changes:
Expand | ||
---|---|---|
| ||
C++ API: Introducing new functions for getting and setting
C# API is updated accordingly. |
visage|SDK 9.1b2
Landmark detection changes
Expand | ||
---|---|---|
| ||
16 additional lips landmarks contained in the group 17 (17.5-17.20) are added as part of the extended lips landmarks improvements. For more details please see FDP documentation. |
Changes in configuration file
Expand | ||
---|---|---|
| ||
enable_smoothing configuration parameter added. Controls whether the tracker output is smoothed with the smoothing_factors parameter or not.
For detailed description of these changes consult VisageTracker Configuration Manual, section 2.1. for additional information. |
API changes:
Expand | ||
---|---|---|
| ||
C++ API: Introducing new functions for getting and setting
C# API is updated accordingly. |
Expand | ||
---|---|---|
| ||
C++ API: FDP group 17 (additional lips landmarks) has been added as part of extended lips landmark tracking feature. Additional information pertaining lip tracking are documented under paragraph Landmark detection changes. Please note: FDP files saved with visage|SDK 9.1 will not be backwards compatible with previous versions due to the addition of new FDP points. C# API is updated accordingly. |
Data files changes
Expand | ||
---|---|---|
| ||
Projects using older versions of these files should be updated to contain the newest data files from the data folder. |
Sample changes
Expand | ||
---|---|---|
| ||
Samples displaying feature points are updated to draw additional lip points. |
visage|SDK 9.0
General
Expand | ||
---|---|---|
| ||
VisageFaceAnalyser now offers multi-frame analysis functionality which performs estimations on the selected high-quality frames and returns an averaged, smoothed value. This functionality is available via the VisageFaceAnalyser::analyseStream() function. |
Expand | ||
---|---|---|
| ||
Introducing smaller and faster tracking algorithm models while retaining the same accuracy which completely replace the old models that will no longer be distributed. |
Expand | ||
---|---|---|
| ||
Introducing smaller, faster and more accurate age and gender estimation models which completely replace the old models that will no longer be distributed. |
API changes
Expand | ||
---|---|---|
| ||
C++ API: VisageSDK namespace Introducing new FaceData class member for getting the face bounding box:
VisageCSWrapper namespace Introducing new FaceData class member for getting the face bounding box:
|
Expand | ||
---|---|---|
| ||
C++ API: VisageFaceAnalyser API was refactored to optimise usage and to include newly introduced multi-frame analysis feature.
and replaced with new ones:
Three separate calls to old analysis estimation functions can now be performed by a single call to analyseImage() or analyseStream() where parameter options specifies which analysis operations to perform. Introducing new AnalysisData structure which contains face analysis results (age, gender and emotions) returned by the VisageFaceAnalyser::analyseImage() and VisageFaceAnalyser::analyseStream() functions.
Due to native VisageFaceAnalyser API changes, VisageCSWrapper's VisageFaceAnalyser API was updated accordingly. |
Expand | ||
---|---|---|
| ||
C++ API: Prototype of VisageFeaturesDetector constructor and the following method has been changed:
For more details please see VisageFeaturesDetector API documentation. C# API: Prototype of VisageFeaturesDetector constructor has been changed:
Following method has been removed:
For more details please see VisageFeaturesDetector API documentation. |
Expand | ||
---|---|---|
| ||
C++ API: Introducing new functions for getting and setting specific data paths required by tracking algorithm:
Removed functions for getting and setting the obsolete data path no longer required by tracking algorithm:
C# API: VisageConfiguration class contains new public attributes:
Removed public attribute:
|
Data folder changes:
Expand | |||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||
|
Data files changes:
Expand | ||
---|---|---|
| ||
Removed
Added
bdts_data_path
Modified
Projects using older versions of these files should be updated to contain the newest data files from the data folder. |
visage|SDK 8.8
General
Expand | ||
---|---|---|
| ||
The default legacy algorithm that could be allowed via the use_vnn configuration parameter (value 0) has been removed. The VNN algorithm is now the default and only tracking and detection algorithm. |
Expand | ||
---|---|---|
| ||
Face tracking and detection algorithms are enhanced so that they can track and detect faces wearing protective masks of various colors and patterns. |
Landmark detection changes:
Expand | ||
---|---|---|
| ||
Visible contour landmarks from group 13 (13.1-13.17) are no longer available (not detected or estimated). Instead, contour landmarks are now provided only in the form of a physical contour within group 15 (15.1-15.17). For more details please see FDP documentation. |
API changes
Expand | ||||||
---|---|---|---|---|---|---|
| ||||||
Introducing new C++ and C# API for getting SDK version:
|
Expand | ||
---|---|---|
| ||
Parameter *frame is now mandatory for the following method: VisageLivenessBlink::update(const FaceData *faceData, VsImage *frame) |
Expand | ||||
---|---|---|---|---|
| ||||
Introducing new FaceData class member for getting the rotation of the face from the camera viewpoint:
|
Changes in configuration file
Expand | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||
|
Expand | ||
---|---|---|
| ||
Facial Features Tracker - High.cfg to Facial Features Tracker.cfg |
Expand | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
refine_landmarks parameter
|
Expand | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
|
Data files changes
Expand | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
As a consequence of improving algorithms, removing legacy algorithm, there are certain changes in the data files.
|
Sample changes
Expand | ||
---|---|---|
| ||
Samples displaying feature points are updated to draw physical contour points. |
visage|SDK 8.7
General
Expand | ||||
---|---|---|---|---|
| ||||
The in-house developed runner is no longer available and is being replaced by OpenVINO™ toolkit, which is now the only and default neural network runner.
It is implemented in the following libraries:
OpenVINO is a trademark of Intel Corporation or its subsidiaries. |
Expand | ||
---|---|---|
| ||
The old face recognition model is being replaced by a smaller, faster and more accurate face recognition model. |
Expand | ||
---|---|---|
| ||
Introducing a more accurate and robust face detection model. The new model is used in face tracking and face detection when use_vnn configuration parameter is set to 1. Otherwise, the previous face detection model will be used.
|
Expand | ||
---|---|---|
| ||
VNN algorithm can now be configured for better performance, at the cost of feature points precision. This mode is enabled by setting use_vnn parameter in configuration file to 1.
|
API changes
Expand | ||||
---|---|---|---|---|
| ||||
Added support for multiple image format for
|
Changes in configuration file
Expand | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||
use_vnn configuration parameter added to
use_vnn configuration parameter values changed and additional value added:
|
Data files changes
Expand | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
As a consequence of improving algorithms, removing in-house developed runner, and improving VNN algorithm, there are certain changes in the data files.
|
Sample changes
Expand | ||
---|---|---|
| ||
VisageTrackerUnityPlugin Function VisageTrackerUnityDemo The previously used BGRATex texture shader for applying captured frame image data was replaced with RGBATex texture shader (Tracker.cs script). |
visage|SDK 8.6.1
General
Expand | ||
---|---|---|
| ||
To improve the performance of our algorithms and to support a wider variety of neural network models, we are introducing a configurable framework for choosing between different neural network runners. As a result, additional configuration file NeuralNet.cfg is now included in visage|SDK (located in Samples/data). This file allows the users to configure which runner will be used by visage|SDK. Users can choose between:
For more information on the parameters of NeuralNet.cfg file see the API page. OpenVINO is a trademark of Intel Corporation or its subsidiaries. |
Expand | ||||
---|---|---|---|---|
| ||||
New experimental algorithm for face tracking and alignment introduced - VNN algorithm. For the price of slightly reduced tracking speed/performance, it significantly improves tracking quality and robustness.
|
API changes
Expand | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||
Introducing new C++ and C# API for programmatically changing
The aforementioned classes are used in conjunction with new
|
Expand | ||
---|---|---|
| ||
FDP group 10 (ears) has been extended from 10 to 24 points (12 points per ear) as part of the ear tracking feature.
|
Expand | ||||
---|---|---|---|---|
| ||||
|
Expand | ||
---|---|---|
| ||
Prototype of method
changed to
|
Expand | ||||||
---|---|---|---|---|---|---|
| ||||||
|
Changes in configuration file
Expand | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||
Two additional configuration files have been added. One for the ear tracking feature and one for the novel tracking algorithm.
|
Expand | ||||||
---|---|---|---|---|---|---|
| ||||||
|
3D Model changes
Expand | ||
---|---|---|
| ||
A new model file has been added for ear tracking functionality - jk_300_wEars.wfm. The model contains an additional 334 polygons and its vertices are mapped to 14 new FDP points in group 10 (10.11 - 10.24).
|
Data files changes
Expand | ||||||
---|---|---|---|---|---|---|
| ||||||
New data files and model files for ear tracking added
|
Expand | ||
---|---|---|
| ||
New data folder and data files added for VNN algorithm in Samples/data/bdtsdata/NN/vnn
|
Sample changes
Expand | ||
---|---|---|
| ||
FacialAnimationUnityDemo sample application has been removed and will no longer be distributed. |
Expand | ||
---|---|---|
| ||
VisageTrackerUnityDemo sample applicationisdistributed as a Unity project, not as a prebuilt application. Build and run instructions are provided in the VisageTrackerUnityDemo sample documentation.
|
visage|SDK 8.5
Changes in configuration file
Expand | ||||
---|---|---|---|---|
| ||||
|
Sample changes
Expand | ||||
---|---|---|---|---|
| ||||
VisageRendering.cs: Methods
to:
|
Build tools changes
Libraries built with msvc100 are no longer supported within the package.
Data files changes
visage|SDK data files located in Samples/data/bdtsdata folder have been updated.
Copy all files located in the Samples/data/bdtsdata folder to appropriate folders in any existing application.