DSCandidateBarcodeZonesUnit Class

The DSCandidateBarcodeZonesUnit class represents a unit that contains candidate barcode zones unit. It inherits from the DSIntermediateResultUnit class.

Definition

Assembly: DynamsoftBarcodeReader.framework

Objective-C
Swift

@interface DSCandidateBarcodeZonesUnit : DSIntermediateResultUnit

class CandidateBarcodeZonesUnit : IntermediateResultUnit

Methods

Method	Description
`getCandidateBarcodeZones`	Gets the candidate barcode zones.
`getCount`	Gets the number of candidate barcode zones.
`getCandidateBarcodeZone`	Gets the candidate barcode zone.
`removeAllCandidateBarcodeZones`	Removes all candidate barcode zones.
`removeCandidateBarcodeZone`	Removes the candidate barcode zone.
`addCandidateBarcodeZone`	Adds the candidate barcode zone.
`setCandidateBarcodeZone`	Sets the candidate barcode zone.

Inherited Methods

The following methods are inherited from class DSIntermediateResultUnit.

Method	Description
`getHashId`	Gets the hash ID of the unit.
`getOriginalImageHashId`	Gets the hash ID of the original image.
`getOriginalImageTag`	Gets the image tag of the original image.
`getType`	Gets the type of the intermediate result unit.
`getTransformMatrix`	Gets the transformation matrix via `DSTransformMatrixType`.
`clone`	Creates a copy of the intermediate result unit.
`replace`	Replaces the content of the intermediate result unit.

getCandidateBarcodeZones

Gets the candidate barcode zones.

Objective-C
Swift

-(nullable NSArray< DSCandidateBarcodeZone* >*)getCandidateBarcodeZones;

func getCandidateBarcodeZones() -> [CandidateBarcodeZone]?

Return Value

An array of DSCandidateBarcodeZone objects that represents the candidate barcode zones.

getCount

Gets the number of candidate barcode zones.

Objective-C
Swift

```
-(NSInteger)getCount;
```
```
func getCount() -> Int
```

Return Value

The number of candidate barcode zones.

getCandidateBarcodeZone

Gets the candidate barcode zone.

Objective-C
Swift

-(DSCandidateBarcodeZone *)getCandidateBarcodeZone:(NSInteger)index;

func getCandidateBarcodeZone(index: Int) -> CandidateBarcodeZone?

Parameters

index: The index of the candidate barcode zone.

Return Value

A DSCandidateBarcodeZone object that represents the candidate barcode zone.

removeAllCandidateBarcodeZones

Removes all candidate barcode zones.

Objective-C
Swift

```
-(void)removeAllCandidateBarcodeZones;
```
```
func removeAllCandidateBarcodeZones()
```

removeCandidateBarcodeZone

Removes the candidate barcode zone.

Objective-C
Swift

-(NSInteger)removeCandidateBarcodeZone:(NSInteger)index;

func removeCandidateBarcodeZone(index: Int) -> Int

Parameters

index: The index of the candidate barcode zone.

Return Value

Returns the ErrorCode if failed. Otherwise, returns 0.

addCandidateBarcodeZone

Adds the candidate barcode zone.

Objective-C
Swift

-(NSInteger)addCandidateBarcodeZone:(DSCandidateBarcodeZone*)barcodeZone
matrixToOriginalImage:(CGAffineTransform)matrixToOriginalImage;

func addCandidateBarcodeZone(barcodeZone: CandidateBarcodeZone, matrixToOriginalImage: CGAffineTransform) -> Int

Parameters

barcodeZone: The candidate barcode zone to be added.

matrixToOriginalImage: The transformation matrix of the original image.

Return Value

Returns the ErrorCode if failed. Otherwise, returns 0.

setCandidateBarcodeZone

Sets the candidate barcode zone.

Objective-C
Swift

-(NSInteger)setCandidateBarcodeZone:(NSInteger)index
                    barcodeZone:(DSCandidateBarcodeZone*)barcodeZone
          matrixToOriginalImage:(CGAffineTransform)matrixToOriginalImage;

func setCandidateBarcodeZone(index: Int, barcodeZone: CandidateBarcodeZone, matrixToOriginalImage: CGAffineTransform) -> Int

Parameters

index: The index of the candidate barcode zone.

barcodeZone: The candidate barcode zone to be set.

matrixToOriginalImage: The transformation matrix of the original image.

Return Value

Returns the ErrorCode if failed. Otherwise, returns 0.