|
1 | 1 | --- |
2 | 2 | layout: default-layout |
3 | | -title: Dynamsoft Barcode Reader MAUI API Reference - Main Page |
4 | | -description: This is the main page of Dynamsoft Barcode Reader SDK API Reference for MAUI Language. |
5 | | -keywords: BarcodeReader, api reference, MAUI |
| 3 | +title: Dynamsoft Barcode Reader MAUI API Reference - Main Page |
| 4 | +description: This is the main page of Dynamsoft Barcode Reader SDK API Reference for MAUI. |
| 5 | +keywords: api reference, MAUI |
| 6 | +needAutoGenerateSidebar: true |
| 7 | +noTitleIndex: true |
| 8 | +needGenerateH3Content: true |
6 | 9 | --- |
7 | 10 |
|
8 | | -# DBR MAUI Main APIs |
| 11 | +# SDK Overview: Modules and Main APIs |
9 | 12 |
|
10 | | -## Capture Vision Router |
| 13 | +This page provides an overview of the various modules and highlights the most essential APIs that form the backbone of Dynamsoft Barcode Reader SDKs. |
11 | 14 |
|
12 | | -The main class [`CaptureVisionRouter`]({{ site.dcvb_maui_api }}capture-vision-router/capture-vision-router.html) acts as the SDK entry point and provides the following essential APIs: |
| 15 | +## Modules Summary |
13 | 16 |
|
14 | | -- [Set input]({{ site.dcvb_maui_api }}capture-vision-router/multiple-file-processing.html#setinput) |
15 | | -- [Config barcode reader settings]({{ site.dcvb_maui_api }}capture-vision-router/settings.html) |
16 | | -- [Add result receiver]({{ site.dcvb_maui_api }}capture-vision-router/multiple-file-processing.html#addresultreceiver) |
17 | | -- [Start video stream barcode processing]({{ site.dcvb_maui_api }}capture-vision-router/multiple-file-processing.html#startcapturing) |
| 17 | +**Dynamsoft.BarcodeReaderBundle.Maui** is built on the Dynamsoft Capture Vision (DCV) framework, which includes multiple modules working together to achieve barcode reading. The hierarchical structure diagram below illustrates the various modules of the DBR SDK (with modules at the top depending on those below). |
18 | 18 |
|
19 | | -## Image Source Adapter |
| 19 | +<div align="center"> |
| 20 | + <p><img src="../../assets/dcv-dbr-dependency.png" width="70%" alt="region-def"></p> |
| 21 | + <p>Modules hierarchical of the DBR SDK</p> |
| 22 | +</div> |
20 | 23 |
|
21 | | -The [`ImageSourceAdapter`]({{ site.dcvb_maui_api }}core/image-source-adapter.html) class is an abstract class representing an adapter for image sources, providing a framework for fetching, buffering, and managing images from various sources. It serves as the input for the [`CaptureVisionRouter`]({{ site.dcvb_maui_api }}capture-vision-router/capture-vision-router.html). You can either use the typical implementations of [`ImageSourceAdapter`]({{ site.dcvb_maui_api }}core/image-source-adapter.html) or implement your own. |
| 24 | +The table below describes details the functionalities of these modules: |
22 | 25 |
|
23 | | -Class [`CameraEnhancer`]({{ site.dce_maui_api }}camera-enhancer.html) is one of the typical implementations of [`ImageSourceAdapter`]({{ site.dcvb_maui_api }}core/image-source-adapter.html). It is a class that not only implements the video frame obtaining APIs but also enable you to improve the video quality by adjusting the camera settings. |
| 26 | +| File | Description | |
| 27 | +|:-----|:------------| |
| 28 | +| `Dynamsoft.CaptureVisionRouter.Maui` | The Dynamsoft Capture Vision Router module is the cornerstone of the Dynamsoft Capture Vision (DCV) architecture. It focuses on coordinating batch image processing and provides APIs for setting up image sources and result receivers, configuring workflows with parameters, and controlling processes. | |
| 29 | +| `Dynamsoft.BarcodeReader.Maui`(DBR) | The Dynamsoft Barcode Reader module recognizes and decodes multiple barcode formats such as QR codes, Code 39, Code 128, and Data Matrix, among many others. | |
| 30 | +| `Dynamsoft.Core.Maui` | The Dynamsoft Core module lays the foundation for Dynamsoft SDKs based on the DCV (Dynamsoft Capture Vision) architecture. It encapsulates the basic classes, interfaces, and enumerations shared by these SDKs.| |
| 31 | +| `Dynamsoft.ImageProcessing.Maui` | The Dynamsoft Image Processing module facilitates digital image processing and supports operations for other modules, including the Barcode Reader, Label Recognizer, and Document Normalizer. | |
| 32 | +| `Dynamsoft.License.Maui` | The Dynamsoft License module manages the licensing aspects of Dynamsoft SDKs based on the DCV (Dynamsoft Capture Vision) architecture. | |
| 33 | +| `Dynamsoft.CameraEnhancer.Maui` | The Dynamsoft Camera Enhancer (DCE) module controls the camera, transforming it into an image source for the DCV (Dynamsoft Capture Vision) architecture through ISA implementation. It also enhances image quality during acquisition and provides basic viewers for user interaction. | |
| 34 | +| `Dynamsoft.Utility.Maui` | The Dynamsoft Utility module defines auxiliary classes, including the ImageManager, and implementations of the CRF (Captured Result Filter) and ISA (Image Source Adapter). These are shared by all Dynamsoft SDKs based on the DCV (Dynamsoft Capture Vision) architecture. | |
24 | 35 |
|
25 | | -## Captured Result Receiver |
| 36 | +## Main APIs |
26 | 37 |
|
27 | | -To receive the results of video streaming barcode decoding, you need to implement the [`CapturedResultReceiver`]({{ site.dcvb_maui_api }}capture-vision-router/auxiliary-classes/captured-result-receiver.html) with the callback method [`OnDecodedBarcodesReceived`]({{ site.dcvb_maui_api }}capture-vision-router/auxiliary-classes/captured-result-receiver.html#ondecodedbarcodesreceived). The result you received in the callback method is a [`DecodedBarcodesResult`](decoded-barcodes-result.md) object, which contains all the decoded barcodes from the processed video frame. |
| 38 | +### Capture Vision Router |
28 | 39 |
|
29 | | -- [`OnDecodedBarcodesReceived`]({{ site.dcvb_maui_api }}capture-vision-router/auxiliary-classes/captured-result-receiver.html#ondecodedbarcodesreceived): The callback method for you to receive the barcode decoding results with a [`DecodedBarcodesResult`](decoded-barcodes-result.md) object. |
30 | | -- [`DecodedBarcodesResult`](decoded-barcodes-result.md): An object that contains all the [`BarcodeResultItem`](barcode-result-item.md) that obtained from a video frame. |
31 | | -- [`BarcodeResultItem`](barcode-result-item.md): The basic item that represents a single barcode with the decoded text and other information. |
| 40 | +The main class [`CaptureVisionRouter`]({{ site.dcv_maui_api }}capture-vision-router/capture-vision-router.html) acts as the SDK entry point and provides the following essential APIs: |
32 | 41 |
|
33 | | -## Camera View |
| 42 | +- [Set input]({{ site.dcv_maui_api }}capture-vision-router/multiple-file-processing.html#setinput) |
| 43 | +- [Config capture vision settings]({{ site.dcv_maui_api }}capture-vision-router/settings.html) |
| 44 | +- [Add result receiver]({{ site.dcv_maui_api }}capture-vision-router/multiple-file-processing.html#addresultreceiver) |
| 45 | +- [Start capturing]({{ site.dcv_maui_api }}capture-vision-router/multiple-file-processing.html#startcapturing) |
34 | 46 |
|
35 | | -[`CameraView`]({{ site.dce_maui_api }}camera-view.html) is a view class that design for visualizing the real time video streaming and the barcode decoding result. If the [`CameraEnhancer`]({{ site.dce_maui_api }}camera-enhancer.html) is set as the input of your CVR, the decoded barcodes will be highlighted automatically on the [`CameraView`]({{ site.dce_maui_api }}camera-view.html). |
| 47 | +### Image Source Adapter |
| 48 | + |
| 49 | +The [`ImageSourceAdapter`]({{ site.dcv_maui_api }}core/image-source-adapter.html) class is an abstract class representing an adapter for image sources, providing a framework for fetching, buffering, and managing images from various sources. It serves as the input for the [`CaptureVisionRouter`]({{ site.dcv_maui_api }}capture-vision-router/capture-vision-router.html). You can either use the typical implementations of [`ImageSourceAdapter`]({{ site.dcv_maui_api }}core/image-source-adapter.html) or implement your own. |
| 50 | + |
| 51 | +Class [`CameraEnhancer`]({{ site.dce_maui_api }}camera-enhancer.html) is one of the typical implementations of [`ImageSourceAdapter`]({{ site.dcv_maui_api }}core/image-source-adapter.html). It is a class that not only implements the video frame obtaining APIs but also enable you to improve the video quality by adjusting the camera settings. |
| 52 | + |
| 53 | +### Captured Result Receiver |
| 54 | + |
| 55 | +Implement the callback methods of [`CapturedResultReceiver`]({{ site.dcv_maui_api }}capture-vision-router/auxiliary-classes/captured-result-receiver.html) to receive the corresponding results you required. The callbacks are triggered when the processing of an image/vide frame is finished or timeout. |
| 56 | + |
| 57 | +#### Barcode Decoding |
| 58 | + |
| 59 | +Callback methods that are related to barcode decoding: |
| 60 | + |
| 61 | +- [`OnDecodedBarcodesReceived`]({{ site.dcv_maui_api }}capture-vision-router/auxiliary-classes/captured-result-receiver.html#ondecodedbarcodesreceived): The callback of barcode decoding. The result you received in the callback method is a [`DecodedBarcodesResult`]({{ site.dbr_maui_api }}decoded-barcodes-result.html) object, which contains all the decoded barcodes from the processed image. |
| 62 | + |
| 63 | +Related APIs: |
| 64 | + |
| 65 | +- [`DecodedBarcodesResult`]({{ site.dbr_maui_api }}decoded-barcodes-result.html): All barcodes that decoded from the processed image. |
| 66 | +- [`BarcodeResultItem`]({{ site.dbr_maui_api }}barcode-result-item.html): The barcode decoding result of a single barcode. |
| 67 | + |
| 68 | +### Camera View |
| 69 | + |
| 70 | +[`CameraView`]({{ site.dce_maui_api }}auxiliary-api/dcecameraview.html) is a view class that design for visualizing the real time video streaming and the barcode decoding result. If the [`CameraEnhancer`]({{ site.dce_maui_api }}camera-enhancer.html) is set as the input of your CVR, the decoded barcodes will be highlighted automatically on the [`CameraView`]({{ site.dce_maui_api }}auxiliary-api/dcecameraview.html). |
0 commit comments