Table of contents

DSSimplifiedCaptureVisionSettings

The DSSimplifiedCaptureVisionSettings class contains settings for capturing and recognizing images with the DSCaptureVisionRouter class.

Definition

Assembly: DynamsoftCaptureVisionRouter.xcframework

  • Objective-C
  • Swift
  1. @interface DSSimplifiedCaptureVisionSettings : NSObject
    
  2. class SimplifiedCaptureVisionSettings : NSObject
    

Attributes

Attributes Type Description
capturedResultItemTypes NSInteger Specifies the type(s) of CapturedItem(s) that will be captured.
roi DSQuadrilateral Specifies the region of interest (ROI) of the image or frame where the capture and recognition will take place.
roiMeasuredInPercentage BOOL Specifies whether the ROI is measured in pixels (false) or as a percentage of the image dimensions (true).
maxParallelTasks NSInteger Specifies the maximum number of parallel tasks that can be used for image capture and recognition.
minImageCaptureInterval NSInteger Set the minimum capture interval, measured in milliseconds.
timeout NSInteger Specifies the maximum time (in milliseconds) allowed for image capture and recognition.
barcodeSettings DSSimplifiedBarcodeReaderSettings Specifies the settings for the DynamsoftBarcodeReader task.
labelSettings DSSimplifiedLabelRecognizerSettings Specifies the settings for the DynamsoftLabelRecognizer task.
documentSettings SimplifiedDocumentNormalizerSettings Specifies the settings for the DynamsoftDocumentNormalizer task.

capturedResultItemTypes

Specifies the type(s) of CapturedItem(s) that will be returned by the Capture Vision Router.

  • Objective-C
  • Swift
  1. @property (nonatomic, assign) NSInteger capturedResultItemTypes;
    
  2. var capturedResultItemTypes: Int { get set }
    

Remarks

You can specify multiple types. For example, you can use the following code to add CRIT_ORIGINAL_IMAGE to the captured results of PT_READ_BARCODES template.

  • Objective-C
  • Swift
  1. DSSimplifiedCaptureVisionSettings *settings = [self.cvr getSimplifiedSettings:DSPresetTemplateReadBarcodes error:nil];
    settings.capturedResultItemTypes = DSCapturedResultItemTypeBarcode | DSCapturedResultItemTypeOriginalImage;
    [self.cvr updateSettings:DSPresetTemplateDefault settings:settings error:nil];
    
  2. simplifiedSettings.barcodeSettings?.barcodeFormatIds = [BarcodeFormat.all]
    simplifiedSettings.capturedResultItemTypes = [.barcode, .originalImage]
    try! cvr.updateSettings(PresetTemplate.readBarcodes.rawValue, settings: simplifiedSettings)
    

View EnumCapturedResultItemType to learn of all supported result item types.

roi

Specifies the region of interest (ROI) of the image or frame where the capture and recognition will take place.

  • Objective-C
  • Swift
  1. @property (nonatomic, strong, nullable) DSQuadrilateral *roi;
    
  2. var roi: DSQuadrilateral? { get set }
    

roiMeasuredInPercentage

Specifies whether the ROI is measured in pixels (false) or as a percentage of the image dimensions (true).

  • Objective-C
  • Swift
  1. @property (nonatomic, assign) BOOL roiMeasuredInPercentage;
    
  2. var roiMeasuredInPercentage: Bool { get set }
    

maxParallelTasks

Specifies the maximum number of parallel tasks that can be used for image capture and recognition.

  • Objective-C
  • Swift
  1. @property (nonatomic, assign) NSInteger maxParallelTasks;
    
  2. var maxParallelTasks: Int { get set }
    

minImageCaptureInterval

Set the minimum capture interval (in milliseconds) between consecutive frames when capturing via video. In other words, it is a measure of the frequency in which frames are fetched.

  • Objective-C
  • Swift
  1. @property (nonatomic, assign) NSInteger minImageCaptureInterval;
    
  2. var minImageCaptureInterval: Int { get set }
    

Remarks

If you find that the battery consumption when using any of the Dynamsoft Capture Vision products, we recommend setting this parameter to a higher value. Please see this article for more info on how to reduce battery consumption.

timeout

Specifies the maximum time (in milliseconds) allowed for image capture and recognition.

  • Objective-C
  • Swift
  1. @property (nonatomic, assign) NSInteger timeout;
    
  2. var timeout: Int { get set }
    

barcodeSettings

Specifies the settings for the DynamsoftBarcodeReader task with a SimplifiedBarcodeReaderSettings object.

  • Objective-C
  • Swift
  1. @property (nonatomic, strong, nullable) DSSimplifiedBarcodeReaderSettings *barcodeSettings;
    
  2. var barcodeSettings: DSSimplifiedBarcodeReaderSettings? { get set }
    

labelSettings

Specifies the settings for the DynamsoftLabelRecognizer task with a SimplifiedLabelRecognizerSettings object.

  • Objective-C
  • Swift
  1. @property (nonatomic, strong, nullable) DSSimplifiedLabelRecognizerSettings *labelSettings;
    
  2. var labelSettings: DSSimplifiedLabelRecognizerSettings? { get set }
    

documentSettings

Specifies the settings for the DynamsoftDocumentNormalizer task with a SimplifiedDocumentNormalizerSettings object.

  • Objective-C
  • Swift
  1. @property (nonatomic, strong, nullable) DSSimplifiedDocumentNormalizerSettings *documentSettings;
    
  2. var documentSettings: DSSimplifiedDocumentNormalizerSettings? { get set }
    

This page is compatible for:

Is this page helpful?

YesYes NoNo

In this article: