Go to the source code of this file.
Data Structures | |
| struct | ScContextStatus |
| struct | ScProcessFrameResult |
| struct | ScCameraProperties |
Typedefs | |
|
typedef struct ScOpaqueRecognitionContext | ScRecognitionContext |
Functions | |
| void | sc_context_status_free (ScContextStatus status) |
| void | sc_process_frame_result_free (ScProcessFrameResult result) |
Detailed Description
Recognition context interface.
- Copyright
- Copyright (c) 2015 Scandit AG. All rights reserved.
Data Structure Documentation
| struct ScContextStatus |
Status information with error message details.
This structure contains both the status flag and a human-readable error message providing more detailed information about any errors that occurred during recognition context operations.
The message can be an unowned constant for common status or dynamically allocated memory for failures. In any case sc_context_status_free() must be called after use.
- Since
- 8.0.0
| Data Fields | ||
|---|---|---|
| ScContextStatusFlag | flag | Execution status flag. |
| ScByteArray | message | Human readable error message. |
| struct ScProcessFrameResult |
| Data Fields | ||
|---|---|---|
| ScContextStatus | status | Execution status with detailed error information. |
| uint32_t | frame_id | frame identification number within the current frame sequence |
| struct ScCameraProperties |
Platform specific camera properties.
- Since
- 5.26.0
| Data Fields | ||
|---|---|---|
| ScCameraFacingDirection | facing_direction | The direction of the camera. |
| char const * | identifier |
Default is NULL. A camera ID string, where ID is unique per facing direction. |
Enumeration Type Documentation
| enum ScContextStatusFlag |
Context status of a frame.
- Since
- 4.6.0
| Enumerator | |
|---|---|
| SC_RECOGNITION_CONTEXT_STATUS_UNKNOWN |
The context status is unknown. |
| SC_RECOGNITION_CONTEXT_STATUS_SUCCESS |
The context status is okay. No error occured. |
| SC_RECOGNITION_CONTEXT_STATUS_INTERNAL_ERROR |
The context encountered an internal error. |
| SC_RECOGNITION_CONTEXT_STATUS_FRAME_SEQUENCE_NOT_STARTED |
Error code to indicate that sc_recognition_context_process_frame() was called without a prior call to sc_recognition_context_start_new_frame_sequence(). |
| SC_RECOGNITION_CONTEXT_STATUS_UNSUPPORTED_IMAGE_DATA |
The provided image data is not supported by the recognition context. |
| SC_RECOGNITION_CONTEXT_STATUS_INCONSISTENT_IMAGE_DATA |
The provided image data has missing or inconsistent properties. This error code can for example indicate that the data buffer size of the provided image buffer is too small for the given combination of image dimensions and format. |
| SC_RECOGNITION_CONTEXT_STATUS_NO_NETWORK_CONNECTION |
Scandit SDK failed to get network access which is mandatory for certain license types. For example a test license. Connect your device to the network, restart the application and try again. |
| SC_RECOGNITION_CONTEXT_STATUS_LICENSE_VALIDATION_FAILED_403 |
Scandit SDK validation failed. Make sure your app key is valid and check your account for available device activations. |
| SC_RECOGNITION_CONTEXT_STATUS_LICENSE_KEY_MISSING |
No Scandit SDK license key was set. Please set a valid license key in your application. |
| SC_RECOGNITION_CONTEXT_STATUS_LICENSE_KEY_EXPIRED |
The Scandit SDK validation failed. Your license key has expired. Please login to scandit.com and aquire a new one.
|
| SC_RECOGNITION_CONTEXT_STATUS_INVALID_PLATFORM |
The Scandit SDK license validation failed. Your license key does not include this platform. Please contact the Scandit support to request a different license key.
|
| SC_RECOGNITION_CONTEXT_STATUS_INVALID_APP_ID |
The Scandit SDK validation failed. Your app ID does not match the license key's app ID. Please change the app identifier of your app or acquire a new license key that matches your application identifier.
|
| SC_RECOGNITION_CONTEXT_STATUS_INVALID_DEVICE |
The Scandit SDK validation failed. Your license key does not include support for this device. Please contact the Scandit support to request a different license key.
|
| SC_RECOGNITION_CONTEXT_STATUS_INVALID_SDK_VERSION |
The Scandit SDK validation failed. Your license key does not include support for this SDK version. Please contact the Scandit support to request a different license key.
|
| SC_RECOGNITION_CONTEXT_STATUS_LICENSE_KEY_INVALID |
The provided Scandit SDK license license key is invalid. Please set a valid license key in your application.
|
| SC_RECOGNITION_CONTEXT_STATUS_DEVICE_ACTIVATION_FAILED |
The device activation failed. Please connect to the Internet and restart the application.
|
| SC_RECOGNITION_CONTEXT_STATUS_TIME_EXCEEDED |
The device activation failed. The number of allowed days to use the SDK has exceeded.
|
| SC_RECOGNITION_CONTEXT_STATUS_SCANS_EXCEEDED |
The device activation failed. The number of allowed scans has exceeded.
|
| SC_RECOGNITION_CONTEXT_STATUS_REGISTRATION_MANDATORY_BUT_NOT_REGISTERED |
The registration of the device is mandatory and must be completed before the recognition context can be used.
|
| SC_RECOGNITION_CONTEXT_STATUS_INVALID_EXTERNAL_ID |
The Scandit SDK validation failed. The external id does not match with the license key.
|
| SC_RECOGNITION_CONTEXT_STATUS_UNLICENSED_SYMBOLOGY_ENABLED |
Your license does not include a symbology enabled by your barcode scanner settings.
|
| SC_RECOGNITION_CONTEXT_STATUS_INVALID_LICENSE_KEY_VERSION |
Your license key's version is not compatible with this SDK version. Please contact Scandit support to request a different license key.
|
| SC_RECOGNITION_CONTEXT_STATUS_UNLICENSED_SYMBOLOGY_EXTENSION_ENABLED |
Your license does not include a symbology extension enabled by your barcode scanner settings.
|
| SC_RECOGNITION_CONTEXT_STATUS_MISSING_RESOURCE_ERROR |
A missing resource made the scanning operation fail.
|
| SC_RECOGNITION_CONTEXT_STATUS_UNLICENSED_TEXT_RECOGNIZER |
The license does not include the requested text recognizer.
|
| SC_RECOGNITION_CONTEXT_STATUS_OCR_ERROR |
An error has occurred in the OCR module.
|
| SC_RECOGNITION_CONTEXT_STATUS_UNLICENSED_FEATURE_BEGIN |
Denotes the beginning of the enum range for unlicensed features. When trying to use an unlicensed feature, the ScContextStatusFlag will be set to an enum in the range from SC_RECOGNITION_CONTEXT_STATUS_UNLICENSED_FEATURE_BEGIN to SC_RECOGNITION_CONTEXT_STATUS_UNLICENSED_FEATURE_END. The exact value depends on the unlicensed feature. To determine which feature is unlicensed, use sc_context_status_flag_get_message which will return a human-readable representation of the error.
|
| SC_RECOGNITION_CONTEXT_STATUS_UNLICENSED_FEATURE_END |
Denotes the end of the enum range for unlicensed features.
|
The direction of the camera. The default camera direction is SC_CAMERA_FACING_DIRECTION_UNKNOWN.
- Since
- 5.26.0
Function Documentation
| void sc_context_status_free | ( | ScContextStatus | status | ) |
Free the resources associated with an ScContextStatus.
This function releases any memory allocated for the message field.
- Parameters
-
status The ScContextStatus to free
- Since
- 8.0.0
| void sc_process_frame_result_free | ( | ScProcessFrameResult | result | ) |
Free the resources associated with an ScProcessFrameResult.
This function releases any memory allocated for the status field.
- Parameters
-
result The ScProcessFrameResult to free
- Since
- 8.0.0