You are viewing an old version of this page. View the current version.
Compare with Current
View Page History
« Previous
Version 5
Next »
note
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 existing applications built with older versions.
For each visage|SDK release, 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.
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 existing applications built with older versions.
For each visage|SDK release, 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.
visage|SDK 8.7
visage|SDK 8.6.1
General
Configurable neural network runners
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.
Configurable tracking algorithm
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. VisageTracker
and VisageFeaturesDetector
can be configured to use VNN algorithm via configuration parameter - use_vnn.
For more information on use_vnn parameter, please consult VisageTracker Configuration Manual and VisageTracker
class documentation.
API changes
VisageConfiguration API
Introducing new C++ and C# API for programmatically changing VisageTracker
configuration parameters, including new additional classes and templates:
VisageConfiguration
| Modify configuration parameters on the fly |
VsCfgArr
| Helper template structure for storing various VisageConfiguration array data types |
The aforementioned classes are used in conjunction of new VisageTracker
methods:
C++ | VisageConfiguration VisageTracker::getTrackerConfiguration()
|
void VisageTracker::setTrackerConfiguration(VisageConfiguration &configuration)
|
C# | VisageConfiguration VisageCSWrapper.VisageTracker.GetTrackerConfiguration()
|
void VisageCSWrapper.VisageTracker.SetTrackerConfiguration(VisageConfiguration configuration)
|
FDP class
FDP group 10 (ears) has been extended from 10 to 24 points (12 points per ear) as part of ear tracking feature.
Deprecation notice
VisageTracker
method stop has been deprecated from both APIs.
C++ | VisageTracker::stop()
|
C# | VisageCSWrapper.VisageTracker.Stop()
|
Licensing
Prototype of method
void initializeLicenseManager(const char *licenseKeyFileName)
changed to
int initializeLicenseManager(const char *licenseKeyFileName)
C# API
FeaturePoint
class and FDP
class have additional property and functions, respectively to conform with the C++ API.
FeaturePoint
| FeaturePoint.detected
|
FDP
| bool FDP::FPIsDetected(int group, int n)
bool FDP::FPIsDetected(String name)
|
Model changes
Ear tracking 3D model
A new model file has been added for ear tracking functionality - jk_300_wEars.wfm. The model contains an additional 334 polygons and it’s vertices are mapped to 14 new FDP points in group 10 (10.11 - 10.24).
Changes in configuration file
New configuration files
Two additional configuration files have been added. One for the ear tracking feature and one for the novel tracking algorithm.
Configuration name | Parameter changed/added | Parameter value |
---|
Facial Features Tracker - High - With Ears.cfg | efine_ears *_fitting_model *_fitting_fdp | 1 jk_300_wEars.wfm jk_300_wEars.fdp |
Facial Features Tracker - Ultra.cfg | use_vnn | 1 |
New configuration parameter - refine_ears and use_vnn
Data files changes
Ear tracking models and data
New data files and model files for ear tracking added
Location | Files |
---|
Samples/data/bdtsdata/NN | efa.lbf efc.lbf |
Samples/data/ | jk_300_wEars.wfm jk_300_wEars.fdp |
VNN algorithm data files
New data folder and data files added for VNN algorithm in Samples/data/bdtsdata/NN/vnn
Sample changes
FacialAnimationUnityDemo deprecation notice
FacialAnimationUnityDemo sample application has been removed and will no longer be distributed.
Unity projects distribution changes
VisageTrackerUnityDemo sample application is distributed as a Unity projects, not as a prebuilt application.
Build and run instruction are provided in the VisageTrackerUnityDemo sample documentation
visage|SDK 8.5
Changes in configuration file
Smoothing factors values and range
Sample changes
ShowcaseDemo C# drawing
VisageRendering.cs:
Methods DisplayEmotion()
and DisplayAgeGenderName()
have changed the prototypes from:
public void DisplayEmotion(FaceData trackingData, float[] emotions, int width, int height,
bool face_recognition_mode=false)
public void DisplayAgeGenderName(FaceData trackingData, float age, int gender, string name,
int width, int height, int drawingOptions,
bool face_recognition_mode=false)
to:
public void DisplayEmotion(FaceData trackingData, float[] emotions, int width, int height,
bool display_background = false)
public void DisplayAgeGenderName(FaceData trackingData, float age, int gender, string name,
int width, int height, bool display_background = true)
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.