Resource Base
Table of contents

Settings

API Name Description
InitSettings Loads and initializes a template from a string.
InitSettingsFromFile Loads and initializes a template from a file.
OutputSettings Exports a specific CaptureVisionTemplate to a string.
OutputSettingsToFile Exports a specific CaptureVisionTemplate to a file.
GetSimplifiedSettings Retrieves a SimplifiedCaptureVisionSettings object for a specific CaptureVisionTemplate.
UpdateSettings Updates a CaptureVisionTemplate with SimplifiedCaptureVisionSettings object.
ResetSettings Resets all templates to factory settings.

InitSettings

Loads and initializes a template from a string.

int InitSettings(const char* content, char errorMsgBuffer[]=NULL, const int errorMsgBufferLen=0)

Parameters

[in] content The string containing the template.

[in] errorMsgBuffer A buffer for error messages.

[in] errorMsgBufferLen The length of the error message buffer.

Return value

Returns an error code. Zero indicates success.

Error Code Value Description
EC_JSON_PARSE_FAILED -10030 Failed to parse the JSON data.
EC_JSON_TYPE_INVALID -10031 One or more parameters are allocated with wrong data type.
EC_JSON_KEY_INVALID -10032 There exists invalid key in your JSON data.
EC_JSON_VALUE_INVALID -10033 There exists invalid parameter value in your JSON data.
EC_JSON_NAME_KEY_MISSING -10034 One or more name parameters are missing in your JSON data. Each section of the JSON data requires a unique name parameter.
EC_JSON_NAME_VALUE_DUPLICATED -10035 There exists duplicated name parameters in your JSON data. The name parameter should be unique.
EC_JSON_NAME_REFERENCE_INVALID -10037 You have referenced an invalid name value in your JSON data.
EC_PARAMETER_VALUE_INVALID -10038 There exists invalid parameter value in your JSON data.
EC_CALL_REJECTED_WHEN_CAPTURING -10062 Function call is rejected when capturing in progress.

InitSettingsFromFile

Loads and initializes a template from a file.

int InitSettingsFromFile(const char* filePath, char errorMsgBuffer[]=NULL, const int errorMsgBufferLen=0)

Parameters

[in] filePath The path to the file containing the template.

[in] errorMsgBuffer A buffer for error messages.

[in] errorMsgBufferLen The length of the error message buffer.

Return value

Returns an error code. Zero indicates success.

Error Code Value Description
EC_FILE_NOT_FOUND -10005 The file is not found.
EC_JSON_PARSE_FAILED -10030 Failed to parse the JSON data.
EC_JSON_TYPE_INVALID -10031 One or more parameters are allocated with wrong data type.
EC_JSON_KEY_INVALID -10032 There exists invalid key in your JSON data.
EC_JSON_VALUE_INVALID -10033 There exists invalid parameter value in your JSON data.
EC_JSON_NAME_KEY_MISSING -10034 One or more name parameters are missing in your JSON data. Each section of the JSON data requires a unique name parameter.
EC_JSON_NAME_VALUE_DUPLICATED -10035 There exists duplicated name parameters in your JSON data. The name parameter should be unique.
EC_JSON_NAME_REFERENCE_INVALID -10037 You have referenced an invalid name value in your JSON data.
EC_PARAMETER_VALUE_INVALID -10038 There exists invalid parameter value in your JSON data.
EC_CALL_REJECTED_WHEN_CAPTURING -10062 Function call is rejected when capturing in progress.

OutputSettings

Exports a specific template to a string.

char* OutputSettings(const char* templateName, int* pErrorCode = NULL)

Parameters

[in] templateName The name of the template to export.

[out] pErrorCode An error code.

Return value

Returns a string containing the exported template. The string is allocated by the SDK and must be freed by calling FreeString.

Error Code Value Description
EC_TEMPLATE_NAME_INVALID -10036 The target template name is invalid.
EC_CALL_REJECTED_WHEN_CAPTURING -10062 Function call is rejected when capturing in progress.

Remarks

It is supported to export all loaded templates by specifying the templateName as ‘*’.

OutputSettingsToFile

Exports a specific template to a file.

int OutputSettingsToFile(const char* templateName, const char* filePath)

Parameters

[in] templateName The name of the template to export.

[in] filePath The path to the output file.

Return value

Returns an error code. Zero indicates success.

Error Code Value Description
EC_FILE_SAVE_FAILED -10058 The file path is unavailable or the file can’t be created for any other reasons.
EC_CALL_REJECTED_WHEN_CAPTURING -10062 Function call is rejected when capturing in progress.

Remarks

It is supported to export all loaded templates by specifying the templateName as ‘*’.

GetSimplifiedSettings

Retrieves a simplified version of the capture settings for a specific template.

int GetSimplifiedSettings(const char* templateName, SimplifiedCaptureVisionSettings* settings)

Parameters

[in] templateName The name of the template.

[out] settings A pointer to a SimplifiedCaptureVisionSettings object.

Return value

Returns an error code. Zero indicates success.

Error Code Value Description
EC_TEMPLATE_NAME_INVALID -10036 The target template name is invalid.
EC_CONVERT_COMPLEX_TEMPLATE_ERROR -10061 The template you specified is a complex template which can not be output as a SimplifiedCaptureVisionSettings object.
EC_CALL_REJECTED_WHEN_CAPTURING -10062 Function call is rejected when capturing in progress.

See Also

SimplifiedCaptureVisionSettings

UpdateSettings

Updates a template with simplified capture settings.

int UpdateSettings(const char* templateName, const SimplifiedCaptureVisionSettings* settings, char errorMsgBuffer[]=NULL, const int errorMsgBufferLen=0)

Parameters

[in] templateName The name of the template to update.

[in] settings A pointer to a SimplifiedCaptureVisionSettings object.

[in] errorMsgBuffer A buffer for error messages.

[in] errorMsgBufferLen The length of the error message buffer.

Return value

Returns an error code. Zero indicates success.

Error Code Value Description
EC_TEMPLATE_NAME_INVALID -10036 The target template name is invalid.
EC_PARAMETER_VALUE_INVALID -10038 There exists invalid parameter value in your SimplifiedCaptureVisionSettings.
EC_CALL_REJECTED_WHEN_CAPTURING -10062 Function call is rejected when capturing in progress.

See Also

SimplifiedCaptureVisionSettings

ResetSettings

Resets all templates to factory settings.

int ResetSettings()

Return value

Returns an error code. Zero indicates success.

Error Code Value Description
EC_CALL_REJECTED_WHEN_CAPTURING -10062 Function call is rejected when capturing in progress.

This page is compatible for:

Version 1.0

Is this page helpful?

YesYes NoNo

In this article:

latest version

  • Latest version (2.2.0)
  • Version 2.x
    • Version 2.0.30
    • Version 2.0.20
    • Version 2.0.10
    • Version 2.0.0
Change +
© 2003–2024 Dynamsoft. All rights reserved.
Privacy Statement / Site Map / Home / Purchase / Support