ScBarcode.h
Go to the documentation of this file.
1 
10 #ifndef SC_BARCODE_H_
11 #define SC_BARCODE_H_
12 
13 #include <Scandit/ScByteArray.h>
15 #include <Scandit/ScConfig.h>
16 #include <Scandit/ScCommon.h>
17 
18 #if defined(__cplusplus)
19 extern "C" {
20 #endif
21 
29 typedef enum {
33  SC_SYMBOLOGY_UNKNOWN = 0x0000000,
37  SC_SYMBOLOGY_EAN13 = 0x0000001,
41  SC_SYMBOLOGY_EAN8 = 0x0000002,
45  SC_SYMBOLOGY_UPCA = 0x0000004,
49  SC_SYMBOLOGY_UPCE = 0x0000008,
53  SC_SYMBOLOGY_CODE128 = 0x0000010,
57  SC_SYMBOLOGY_CODE39 = 0x0000020,
61  SC_SYMBOLOGY_CODE93 = 0x0000040,
69  SC_SYMBOLOGY_QR = 0x0000100,
77  SC_SYMBOLOGY_PDF417 = 0x0000400,
93  SC_SYMBOLOGY_CODABAR = 0x0004000,
97  SC_SYMBOLOGY_AZTEC = 0x0008000,
104 
118  SC_SYMBOLOGY_CODE11 = 0x0080000,
128  SC_SYMBOLOGY_CODE25 = 0x0200000,
133 
137  SC_SYMBOLOGY_RM4SCC = 0x0800000,
138 
142  SC_SYMBOLOGY_KIX = 0x1000000,
146  SC_SYMBOLOGY_DOTCODE = 0x2000000,
151 } ScSymbology;
152 
160 typedef enum {
189 
195 SC_EXPORT
197 
201 SC_EXPORT
203 
204 
213 SC_EXPORT const char* sc_symbology_to_string(ScSymbology symbology);
214 
215 
224 SC_EXPORT ScSymbology sc_symbology_from_string(const char *symbology_string);
225 
226 
238 typedef struct ScOpaqueBarcode ScBarcode;
241 
262 SC_EXPORT ScByteArray
263 sc_barcode_get_data(const ScBarcode *barcode);
264 
282 SC_EXPORT ScEncodingArray
284 
285 
294 SC_EXPORT void sc_barcode_retain(ScBarcode *barcode);
295 
306 SC_EXPORT void sc_barcode_release(ScBarcode *barcode);
307 
308 
320 SC_EXPORT ScSymbology sc_barcode_get_symbology(const ScBarcode *barcode);
321 
336 SC_EXPORT ScBool sc_barcode_is_gs1_data_carrier(const ScBarcode *barcode);
337 
350 
362 SC_EXPORT ScBool sc_barcode_is_recognized(const ScBarcode *barcode);
363 
379 SC_EXPORT ScQuadrilateral sc_barcode_get_location(const ScBarcode *barcode);
380 
391 SC_EXPORT uint32_t sc_barcode_get_frame_id(const ScBarcode *barcode);
392 
403 SC_EXPORT int32_t sc_barcode_get_symbol_count(const ScBarcode *barcode);
404 
415 SC_EXPORT ScBool sc_barcode_is_color_inverted(const ScBarcode *barcode);
416 
417 #if defined(__cplusplus)
418 }
419 #endif
420 
421 
422 #endif //SC_BARCODE_H_
423 
424 
Definition: ScBarcode.h:118
Definition: ScBarcode.h:37
Functions to manage an array of bytes.
Definition: ScBarcode.h:183
A located or recognized barcode/ 2d code in an image.
Definition: ScBarcode.h:53
Definition: ScBarcode.h:179
SC_EXTERN const uint16_t SC_ALL_SYMBOLOGIES_COUNT
The number of elements in the SC_ALL_SYMBOLOGIES array.
Definition: ScBarcode.h:202
ScCompositeFlag sc_barcode_get_composite_flag(const ScBarcode *barcode)
Flag to hint whether the barcode is part of a composite code.
Definition: ScBarcode.h:175
Definition: ScBarcode.h:142
ScSymbology sc_barcode_get_symbology(const ScBarcode *barcode)
Get the symbology of the barcode.
Definition: ScBarcode.h:187
Definition: ScBarcode.h:85
Definition: ScBarcode.h:170
void sc_barcode_retain(ScBarcode *barcode)
Increase reference count of barcode object by one.
Definition: ScBarcode.h:103
Definition: ScBarcode.h:57
Definition: ScBarcode.h:45
Definition: ScBarcode.h:164
Definition: ScBarcode.h:69
Definition: ScBarcode.h:33
Definition: ScBarcode.h:41
ScQuadrilateral sc_barcode_get_location(const ScBarcode *barcode)
Get the location of a recognized or located barcode.
Definition: ScBarcode.h:97
A 2-dimensional polygon with 4 corners.
Definition: ScCommon.h:65
Definition: ScBarcode.h:61
ScCompositeFlag
Flags to hint that two codes form a composite code.
Definition: ScBarcode.h:160
ScBool sc_barcode_is_gs1_data_carrier(const ScBarcode *barcode)
Check whether the barcode is a "GS1" code.
Definition: ScBarcode.h:122
SC_EXTERN const ScSymbology SC_ALL_SYMBOLOGIES[]
Array holding all symbologies supported by the scandit barcode scanner.
Definition: ScBarcode.h:196
Definition: ScBarcode.h:110
ScSymbology
Enumeration of all supported 1d and 2d barcode symbologies.
Definition: ScBarcode.h:29
ScBool sc_barcode_is_color_inverted(const ScBarcode *barcode)
Get the color of the barcode.
Definition: ScBarcode.h:65
Definition: ScBarcode.h:93
uint32_t sc_barcode_get_frame_id(const ScBarcode *barcode)
Get the frame ID a barcode was found in.
Definition: ScBarcode.h:73
ScSymbology sc_symbology_from_string(const char *symbology_string)
Helper function to convert a symbology string to its corresponding symbology enum.
void sc_barcode_release(ScBarcode *barcode)
Decrease reference count of barcode object by one.
Definition: ScBarcode.h:49
Definition: ScBarcode.h:146
#define SC_EXTERN
Use this for defining external symbols.
Definition: ScConfig.h:17
ScBool sc_barcode_is_recognized(const ScBarcode *barcode)
Check whether the barcode was fully decoded (recognized).
Common definitions used throughout the ScanditSDK API.
Common functions and data structures.
An array of encoding ranges.
Definition: ScEncodingArray.h:88
Definition: ScBarcode.h:150
Definition: ScBarcode.h:137
const char * sc_symbology_to_string(ScSymbology symbology)
Helper function to convert the symbology enum to a string.
Definition: ScBarcode.h:77
Definition: ScBarcode.h:89
Definition: ScBarcode.h:81
Functions to manage an array of encoding ranges.
A null terminated array of bytes.
Definition: ScByteArray.h:31
Definition: ScBarcode.h:114
Definition: ScBarcode.h:132
Definition: ScBarcode.h:128
ScByteArray sc_barcode_get_data(const ScBarcode *barcode)
Get the data encoded in the barcode.
int32_t ScBool
Boolean value, can be SC_TRUE or SC_FALSE.
Definition: ScConfig.h:122
ScEncodingArray sc_barcode_get_data_encoding(const ScBarcode *barcode)
Get the data encodings.
int32_t sc_barcode_get_symbol_count(const ScBarcode *barcode)
Get the symbol count of the barcode.