Barcode
Defined in framework ScanditBarcodeCapture
- SDCBarcode
@interface SDCBarcode : NSObject
Added in version 6.0.0
A recognized barcode.
- symbology
@property (nonatomic, readonly) SDCSymbology symbology
Added in version 6.0.0
The symbology of the barcode.
- data
@property (nonatomic, nullable, readonly) NSString *data
Added in version 6.0.0
The data of this code as a unicode string.
For some types of barcodes/2d codes (for example Data Matrix, Aztec, Pdf417), the data may contain non-printable characters, characters that cannot be represented as unicode code points, or nul-bytes in the middle of the string. data may be nil for such codes. How invalid code points are handled is platform-specific and should not be relied upon. If your applications relies on scanning of such codes, use rawData instead which is capable of representing this data without loss of information.
- rawData
@property (nonatomic, nonnull, readonly) NSData *rawData
Added in version 6.0.0
The raw data contained in the barcode.
Use this property instead of data if you are relying on binary-encoded data that cannot be represented as unicode strings.
Unlike data which returns the data in Unicode representation, the rawData returns the data with the encoding that was used in the barcode. See encodingRanges for more information.
- rawDataNoCopy
@property (nonatomic, nonnull, readonly) NSData *rawDataNoCopy
Added in version 6.7.0
Similar to rawData, but unlike rawData, rawDataNoCopy does not copy the data. This means that the returned NSData might have corrupted data when the SDCBarcode instance holding the data is deallocated.
- addOnData
@property (nonatomic, nullable, readonly) NSString *addOnData
Added in version 6.5.0
If present, this property returns the add-on code (also known as extension code) associated with this barcode. See Add-on Codes to understand how add-ons can be enabled.
- compositeData
@property (nonatomic, nullable, readonly) NSString *compositeData
Added in version 6.6.0
- compositeRawData
@property (nonatomic, nullable, readonly) NSData *compositeRawData
Added in version 6.6.0
- encodingRanges
@property (nonatomic, nonnull, readonly) NSArray<SDCEncodingRange *> *encodingRanges
Added in version 6.0.0
Array of encoding ranges. Each entry of the returned encoding array points into bytes of rawData and indicates what encoding is used for these bytes. This information can then be used to convert the bytes to unicode, or other representations. For most codes, a single encoding range covers the whole data, but certain 2d symbologies, such as SDCSymbologyQR allow to switch the encoding in the middle of the code.
The returned encoding ranges are sorted from lowest to highest index. Each byte in rawData is contained in exactly one range, e.g. there are no holes or overlapping ranges.
- location
@property (nonatomic, readonly) SDCQuadrilateral location
Added in version 6.0.0
The location of the code. The coordinates are in image-space, meaning that the coordinates correspond to actual pixels in the image. For display, the coordinates need first to be converted into screen-space using the data capture view.
The meaning of the values of SDCQuadrilateral.topLeft etc is such that the top left point corresponds to the top left corner of the barcode, independent of how the code is oriented in the image.
Note
If you use SDCBarcodeTracking you should not use this location at all. Instead use the always up-to-date SDCTrackedBarcode.location.
Warning
In case the feature is not licensed, a quadrilateral with all corners set to 0, 0 is returned.
- isGS1DataCarrier
@property (nonatomic, readonly)
BOOL
isGS1DataCarrierAdded in version 6.0.0
YES for codes that carry GS1 data.
- compositeFlag
@property (nonatomic, readonly) SDCCompositeFlag compositeFlag
Added in version 6.0.0
Flag to hint whether the barcode is part of a composite code.
- isColorInverted
@property (nonatomic, readonly)
BOOL
isColorInvertedAdded in version 6.0.0
Whether the recognized code is color inverted (printed bright on dark background).
- symbolCount
@property (nonatomic, readonly) NSInteger symbolCount
Added in version 6.0.0
The symbol count of this barcode. Use this value to determine the symbol count of a particular barcode, e.g. to configure the active symbol counts.
- frameId
@property (nonatomic, readonly) NSUInteger frameId
Added in version 6.0.0
Id of the frame from which this barcode information was obtained.
- isStructuredAppend
@property (nonatomic, readonly)
BOOL
isStructuredAppendAdded in version 6.15.0
Whether the barcode is a structured append barcode.
- structuredAppendData
@property (nonatomic, nullable, readonly) SDCStructuredAppendData *structuredAppendData
Added in version 6.15.0
If present, this property returns the structured append data associated with this barcode. In structured append mode data is encoded across multiple 1D or 2D barcodes where each barcode contains only one segment of the complete data. Once all segment-containing barcodes are scanned the complete data can be read out.
Only a few symbologies (pdf417, microPdf417, QR, DataMatrix, Aztec, DotCode, MaxiCode) can use this mode, and each has a different set of limitations, like included metadata or the maximum number of barcodes that can form a set.
- JSONString
@property (nonatomic, nonnull, readonly) NSString *JSONString
Added in version 6.1.0
Returns the JSON representation of the barcode.
- + barcodeWithBarcodeInfo:
+ (nonnull
instancetype
)barcodeWithBarcodeInfo:(SDCBarcodeInfo *)infoAdded in version 6.10.0
Constructs a Barcode instance using the specified information. Can be used to create mocks for unit testing
- - initWithBarcodeInfo:
- (
instancetype
)initWithBarcodeInfo:(SDCBarcodeInfo *)infoAdded in version 6.13.0
Constructs a Barcode instance using the specified information. Can be used to create mocks for unit testing