JSDoc: Class: VisageConfiguration

new VisageConfiguration(configurationName)

VisageConfiguration is a class used to change, apply, load and save configuration parameters used by VisageTracker.

The idea behind this interface is for a user to:

obtain a copy of the VisageConfiguration object from VisageTracker,
apply the desired changes on the VisageConfiguration object and,
send the modified object back to the VisageTracker

As a direct result of this implementation, the VisageConfiguration default constructor is private and it is expected and encouraged that the initial copy is obtained from the VisageTracker. Alternatively, VisageConfiguration can also be constructed by passing a path to the valid .cfg file using


m_Configuration = new VisageModule.VisageConfiguration(trackerConfigFile)

Obtaining a copy of the VC object

A copy of the VisageTracker internal member can be obtained by calling VisageTracker.getConfiguration() method as demonstrated in the code example below:


var m_Tracker = new VisageModule.VisageTracker(defaultConfigFile);
// Obtain a copy of internal VisageConfiguration member
var m_Configuration = m_Tracker.getConfiguration();

Applying changes on the VC object

The interface of the VisageConfiguration class is designed so the parameters cannot be accessed directly, instead, each parameter has its own getter and setter function. After a local copy is obtained, a setter function can be called. Setter functions perform input validation to verify that the value passed to the function is: a) within a certain range, b) not empty, or c) otherwise valid. Thus, the return parameter of the setter function is a boolean and if the value passed as an argument is invalid, the setter function will return false. Otherwise, if the value of the parameter was successfully changed, the function will return true.
A detailed description of each particular configuration parameter, including valid ranges and other specifics, are available in the VisageTracker Configuration Manual.

Parameters of the VisageConfiguration class can be divided into two categories:

primitive type parameters (Number, String)
objects of different types (VectorString, Array)

Following code example demonstrates a modification of primitive type parameters by modifying the camera_focus configuration parameter:


// Obtain a copy of internal VisageConfiguration member
m_Configuration = m_Tracker.getConfiguration();
bool success = m_Configuration.setCameraFocus(5.0);
if (success)
    //The parameter was changed successfully
else
    //The operation failed

Following two code examples demonstrate a modification of array type parameters.
Modification of the smoothing_factors parameter:


// Obtain a copy of internal VisageConfiguration member
m_Configuration = m_Tracker.getConfiguration();
//Get smoothing_factors array from VisageConfiguration.getSmoothingFactors() method
var smoothingFactors = cfg.getSmoothingFactors();
//Change value of the eyebrows smoothing factor
smoothing_factors[0] = 2.0;
bool success = m_Configuration.setSmoothingFactors(smoothing_factors);
if (success)
    //The parameter was changed successfully
else
    //The operation failed

Modification of the au_names parameter:


// Obtain a copy of internal VisageConfiguration member
m_Configuration = m_Tracker.getConfiguration();
//Create a VectorString object
var au_names = new VisageModule.VectorString();
//Copy returned vector from the VisageConfiguration.getAuNames() method
au_names =  m_Configuration.getAuNames();
//Change value of the eyebrows smoothing factor
auNames = [];
//
for(var i = 0; i < size; ++i)
{
   auNames[i] = au_names.get(i);
}
auNames[0] = "au_nose";
//
bool success = m_Configuration.setAuNames(auNames);
if (success)
    //The parameter was changed successfully
else
    //The operation failed

Sending the object to VisageTracker

VisageTracker provides a method VisageTracker.setConfiguration(VisageConfiguration vc). Usage is demonstrated in the code example below:


//Assuming m_Configuration object has been obtained as in example above
m_Tracker.setConfiguration(m_Configuration);

The parameters' values of the sent configuration object will be used in the next tracking session (i.e. when VisageTracker.track() is called).

Parameters:

Name	Type	Description
`configurationName`	string	the name of the tracker configuration file (.cfg; default configuration files are provided in lib folder; for further details see VisageTracker Configuration Manual).

Methods

getCameraFocus() → {Number}

Returns the value of the camera_focus parameter.

Returns:

value of the camera_focus parameter.

Type: Number

getRecoveryTimeout() → {Number}

Returns the value of the recovery_timeout parameter.

Returns:

value of the recovery_timeout parameter.

Type: Number

getSmoothingFactors() → {Array}

Returns the value of the smoothing_factors parameter.

Returns:

containing values of the smoothing_factors parameter.

Type: Array

getEnableSmoothing() → {Number}

Returns the value of the enable_smoothing parameter.

Returns:

value of the enable_smoothing parameter.

Type: Number

getTemporallyDenoiseInput() → {Number}

Returns the value of the temporally_denoise_input parameter.

Returns:

value of the temporally_denoise_input parameter.

Type: Number

getPoseModelAuCount() → {Number}

Returns the number of action units for the pose fitting model.

Returns:

value greater than 0 if the pose model is succesfully loaded.

Type: Number

getAuModelAuCount() → {Number}

Returns the number of action units for the action unit fitting model.

Returns:

value greater than 0 if the action model is succesfully loaded.

Type: Number

getMeshModelAuCount() → {Number}

Returns the number of action units for the mesh fitting model.

Returns:

value greater than 0 if the action model is succesfully loaded.

Type: Number

getPoseModelSuCount() → {Number}

Returns the number of shape units for the pose fitting model.

Returns:

value greater than 0 if the pose model is succesfully loaded.

Type: Number

getAuModelSuCount() → {Number}

Returns the number of shape units for the action unit fitting model.

Returns:

value greater than 0 if the action model is succesfully loaded.

Type: Number

getMeshModelSuCount() → {Number}

Returns the number of shape units for the mesh fitting model.

Returns:

value greater than 0 if the mesh model is succesfully loaded.

Type: Number

getProcessEyes() → {Number}

Returns the value of the process_eyes parameter.

Returns:

value of the process_eyes parameter.

Type: Number

getRefineEars() → {Number}

Returns the value of the refine_ears parameter.

Returns:

value of the refine_ears parameter.

Type: Number

getMinFaceScale() → {Number}

Returns the value of the min_face_scale parameter.

Returns:

value of the min_face_scale parameter.

Type: Number

getMaxFaceScale() → {Number}

Returns the value of the max_face_scale parameter.

Returns:

value of the max_face_scale parameter.

Type: Number

getFaceDetectorSensitivity() → {Number}

Returns the value of the face_detector_sensitivity parameter.

Returns:

value of the face_detector_sensitivity parameter.

Type: Number

getPoseFittingModel() → {String}

Returns the value of the pose_fitting_model parameter.

Returns:

containing path of the pose_fitting_model parameter.

Type: String

getAuFittingModel() → {String}

Returns the value of the au_fitting_model parameter.

Returns:

containing path of the au_fitting_model parameter.

Type: String

getMeshFittingModel() → {String}

Returns the value of the mesh_fitting_model parameter.

Returns:

containing path of the mesh_fitting_model parameter.

Type: String

getPoseFittingFdp() → {String}

Returns the value of the pose_fitting_fdp parameter.

Returns:

containing path of the pose_fitting_fdp parameter.

Type: String

getAuFittingFdp() → {String}

Returns the value of the au_fitting_fdp parameter.

Returns:

containing path of the au_fitting_fdp parameter.

Type: String

getMeshFittingFdp() → {String}

Returns the value of the mesh_fitting_fdp parameter.

Returns:

containing path of the mesh_fitting_fdp parameter.

Type: String

getPoseFittingAuUse() → {Array}

Returns the value of the pose_fitting_au_use parameter.

The number of values in the pose_fitting_au_use array is equal to the number of action units of the pose fitting model and can be obtained by getPoseModelAuCount() function.

Returns:

containing values of the pose_fitting_au_use parameter.

Type: Array

getPoseFittingSuUse() → {Array}

Returns the value of the pose_fitting_su_use parameter.

The number of values in the pose_fitting_su_use array is equal to the number of shape units of the pose fitting model and can be obtained by getPoseModelSuCount() function.

Returns:

containing values of the pose_fitting_su_use parameter.

Type: Array

getPoseFittingPoseSensitivity() → {Array}

Returns the value of the pose_fitting_pose_sensitivity parameter.

The number of values in the pose_fitting_pose_sensitivity array is equal to 6.

Returns:

containing values of the pose_fitting_pose_sensitivity parameter.

Type: Array

getPoseFittingAuSensitivity() → {Array}

Returns the value of the pose_fitting_au_sensitivity parameter.

The number of values in the pose_fitting_au_sensitivity array is equal to the number of action units of the pose fitting model and can be obtained by getPoseModelAuCount() function.

Returns:

containing values of the pose_fitting_au_sensitivity parameter.

Type: Array

getPoseFittingSuSensitivity() → {Array}

Returns the value of the pose_fitting_su_sensitivity parameter.

The number of values in the pose_fitting_su_sensitivity array is equal to the number of shape units of the pose fitting model and can be obtained by getPoseModelSuCount() function.

Returns:

containing values of the pose_fitting_su_sensitivity parameter.

Type: Array

getAuFittingAuUse() → {Array}

Returns the value of the au_fitting_au_use parameter.

The number of values in the au_fitting_au_use array is equal to the number of action units of the action unit fitting model and can be obtained by getAuModelAuCount() function.

Returns:

containing values of the au_fitting_au_use parameter.

Type: Array

getAuFittingSuUse() → {Array}

Returns the value of the au_fitting_su_use parameter.

The number of values in the au_fitting_su_use array is equal to the number of shape units of the action unit fitting model and can be obtained by getAuModelSuCount() function.

Returns:

containing values of the au_fitting_su_use parameter.

Type: Array

getAuFittingAuSensitivity() → {Array}

Returns the value of the au_fitting_au_sensitivity parameter.

The number of values in the au_fitting_au_sensitivity array is equal to the number of action units of the action unit fitting model and can be obtained by getAuModelAuCount() function.

Returns:

containing values of the au_fitting_au_sensitivity parameter.

Type: Array

getAuFittingSuSensitivity() → {Array}

Returns the value of the au_fitting_su_sensitivity parameter.

The number of values in the au_fitting_su_sensitivity array is equal to the number of shape units of the action unit fitting model and can be obtained by getAuModelSuCount() function.

Returns:

containing values of the au_fitting_su_sensitivity parameter.

Type: Array

getMeshFittingAuUse() → {Array}

Returns the value of the mesh_fitting_au_use parameter.

The number of values in the mesh_fitting_au_use array is equal to the number of action units of the mesh fitting model and can be obtained by getMeshModelAuCount() function.

Returns:

containing values of the mesh_fitting_au_use parameter.

Type: Array

getMeshFittingSuUse() → {Array}

Returns the value of the mesh_fitting_su_use parameter.

The number of values in the mesh_fitting_su_use array is equal to the number of shape units of the mesh fitting model and can be obtained by getMeshModelSuCount() function.

Returns:

containing values of the mesh_fitting_su_use parameter.

Type: Array

getMeshFittingAuSensitivity() → {Array}

Returns the value of the mesh_fitting_au_sensitivity parameter.

The number of values in the mesh_fitting_au_sensitivity array is equal to the number of action units of the mesh fitting model and can be obtained by getMeshModelAuCount() function.

Returns:

containing values of the mesh_fitting_au_sensitivity parameter.

Type: Array

getMeshFittingSuSensitivity() → {Array}

Returns the value of the mesh_fitting_su_sensitivity parameter.

The number of values in the mesh_fitting_su_sensitivity array is equal to the number of shape units of the mesh fitting model and can be obtained by getMeshModelSuCount() function.

Returns:

containing values of the mesh_fitting_su_sensitivity parameter.

Type: Array

getAuNames() → {VectorString}

Returns the value of the au_names parameter.

The number of names in the au_names array is equal to the number of action units of the action unit fitting model and can be obtained by getAuModelAuCount() function.

Returns:

containing string values of the au_names parameter.

Type: VectorString

getRotationLimit() → {Array}

Returns the value of the rotation_limit parameter.

The number of values in the rotation_limit array is equal to 6.

Returns:

containing values of the rotation_limit parameter.

Type: Array

getTranslationLimit() → {Array}

Returns the value of the translation_limit parameter.

The number of values in the translation_limit array is equal to 6.

Returns:

containing values of the translation_limit parameter.

Type: Array

getAuLimit() → {Array}

Returns the value of the action_unit_limit parameter.

The number of values in the action_unit_limit array is twice the size of the number of action units of the action unit fitting model and can be obtained for each model via the getAuModelAuCount().

Returns:

containing values of the action_unit_limit parameter.

Type: Array

setCameraFocus(camera_focus) → {Boolean}

Sets the value of the camera_focus parameter.

Value must be greater than zero.

Parameters:

Name	Type	Description
`camera_focus`	Number	camera_focus value

Returns:

True if the parameter was changed, false if the input was invalid

Type: Boolean

setRecoveryTimeout(recovery_timeout) → {Boolean}

Sets the value of the recovery_timeout parameter.

Value must be greater than or equal to zero and not a NaN value.

Parameters:

Name	Type	Description
`recovery_timeout`	Number	recovery_timeout value

Returns:

True if the parameter was changed, false if the input was invalid

Type: Boolean

setSmoothingFactors(smoothing_factors) → {Boolean}

Sets the values of the smoothing_factors parameter.

Values must not be a NaN value

Parameters:

Name	Type	Description
`smoothing_factors`	Array	smoothing_factors values

Returns:

True if the parameter was changed, false if the input was invalid

Type: Boolean

setEnableSmoothing(enable_smoothing) → {Boolean}

Sets the value of the enable_smoothing parameter.

Value can only be 0 or 1.

Parameters:

Name	Type	Description
`enable_smoothing`	Number	enable_smoothing value

Returns:

True if the parameter was changed, false if the input was invalid

Type: Boolean

setTemporallyDenoiseInput(temporally_denoise_input) → {Boolean}

Sets the value of the temporally_denoise_input parameter.

Value can only be 0 or 1.

Parameters:

Name	Type	Description
`temporally_denoise_input`	Number	temporally_denoise_input value

Returns:

True if the parameter was changed, false if the input was invalid

Type: Boolean

setProcessEyes(process_eyes) → {Boolean}

Sets the value of the process_eyes parameter.

Value can only be 0, 1, 2, or 3.

Parameters:

Name	Type	Description
`process_eyes`	Number	process_eyes value

Returns:

True if the parameter was changed, false if the input was invalid

Type: Boolean

setRefineEars(refine_ears) → {Boolean}

Sets the value of the refine_ears parameter.

Value can only be 0 or 1.

Parameters:

Name	Type	Description
`refine_ears`	Number	refine_ears value

Returns:

True if the parameter was changed, false if the input was invalid

Type: Boolean

setMinFaceScale(min_face_scale) → {Boolean}

Sets the value of the min_face_scale parameter.

Value must be greater than 0.0 and less than or equal to 1.0.

Parameters:

Name	Type	Description
`min_face_scale`	Number	min_face_scale value

Returns:

True if the parameter was changed, false if the input was invalid

Type: Boolean

setMaxFaceScale(max_face_scale) → {Boolean}

Sets the value of the max_face_scale parameter.

Value must be greater than 0.0 and less than or equal to 1.0.

Parameters:

Name	Type	Description
`max_face_scale`	Number	max_face_scale value

Returns:

True if the parameter was changed, false if the input was invalid

Type: Boolean

setFaceDetectorSensitivity(face_detector_sensitivity) → {Boolean}

Sets the value of the face_detector_sensitivity parameter.

Value must be greater than 0.0 and less than or equal to 1.0.

Parameters:

Name	Type	Description
`face_detector_sensitivity`	Number	face_detector_sensitivity value

Returns:

True if the parameter was changed, false if the input was invalid

Type: Boolean

setPoseFittingModel(pose_fitting_model) → {Boolean}

Sets the value of the pose_fitting_model parameter.

This function sets the .wfm (pose_fitting_model) file used for pose fitting. The model will be disabled if the passed empty string is empty ("") or "none".

NOTE: Changing the model affects the sizes of arrays in the FaceData object populated with values from the model file.

Parameters:

Name	Type	Description
`pose_fitting_model`	String	pose_fitting_model String path to the model file

Returns:

True if the parameter was changed, false if the input file does not exist

Type: Boolean

setAuFittingModel(au_fitting_model) → {Boolean}

Sets the value of the au_fitting_model parameter.

This function sets the .wfm (au_fitting_model) file used for action unit fitting. The model will be disabled if the passed empty string is empty ("") or "none".

NOTE: Changing the model affects the sizes of arrays in the FaceData object populated with values from the model file.

Parameters:

Name	Type	Description
`au_fitting_model`	String	au_fitting_model String path to the model file

Returns:

True if the parameter was changed, false if the input file does not exist

Type: Boolean

setMeshFittingModel(mesh_fitting_model) → {Boolean}

Sets the value of the mesh_fitting_model parameter.

This function sets the .wfm (mesh_fitting_model) file used for mesh fitting. The model will be disabled if the passed empty string is empty ("") or "none".

NOTE: Changing the model affects the sizes of arrays in the FaceData object populated with values from the model file.

Parameters:

Name	Type	Description
`mesh_fitting_model`	String	mesh_fitting_model String path to the model file

Returns:

True if the parameter was changed, false if the input file does not exist

Type: Boolean

setPoseFittingFdp(pose_fitting_fdp) → {Boolean}

Sets the value of the pose_fitting_fdp parameter.

This function sets the .fdp (pose_fitting_fdp) file used for mesh fitting. The pose fitting model will be disabled if the empty string is passed as input file ("").

Parameters:

Name	Type	Description
`pose_fitting_fdp`	String	pose_fitting_fdp String path to the fdp model file

Returns:

True if the parameter was changed, false if the input file does not exist

Type: Boolean

setAuFittingFdp(au_fitting_fdp) → {Boolean}

Sets the value of the au_fitting_fdp parameter.

This function sets the .fdp (au_fitting_fdp) file used for action unit fitting. The pose fitting model will be disabled if the empty string is passed as input file ("").

Parameters:

Name	Type	Description
`au_fitting_fdp`	String	au_fitting_fdp String path to the fdp model file

Returns:

True if the parameter was changed, false if the input file does not exist

Type: Boolean

setMeshFittingFdp(mesh_fitting_fdp) → {Boolean}

Sets the value of the mesh_fitting_fdp parameter.

This function sets the .fdp (mesh_fitting_fdp) file used for mesh fitting. The pose fitting model will be disabled if the empty string is passed as input file ("").

Parameters:

Name	Type	Description
`mesh_fitting_fdp`	String	mesh_fitting_fdp String path to the fdp model file

Returns:

True if the parameter was changed, false if the input file does not exist

Type: Boolean

setPoseFittingAuUse(pose_fitting_au_use) → {Boolean}

Sets the value of the pose_fitting_au_use parameter.

Values can only be 0 or 1. The number of values in the pose_fitting_au_use array must be equal to the number of action units of the pose fitting model which can be obtained by getPoseModelAuCount() function.

Parameters:

Name	Type	Description
`pose_fitting_au_use`	Array	pose_fitting_au_use values

Returns:

True if the parameter was changed, false if the input was invalid

Type: Boolean

setPoseFittingSuUse(pose_fitting_su_use) → {Boolean}

Sets the value of the pose_fitting_su_use parameter.

Values can only be 0 or 1. The number of values in the pose_fitting_su_use array must be equal to the number of shape units of the pose fitting model which can be obtained by getPoseModelSuCount() function.

Parameters:

Name	Type	Description
`pose_fitting_su_use`	Array	pose_fitting_su_use values

Returns:

True if the parameter was changed, false if the input was invalid

Type: Boolean

setPoseFittingPoseSensitivity(pose_fitting_pose_sensitivity) → {Boolean}

Sets the value of the pose_fitting_pose_sensitivity parameter.

The number of values in the pose_fitting_pose_sensitivity array must be equal to 6.

Parameters:

Name	Type	Description
`pose_fitting_pose_sensitivity`	Array	pose_fitting_pose_sensitivity values

Returns:

True if the parameter was changed, false if the input was invalid

Type: Boolean

setPoseFittingAuSensitivity(pose_fitting_au_sensitivity) → {Boolean}

Sets the value of the pose_fitting_au_sensitivity parameter.

The number of values in the pose_fitting_au_sensitivity array must be equal to the number of action units of the pose fitting model which can be obtained by getPoseModelAuCount() function.

Parameters:

Name	Type	Description
`pose_fitting_au_sensitivity`	Array	pose_fitting_au_sensitivity values

Returns:

True if the parameter was changed, false if the input was invalid

Type: Boolean

setPoseFittingSuSensitivity(pose_fitting_su_sensitivity) → {Boolean}

Sets the value of the pose_fitting_su_sensitivity parameter.

The number of values in the pose_fitting_su_sensitivity array must be equal to the number of shape units of the pose fitting model which can be obtained by getPoseModelSuCount() function.

Parameters:

Name	Type	Description
`pose_fitting_su_sensitivity`	Array	pose_fitting_su_sensitivity values

Returns:

True if the parameter was changed, false if the input was invalid

Type: Boolean

setAuFittingAuUse(au_fitting_au_use) → {Boolean}

Sets the value of the au_fitting_au_use parameter.

Values can only be 0 or 1. The number of values in the au_fitting_au_use array must be equal to the number of action units of the action unit fitting model which can be obtained by getAuModelAuCount() function.

Parameters:

Name	Type	Description
`au_fitting_au_use`	Array	au_fitting_au_use values

Returns:

True if the parameter was changed, false if the input was invalid

Type: Boolean

setAuFittingSuUse(au_fitting_su_use) → {Boolean}

Sets the value of the au_fitting_su_use parameter.

Values can only be 0 or 1. The number of values in the au_fitting_su_use array must be equal to the number of shape units of the action unit fitting model which can be obtained by getAuModelSuCount() function.

Parameters:

Name	Type	Description
`au_fitting_su_use`	Array	au_fitting_su_use values

Returns:

True if the parameter was changed, false if the input was invalid

Type: Boolean

setAuFittingAuSensitivity(au_fitting_au_sensitivity) → {Boolean}

Sets the value of the au_fitting_au_sensitivity parameter.

The number of values in the au_fitting_au_sensitivity array must be equal to the number of action units of the action unit fitting model which can be obtained by getAuModelAuCount() function.

Parameters:

Name	Type	Description
`au_fitting_au_sensitivity`	Array	au_fitting_au_sensitivity values

Returns:

True if the parameter was changed, false if the input was invalid

Type: Boolean

setAuFittingSuSensitivity(au_fitting_su_sensitivity) → {Boolean}

Sets the value of the au_fitting_su_sensitivity parameter.

The number of values in the au_fitting_su_sensitivity array must be equal to the number of shape units of the action unit fitting model which can be obtained by getAuModelSuCount() function.

Parameters:

Name	Type	Description
`au_fitting_su_sensitivity`	Array	au_fitting_su_sensitivity values

Returns:

True if the parameter was changed, false if the input was invalid

Type: Boolean

setMeshFittingAuUse(mesh_fitting_au_use) → {Boolean}

Sets the value of the mesh_fitting_au_use parameter.

Values can only be 0 or 1. The number of values in the mesh_fitting_au_use array must be equal to the number of action units of the mesh fitting model which can be obtained by getMeshModelAuCount() function.

Parameters:

Name	Type	Description
`mesh_fitting_au_use`	Array	mesh_fitting_au_use values

Returns:

True if the parameter was changed, false if the input was invalid

Type: Boolean

setMeshFittingSuUse(mesh_fitting_su_use) → {Boolean}

Sets the value of the mesh_fitting_su_use parameter.

Values can only be 0 or 1. The number of values in the mesh_fitting_su_use array must be equal to the number of shape units of the mesh fitting model which can be obtained by getMeshModelSuCount() function.

Parameters:

Name	Type	Description
`mesh_fitting_su_use`	Array	mesh_fitting_su_use values

Returns:

True if the parameter was changed, false if the input was invalid

Type: Boolean

setMeshFittingAuSensitivity(mesh_fitting_au_sensitivity) → {Boolean}

Sets the value of the mesh_fitting_au_sensitivity parameter.

The number of values in the mesh_fitting_au_sensitivity array must be equal to the number of action units of the mesh fitting model which can be obtained by getMeshModelAuCount() function.

Parameters:

Name	Type	Description
`mesh_fitting_au_sensitivity`	Array	mesh_fitting_au_sensitivity values

Returns:

True if the parameter was changed, false if the input was invalid

Type: Boolean

setMeshFittingSuSensitivity(mesh_fitting_su_sensitivity) → {Boolean}

Sets the value of the mesh_fitting_su_sensitivity parameter.

The number of values in the mesh_fitting_su_sensitivity array must be equal to the number of shape units of the mesh fitting model which can be obtained by getMeshModelSuCount() function.

Parameters:

Name	Type	Description
`mesh_fitting_su_sensitivity`	Array	mesh_fitting_su_sensitivity values

Returns:

True if the parameter was changed, false if the input was invalid

Type: Boolean

setAuNames(au_names) → {Boolean}

Sets the value of the au_names parameter.

The number of names in the array must be equal to the number of action units of the action unit fitting model, which can be obtained for each model via the getAuModelAuCount().

Parameters:

Name	Type	Description
`au_names`	Array	au_names values

Returns:

True if the parameter was changed, false if the input was invalid

Type: Boolean

setRotationLimit(rotation_limit) → {Boolean}

Sets the value of the rotation_limit parameter.

The number of values in the rotation_limit array must be equal to 6.

Parameters:

Name	Type	Description
`rotation_limit`	Array	rotation_limit values

Returns:

True if the parameter was changed, false if the input was invalid

Type: Boolean

setTranslationLimit(translation_limit) → {Boolean}

Sets the value of the translation_limit parameter.

The number of values in the translation_limit array must be equal to 6.

Parameters:

Name	Type	Description
`translation_limit`	Array	translation_limit values

Returns:

True if the parameter was changed, false if the input was invalid

Type: Boolean

setAuLimit(action_unit_limit) → {Boolean}

Sets the value of the action_unit_limit parameter.

The number of values in the action_unit_limit array must be twice the size of the number of action units of the action unit fitting model which can be obtained for each model via the getAuModelAuCount().

Parameters:

Name	Type	Description
`action_unit_limit`	Array	action_unit_limit values

Returns:

True if the parameter was changed, false if the input was invalid

Type: Boolean

enableAuModel()

Enables the use of the 3D model used to estimate action units (au_fitting_model configuration parameter).

enableMeshModel()

Enables the use of the fine 3D mesh (mesh_fitting_model configuration parameter).

disableAuModel()

Disables the use of the 3D model used to estimate action units (au_fitting_model configuration parameter).

disableMeshModel()

Disables the use of the fine 3D mesh (mesh_fitting_model configuration parameter).

setUseVNN(use_vnn) → {Boolean}

Enables the use of prototype tracking algorithm (use_vnn configuration parameter). Value can be 0, 1, or 2.

Parameters:

Name	Type	Description
`use_vnn`	Number	use_vnn value

Returns:

True if the parameter was changed, false if the input was invalid

Type: Boolean

getUseVNN()

Returns the value of the use_vnn configuration parameter.