UI Configurations

Features on this page are only available for the Foundational APIs.

CameraView allows you to define your own graphics diplaying rules with the Drawing APIs.

• DrawingItem: Graphics or other UI elements.
• DrawingLayer: The layer for displaying the DrawingItems.
• DrawingStyle: The style for the DrawingItem.

Hide Barcode Highlight Overlay

Barcode highlight overlay is displayed by default. You can set the layer invisible to disable it:

• Objective-C
• Swift

1. // Get the layer first.
   DSDrawingLayer *layer = [self.cameraView getDrawingLayer:DSDrawingLayerIdDBR];
   // Set the visible property to true or false to control the visibility.
   layer.visible = NO;
   

2. // Get the layer first.
   let layer = cameraView.getDrawingLayer(DrawingLayerId.dbr)
   // Set the visible property to true or false to control the visibility.
   layer?.visible = false
   

Add User-Define DrawingItem(s)

• Objective-C
• Swift

1. DSDrawingLayer *barcodeLayer = [self.cameraView getDrawingLayer:DSDrawingLayerIdDBR];
   NSMutableArray<DSDrawingItem *> *drawingItemArrayList = [NSMutableArray array];
   DSQuadDrawingItem *quadDrawingItem = [[DSQuadDrawingItem alloc] initWithQuad:nil];
   [drawingItemArrayList addObject:quadDrawingItem];
   [barcodeLayer setDrawingItems:drawingItemArrayList];
   // You can also use the append logic if you don't want to clear the previous items.
   // [barcodeLayer addDrawingItems:drawingItemArrayList];
   

2. let barcodeLayer = cameraView.getDrawingLayer(DrawingLayerId.dbr)
   var drawingItemArrayList: [DrawingItem] = []
   let quadDrawingItem = QuadDrawingItem(quad: nil)
   drawingItemArrayList.append(quadDrawingItem)
   barcodeLayer?.setDrawingItems(drawingItemArrayList)
   // You can also use the append logic if you don't want to clear the previous items.
   // barcodeLayer?.addDrawingItems(drawingItemArrayList)
   

How to Change the DrawingStyle

Use Preset Styles

Set the style of the highlight overlays with a preset style:

• Objective-C
• Swift

1. // Get the layer first.
   DSDrawingLayer *layer = [self.cameraView getDrawingLayer:DSDrawingLayerIdDBR];
   // Change the style of the layer.
   [layer setDefaultStyle:DSDrawingStyleIdBlueStroke];
   

2. // Get the layer first.
   let layer = cameraView.getDrawingLayer(DrawingLayerId.dbr)
   // Change the style of the layer.
   layer?.setDefaultStyle(DrawingStyleId.blueStroke)
   

Use User Defined Styles

Set the style of the highlight overlays with a user defined style:

• Objective-C
• Swift

1. // Get the layer first.
   DSDrawingLayer *layer = [self.cameraView getDrawingLayer:DSDrawingLayerIdDBR];
   // Create a new DrawingStyle via the DrawingStyleManager.
   UIColor *tealColor = [[UIColor alloc] initWithRed:3/255.0 green:218/255.0 blue:197/255.0 alpha:1];
   UIColor *tealColorTransparent = [[UIColor alloc] initWithRed:3/255.0 green:218/255.0 blue:197/255.0 alpha:0.13];
   NSInteger style = [DSDrawingStyleManager createDrawingStyle:tealColor strokeWidth:1.0 fillColor:tealColorTransparent textColor:tealColor font:UIFontTextStyleBody];
   // Set the newly created DrawingStyle to the layer.
   [layer setDefaultStyle:style];
   

2. // Get the layer first.
   let layer = cameraView.getDrawingLayer(DrawingLayerId.DBR.rawValue)
   // Create a new DrawingStyle via the DrawingStyleManager.
   let tealColor = UIColor.init(red: 3/255.0, green: 218/255.0, blue: 197/255.0, alpha: 1)
   let tealColorTransparent = UIColor.init(red: 3/255.0, green: 218/255.0, blue: 197/255.0, alpha: 0.13)
   let style = DrawingStyleManager.createDrawingStyle(UIColor.systemTeal, strokeWidth: 1.0, fill: UIColor.systemTeal.withAlphaComponent(0.12), textColor: UIColor.systemTeal, font: UIFont.preferredFont(forTextStyle: .body))
   // Set the newly created DrawingStyle to the layer.
   layer?.setDefaultStyle(style)