Migration from older 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.

Changes in this release

This section covers all changes introduced in all releases since 9.0.

Landmark detection changes:

Additional eyebrows landmarks Additional eyes landmarks Additional lips landmarks For more details please see FDP documentation.

Changes in configuration file:

For detailed description of these changes consult VisageTracker Configuration Manual, section 2.1. for additional information.

API changes:

C++ API

VisageConfiguration API

Introducing new functions for getting and setting enable_smoothing parameter: Introducing new functions for getting and setting temporally_denoise_input parameter: Introducing major changes in fitting related parameters API.
The following API methods have been replaced: 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:

FDP class:

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.
Using FDP::readFromFile() to load an 9.1 FDP file in an earlier version of the SDK will lead to undefined behaviour.


C# API is updated accordingly.

Data files changes:

Modified

Projects using older versions of these files should be updated to contain the newest data files from the data folder.

Sample changes:

Samples displaying feature points are updated to draw additional lip points.



Changes in older releases


visage|SDK 9.0

General:

Multi-frame analysis feature

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.

New tracking algorithm models

Introducing smaller and faster tracking algorithm models while retaining the same accuracy which completely replace the old models that will no longer be distributed.

New age and gender estimation models

Introducing smaller, faster and more accurate age and gender estimation models which completely replace the old models that will no longer be distributed.

Library changes:

visage|SDK can now be included from paths that contain non-ASCII characters.

API changes:

C++ API:

VisageSDK namespace

Introducing new FaceData class member for getting the face bounding box:

VisageFaceAnalyser API

VisageFaceAnalyser API was refactored to optimise usage and to include newly introduced multi-frame analysis feature.

Old face analysis functions were removed: 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.

For more details on the updated API please see VisageFaceAnalyser API documentation.

Introducing new AnalysisData structure which contains face analysis results (age, gender and emotions) returned by the VisageFaceAnalyser::analyseImage() and VisageFaceAnalyser::analyseStream() functions.

VisageFeaturesDetector API

Prototype of VisageFeaturesDetector constructor and the following method has been changed: For more details please see VisageFeaturesDetector API documentation.

VisageConfiguration 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:

VisageGazeTracker API

Prototype of following method has been changed:

C# API:

VisageCSWrapper namespace

Introducing new FaceData class member for getting the face bounding box:

VisageFaceAnalyser API

Due to native VisageFaceAnalyser API changes, VisageCSWrapper's VisageFaceAnalyser API was updated accordingly.
New AnalysisData structure which contains face analysis results (age, gender and emotions) was added as well.

VisageFeaturesDetector API

Prototype of VisageFeaturesDetector constructor has been changed: Following method has been removed: For more details please see VisageFeaturesDetector API documentation.

VisageConfiguration API

VisageConfiguration class contains new public attributes: Removed public attribute:

Data folder changes:

Data folder structure has been rearranged:

Data files Old location New location
Face analysis data files bdtsdata/LBF/vfadata vfa
Face recognition data files bdtsdata/NN/fr.* vfr
Tracking algorithm data files bdtsdata/FF/vnn vft/ff
bdtsdata/NN/vnn vft/fa
Tracking features data files bdtsdata/NN/pr.* vft/pr
bdtsdata/NN/*.lbf vft/er
3D models data files root vft/fm

Data files changes:

Removed

Added

Modified

Projects using older versions of these files should be updated to contain the newest data files from the data folder.

Sample changes:

Due to native FaceData API and VisageFaceAnalyser API changes, VisageTrackerUnityPlugin API and VisageAnalyserUnityPlugin API were updated accordingly.

ShowcaseDemo and VisageTrackerUnityDemo:

Newly introduced face analysis functions, analyseStream() and resetStreamAnalysis(), are used to perform face analysis, thus replacing previously used estimation functions and in-app filtering.

visage|SDK 8.8

General:

Face tracking and detection algorithms

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.

The algorithm can be configured to improve feature points precision and robustness, over tracking speed (performance) by setting the refine_landmarks parameter to 1 in the configuration file. Otherwise, when performance is preferred over feature points precision, the recommendation is to disable refine_landmarks parameter by setting it to 0 in the configuration file.

Face tracking and detection with protection masks

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:

Contour landmarks Changing the detection of contour points from visible to physical results in improved stability and accuracy of the 3D head-pose estimation.

API changes:

C++ API:

VisageSDK namespace

Introducing new function for getting SDK version: Prototype is declared in the following headers; VisageTracker.h, VisageFeaturesDetector.h, VisageFaceRecognition.h, VisageFaceAnalyser.h and VisageGazeTracker.h.

Introducing new FaceData class member for getting the rotation of the face from the camera viewpoint:

Liveness API

Parameter *frame is now mandatory for the following method:

C# API:

VisageCSWrapper namespace

Introducing VisageSDKVersion class for getting SDK version with method: Introducing new FaceData class member for getting the rotation of the face from the camera viewpoint:

Changes in configuration file:

Removed

Added

Renamed

Modified

Please refer to the VisageTracker Configuration Manual, section 2.1. for additional information.

If you want to update your existing configuration files, it is recommended to copy the parameters values from Facial Features Tracker.cfg configuration file supplied in this package.

Data files changes:

Removed

Modified

Projects using older versions of these files should be updated to contain the newest data files from the bdtsdata folder along with libraries from bin64 folder.


Dependencies changes:

OpenVINO™ toolikit is updated and therefore new dependencies of libVisageVision64.dll should now be included in projects along with other visage|SDK libaries.

Additionally OpenVINO™ toolkit requires the plugins.xml file provided in Samples/data.

Sample changes:

Samples solution migrated to Visual Studio 2019.

Samples displaying feature points are updated to draw physical contour points.

VisageTrackerUnityPlugin:

Introducing new function for getting the rotation of the face from the camera viewpoint:

ShowcaseDemo and VisageTrackerUnityDemo:

Newly introduced FaceData class member, faceRotationApparent, is used to check if face rotation is within constraints to successfully run face recognition and face analysis.


visage|SDK 8.7

General:

Neural network runner replacement

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. OpenVINO™ toolkit significantly improves the performance of visage|SDK algorithms.

It is implemented in the following libraries:

These libraries are dependencies of libVisageVision64.a and should now be included in projects along with other visage|SDK libraries. Additionally, OpenVINO™ toolkit requires its own set of data files with extensions .vino.bin and .vino.xml provided in Samples/data/bdtsdata.


New face recognition model

Introducing smaller, faster and more accurate face recognition model which completely replaces the old model that will no longer be distributed.


New face detection model

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.
For more information about using VNN detection algorithm, please consult VisageTracker Configuration Manual and VisageFeaturesDetector documentation.


VNN tracking algorithm fast mode

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. This mode is typically used when performance is preferred over feature points precision, e.g. when interested in fast head pose (head rotation and translation) estimation.


*OpenVINO is a trademark of Intel Corporation or its subsidiaries.

API changes:

VisageFaceRecognition:

Changes in configuration file:

For detailed description of these changes consult VisageTracker Configuration Manual.

If you want to update your existing configuration files, it is recommended to copy the parameters values from Facial Features Tracker - High.cfg configuration file supplied in this package.

Data files changes:

Removed

Added

Modified

Projects using older versions of these files should be updated to contain the newest data files from the bdtsdata folder.


Sample changes:

VisageTrackerUnityPlugin:

VisageTrackerUnityDemo:


visage|SDK 8.6

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 an API and 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.


Configurable detection algorithm

New experimental algorithm for face and facial features detection introduced (VNN algorithm). While it significantly improves detection quality, it also reduces detection speed (performance).
Detector is currently configurable so VNN algorithm can be enabled or disabled via parameter use_vnn in configuration file.

It is recommended to use VNN algorithm only with OpenVINO™ toolkit which significantly improves speed of running neural networks.

For more information about using VNN detection algorithm, please consult VisageFeaturesDetector documentation.


Configurable tracking algorithm

New experimental algorithm for face tracking introduced (VNN algorithm). While it significantly improves tracking quality and robustness, it also reduces tracking speed (performance).
Tracker is currently configurable so VNN algorithm can be enabled or disabled via parameter use_vnn in configuration file.

It is recommended to use VNN algorithm with OpenVINO™ toolkit which significantly improves speed of running neural networks.

For more information about using VNN tracking algorithm, please consult VisageTracker Configuration Manual and VisageTracker documentation.


API changes:

VisageConfiguration API

Introducing new API for programatically changing VisageTracker configuration parameters, including classes and templates:

used in conjunction with new VisageTracker methods: For more details and usage code examples please refer to Detailed Description section of VisageConfiguration and VsCfgArr.


FDP class:


Deprecated API:


Licensing:


C# API:

Please refer to the C# API documentation for more information.

Model changes:

A new model file has been added for ear tracking functionality - jk_300_wEars. The new model is based on the previous 'jk_300' model and contains an additional 334 polygons and 14 new FDP points in group 10 (10.11 - 10.24).

For detailed description of these changes consult VisageTracker Configuration Manual.

Changes in configuration file:

For detailed description of these changes consult VisageTracker Configuration Manual.

If you want to update your existing configuration files, it is recommended to copy the parameters values from Facial Features Tracker - High.cfg configuration file supplied in this package.

Data files changes:

Projects using older versions of these files should be updated to contain the newest data files from the bdtsdata folder.

Sample changes:

VisageTrackerUnityDemo and FacialAnimationUnityDemo:

VisageTrackerUnityDemo and FacialAnimationUnityDemo are now distributed only as Unity projects. Instructions on how to build and run the provided applications can be found here for VisageTrackerUnityDemo and here for FacialAnimationUnityDemo. Additionally, instructions for visage|SDK Unity integration can be found here.

visage|SDK 8.5

Changes in configuration file:

Please refer to the VisageTracker Configuration Manual, section 2.1. for additional information.

If you want to update your existing configuration files, it is recommended to copy the parameters values from Facial Features Tracker - High.cfg configuration file supplied in this package.

API changes:

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)

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 bdtsdata folder to appropriate folders in any existing applications.


visage|SDK 8.4

API changes:

VisageFaceAnalyser:

Method estimateAge() now accepts only RGB input image; estimateEmotion() and estimateGender() expect RGB, RGBA or grayscale input image.

Licensing changes:

visage|SDK can no longer be used without license - FaceTrack, FaceAnalysis and FaceRecognition will not return results without valid license. More information on how to obtain license key and include it in the application can be found in Licensing section of the documentation.
In order to try visage|SDK on Windows, prebuilt ShowcaseDemo application is provided in bin folder

Data files changes:

visage|SDK data files located in Samples/data/bdtsdata folder have been updated.
Copy all files located in the bdtsdata folder to appropriate folders in any existing applications.

Sample changes:

FaceDetector and SimpleTracker samples have been removed from visage|SDK HTML5 package.

VisageTrackerUnityPlugin:

VisageTrackerUnityPlugin was updated so it includes all FaceTrack (including multiple face tracking), FaceAnalysis and FaceRecognition functions. Due to major changes, it is recommended to go through documentation before including VisageTrackerUnityPlugin to your existing project.

Including license key in samples:

Instructions for including license key file have changed. For more information, please visit Licensing section of the documentation.



visage|SDK 8.3.5959

Landmark detection changes:

For detailed illustration see MPEG-4 FBA.

API changes:

VisageFeaturesDetector:
VisageFaceRecognition:

Changes in configuration file:

Configuration file format had stayed the same.

jk_300 model has been set as a default model for pose and action unit estimation instead of candide3 model.

If you want to update your existing configuration files, it is recommended to copy the parameters values from Facial Features Tracker - High.cfg configuration file supplied in this package.

Data files changes:

visage|SDK data files located in Samples/data/bdtsdata folder have been updated.
Copy all files located in the bdtsdata folder to appropriate folders in any existing applications.


visage|SDK 8.2.5684

API changes:

VisageTracker:
Due to the introduction of multitracking prototype of following methods has been changed:
VisageFaceRecognition:
VisageFeaturesDetector:
Following methods has been changed:

Changes in configuration file format:


For detailed description of these changes consult VisageTracker Configuration Manual.

If you want to update your existing configuration files, it is recommended to copy the values for these new parameters from the Facial Features Tracker - High.cfg configuration file supplied in this package. In all other cases, simply use the provided configuration files.

Data files changes:

visage|SDK data files located in Samples/data/bdtsdata folder have been updated.
Copy all files located in the bdtsdata folder to appropriate folders in any existing applications.


visage|SDK 8.1.4407

API changes:

Prototype of following methods has been changed: Following class members have been removed: Following class methods have been removed: Following interfaces have been removed: VisageFaceAnalysers' emotions model augmented with neutral emotion. The function:
int VisageSDK::VisageFaceAnalyser::estimateEmotion(VsImage * frame, FaceData * facedata, float *prob_estimates)
now returns 7 values in following order: anger, disgust, fear, happiness, sadness, surprise and neutral

Changes in configuration file format:

Data files changes:

visage|SDK data files located in Samples/data/bdtsdata folder have been updated.
Copy all files located in the bdtsdata folder to appropriate folders in any existing applications.

New model has been added - jk_300, in two additional files: jk_300.wfm and jk_300.fdp. For detailed information on how the new model is used inside the visage|SDK consult VisageTracker Configuration Manual section 2.3.


visage|SDK 8.0.3444

API changes:

1. VisageTracker2 class has been renamed to VisageTracker.

2. The following methods have been removed:

3. VisageTrackerFrameGrabber class has been removed.

4. DetectStrip API has been removed.

5. visage|SDK libraries have been split in three libraries, based on the functionality:

6. Compiled visage|SDK libraries can be used exclusively with Visual Studio 2015.

7. Prototype of method:

void initializeLicenseManager(char *licenseKeyFileName)
changed to
void initializeLicenseManager(const char *licenseKeyFileName)

Changes in configuration files:

If you want to update your existing configuration files, it is recommended to copy the values for these new parameters from the Facial Features Tracker - High.cfg configuration file supplied in this package. In all other cases, simply use the provided configuration files.

Data files changes:

visage|SDK data files located in Samples/data/bdtsdata folder have been updated.
Copy all files located in the bdtsdata folder to appropriate folders in any existing applications.

Sample changes:

Samples solution migrated to Visual Studio 2015.

Drawing of feature points in FaceDetector has been moved from visage|SDK library to a separate source file VisageDrawing.cpp

Licensing changes:

Unlicensed VisageFeaturesDetector will return complete results but has a delay of 2 seconds for each call of detectFacialFeatures method.

Unlicensed VisageFaceAnalyser has a delay of 2 seconds for each call of estimate function.



visage|SDK 7.4.2500

API changes:

1. Rendering has been moved from the visage|SDK library to samples, thus following optional interfaces for VisageTracker2 have been removed:

class TrackerGUIInterface
class TrackerOpenGLInterface

2. VisageTracker2 constructor has been removed

VisageTracker2(TrackerOpenGLInterface *oglInterface, TrackerGUIInterface *guiInterface, const char *trackerConfigFile)
use
VisageTracker2(const char* trackerConfigFile);

3. Method for tracking from a digital camera is changed to accept additional optional parameters for picking camera device and setting camera width and height:

bool trackFromCam(const char* outFbaFileName = NULL, int orientation = VISAGE_CAMERA_UP, int frameGrabberImageFormat = VISAGE_FRAMEGRABBER_FMT_RGB, bool startThread = true, int pickCamDevice = -1, int camWidth = -1, int camHeight = -1);

Changes in configuration files:

Configuration file Facial Features Tracker - Asymmetric.cfg has been removed. Two new configurations have been added to the Samples/data folder:

Changes in configuration file format:

If you want to update your existing configuration files, it is recommended to copy the values for these new parameters from the Facial Features Tracker - High.cfg configuration file supplied in this package. In all other cases, simply use the provided configuration files.

Data files changes:

Data files location has been changed from Samples\OpenGL\FaceTracker2\data folder to Samples\data folder. Copy all files located in the bdtsdata folder to appropriate folders in any existing applications.

Symmetrical Candide3 face model (old candide3.wfm) has been removed and replaced with asymmetric Candide3 face model, formerly candide3-exp.wfm now candide3.wfm.

Samples changes:

Frame and tracking results rendering code has been moved from the visage|SDK library to a separate source file VisageRendering.cpp. The source code is part of visage|SDK sample projects.

visage|SDK 7.3.1860

API changes:

1. Old method for tracking from raw images and the respective interface class are deprecated:

bool trackFromRawImages(VisageTrackerFrameGrabber *frameGrabber, 
                        int width, 
                        int height, 
                        int format, 
                        int origin, 
                        const char *outFbaFileName=NULL);
and
class VisageTrackerFrameGrabber
New method is introduced:
virtual int track(int frameWidth, 
                  int frameHeight,
                  const char *p_imageData,
                  FaceData *facedata, 
                  int format=VISAGE_FRAMEGRABBER_FMT_RGB, 
                  int origin=VISAGE_FRAMEGRABBER_ORIGIN_TL, 
                  int widthStep=0);

2. Screen space gaze API has been separated from the VisageTracker2 class. Specialized VisageGazeTracker class added. There have been no changes in screen space gaze API methods.

3. Additional functionality has been added to the API:

Changes in configuration file format:

For detailed description of these changes consult VisageTracker Configuration Manual. If you want to update your existing configuration files, it is recommended to copy the values for these new parameters from the Facial Features Tracker - Asymmetric.cfg configuration file supplied in this package. In all other cases, simply use the provided configuration files.

Many parameters are now obsolete and not used in the tracker (e.g. template matching parameters). Tracker will work with configurations containing the old parameters but it is recommended to use the provided configuration files.

Data files changes:

Data files are located in the folder Visage Technologies\visageSDK\Samples\OpenGL\data\FaceTracker2\bdtsdata. Copy all files located in bdtsdata folder to appropriate folders in any existing applications.

Changes in sample projects:

visage|SDK 7.2.1286

API changes:

Screen space gaze tracking API introduced.

1. Screen space gaze tracking API methods added to the VisageTracker2 class:

void VisageTracker2::InitOnlineGazeCalibration();
void AddGazeCalibrationPoint(float x, float y);
float FinalizeOnlineGazeCalibration();
void InitOfflineGazeCalibration(ScreenSpaceGazeRepository *calibrator);
float getGazeEstimations(ScreenSpaceGazeRepository *repository);

2. Screen space gaze data container ScreenSpaceGazeData is introduced.


3. Screen space gaze data repository ScreenSpaceGazeRepository is introduced.


4. Added gazeData member to FaceData container class.


5. VisageFeaturesDetector functionally is extended to be able to specify minimal detected face size in an image. Therefore interface of detectFacialFeatures functions is changed from:

VisageFeaturesDetector::detectFacialFeatures(const char* imageFileName, FaceData* output, int maxFaces = 1);
VisageFeaturesDetector::detectFacialFeatures(IplImage *frame, FaceData* output, int maxFaces = 1)

to:

VisageFeaturesDetector::detectFacialFeatures(const char* imageFileName, FaceData* output, int maxFaces = 1, int minFaceSize = 0);
VisageFeaturesDetector::detectFacialFeatures(IplImage* frame, FaceData* output, int maxFaces = 1, int minFaceSize = 0);

Changes in configuration file format:

If you want to update your existing configuration files, it is recommended to copy the values for these new parameters from the Facial Features Tracker - Asymmetric.cfg configuration file supplied in this package. In all other cases, simply use the provided configuration files.

Sample changes:

New sample added: Gaze Tracker, demonstrates online mode of screen space gaze estimation (from the camera). Facial Animation Unity sample improved: a new model has been added and binding has been improved

Other:

Enabled fitting while mouth is moderately open during initialization.

Tracking bug on high in-plane rotations (z axis) fixed.

Action Units for eye closure now return continuous results.

Changes in licensing:

Samples without a valid license now have 1 minute try-out period before they stop working instead of stopping immediately.

visage|SDK 7.1.780

API changes:

1. Method to initialize VisageFeaturesDetector object is changed from:

bool VisageFeaturesDetector::LoadStaticModel(const char* aamSFileName, bool show = false);

to:

bool VisageFeaturesDetector::Initialize(const char* datapath);

2. FaceData container class for tracking and detection results is introduced. TrackingData class is deprecated.


3. VisageFeaturesDetector functionally is extended to return results for multiple faces in form of FaceData objects. Therefore interface of detectFacialFeatures functions is changed from:

VisageFeaturesDetector::detectFacialFeatures(const char *imageFileName, FDP* output, bool show);
VisageFeaturesDetector::detectFacialFeatures(IplImage *frame, FDP* output, bool show);

to:

VisageFeaturesDetector::detectFacialFeatures(const char *imageFileName, FaceData* output, int maxFaces);
VisageFeaturesDetector::detectFacialFeatures(IplImage *frame, FaceData* output, int maxFaces);

4. Method VisageFeaturesDetector::DrawFDPs() is deprecated. New method for drawing detection results is introduced:

 VisageFeaturesDetector::drawResults(IplImage *img);

5. VisageTracker2::getTrackingData() method is changed to accept FaceData parameter instead of TrackingData parameter. Interface is changed from:

 VisageTracker2::getTrackingData(TrackingData *data); 

to:

 VisageTracker2::getTrackingData(FaceData *data);

6. The reference point on the head was changed to the center between eyes.

This change affects the results returned in the following members of TrackingData structure:

Changes in configuration file format:

If you want to update your existing configuration files, it is recommended to copy the values for these new parameters from the configuration files supplied in this package. In all other cases, simply use the provided configuration files.

Data files changes:

Data files are located in the folder Visage Technologies\visageSDK\Samples\OpenGL\data\FaceTracker2. The following files have been changed/added and must be copied to appropriate folders in any existing applications:

visage|SDK 7.0.348

Changes are introduced to the licensing system. If you have license(s) for previous versions of visage|SDK, you should receive new license keys from your Visage Technologies representative. Please consult the Licensing section of the documentation for details on using the license keys.

API changes:

No API changes in this release.

Changes in configuration file format:

No changes in configuration file format in this release.

Data files changes:

Data files are located in the folder Visage Technologies\visageSDK\Samples\OpenGL\data\FaceTracker2. The following files have been changed and must be copied to appropriate folders in any existing applications:

visage|SDK 7.0.277

Changes are introduced to the licensing system. If you have license(s) for previous versions of visage|SDK, you should receive new license keys from your Visage Technologies representative. Please consult the Licensing section of the documentation for details on using the license keys.

API changes:

No API changes in this release.

Changes in configuration file format:

If you want to update your existing configuration files, it is recommended to copy the values for these new parameters from the configuration files supplied in this package. In all other cases, simply use the provided configuration files.

Data files changes:

Data files are located in the folder Visage Technologies\visageSDK\Samples\OpenGL\data\FaceTracker2. The following files have been added or changed and must be copied to appropriate folders in any existing applications:

Furthermore, because of the changes in Candide model, any previously created profiles (*.su) for tracking in semi-automatic setup mode will not work properly anymore and new ones must be created.

visage|SDK 6.5.1070

API changes:

The following functions have been changed:

from: virtual void VisageTracker2::trackFromCam(const char* outFbaFileName = NULL, int frameGrabberImageFormat = VISAGE_FRAMEGRABBER_FMT_RGB)
to: virtual void VisageTracker2::trackFromCam(const char* outFbaFileName = NULL, int orientation = VISAGE_CAMERA_UP, int frameGrabberImageFormat = VISAGE_FRAMEGRABBER_FMT_RGB)

The orientation parameter controls input camera orientation, see documention for more details.

visage|SDK 6.5.986

API changes:

1. Action units names added to TrackingData

New member actionUnitsNames has been added to the TrackingData structure.

Required code changes: No changes required.

2. Animation by action units

The FaceTracker2 sample now allows animation of default face model directly with action units by mapping action units names with available morph targets in loaded model.

Required code changes: No changes required.

3. FaceGen integration improved

In addition to FAPs, new Visage neutral FaceGen model contains morph targets that map directly to action units used in VisageTracker which allows better animation.

Required code changes: No changes required.

Configuration files changes:

1. Action units names

New parameter allows matching action units names to animation parameters available in model.

Required configuration changes: Old configuration will work, but it is recommended to add au_names parameter if such animations are desired in application.

visage|SDK 6.5.881

API changes:

1. Gaze information added to TrackingData

New members gazeDirection and gazeDirectionGlobal have been added to the TrackingData structure.

Required code changes: No changes required.

Configuration files changes:

1. Smoothing parameters changed

New parameters allow finer control over the smoothing of tracking results. For more details see VisageTracker Configuration Manual.

Required configuration changes: Replace the old smoothing parameters with new ones.

Old parameters:
smoothing_translation		2
smoothing_rotation		2
smoothing_fp			0

New parameters:
smoothing_factor
     20            3.5        -1             20      20      50        20          20
#translation   rotation   action_units   eyebrows   mouth   gaze   eye_closure   other

visage|SDK 6.5.709

The API did not change in this release so migration involves simply re-building the projects developed using visage|SDK 6.4.

Important: a new parameter was added to tracker configuration file:
bdts_data_path - Relative or absolute path to the folder containing the detector data files (*.df). In the current distribution these files are con- tained in the folder Samples/data/bdtsdata.

visage|SDK 6.4

The VisageTracker2::trackFromAvi() function has been deprecated and replaced by VisageTracker2::trackFromVideo() function. Functionality remains the same.

The TrackingData structure has been introduced and consequently the following functions from VisageTracker2 class are deprecated:

Those functions have been replaced by a VisageTracker2::getTrackingData() that returns all the tracking data, previously returned by the above functions, in one structure.

The following interface functions have been changed:

from: virtual void VisageTrackerObserver::Notify(void *vt, FBAPs* fbaps, FDP* fdps, CodingParameters *cp, long pts, const IplImage *frame)
to: virtual void VisageTrackerObserver::Notify(VisageTracker2 *vt, long timeStamp)

The pts parameter is equal to the timeStamp parameter.
The fbaps, fdps and frame parameters can be obtained in TrackingData structure with VisageTracker2::getTrackingData() function.

from: virtual unsigned char *VisageTrackerFrameGrabber::GrabFrame()
to: virtual unsigned char *VisageTrackerFrameGrabber::GrabFrame(long &timeStamp)

The timestamp parameter now provides mechanism for associating tracking data with specific frame.

For compatibility reasons the AFM objects can no longer be instantiated with the new operator. Instead, use the static AFM::CreateAFM() functions to create new AFM objects.

new AFM() -> AFM::CreateAFM()
new AFM(char* fname) -> AFM::CreateAFM(char* fname)
new AFM(VRMLModel *m0, VRMLModel **m, int *fv,float _coordSensitivity) -> AFM::CreateAFM(VRMLModel *m0, VRMLModel **m, int *fv,float _coordSensitivity)

The AFM objects can no longer be deleted with the delete operator. Instead, use the static AFM::ReleaseAFM(AFM** afm) function to delete AFM objects.

delete afm -> AFM::ReleaseAFM(&afm)


Example:

AFM *afm = AFM::CreateAFM();

...

AFM::ReleaseAFM(&afm);