Merge pull request #22 from ZoroWang/master

Update to 7.6

Author: yushulx

README.md

@@ -13,6 +13,7 @@
 - [Supported Python Version](#supported-python-version)
 - [Supported Platforms](#supported-platforms)
 - [Installation](#installation)
+- [License](#license)
 - [Supported Symbologies](#supported-symbologies)
 - [Release Notes](#release-notes)
 - [Interfaces](#interfaces)
@@ -26,16 +27,14 @@
 - [Contact Us](#contact-us)
 
 ### Version
-- **7.5**
+- **7.6**
 
 ### Supported Platforms
 - **Windows x64**
 
-- **Linux**
+- **Linux(x64, ARM32, ARM64)**
 
-- **Mac OS**
-
-- **Raspberry Pi OS**
+- **macOS**
 
 ### Supported Python Versions
 
@@ -49,6 +48,10 @@
 
 >**pip install dbr**
 
+### License
+
+Apply for a trial license: https://www.dynamsoft.com/CustomerPortal/Portal/Triallicense.aspx
+
 ### Supported Symbologies
 *We support all major barcodes symbologies across a variety of industries such as government, finance, retail, warehouse inventory, and healthcare.*
 
@@ -727,43 +730,45 @@ Describes the text result order mode.
 
 ***Attributes*** :
 
-	- data_type                     : The data type of the intermediate result
-	- results                       : One of the following types: List of class Contour, List of class ImageData, List of class LineSegment, List of class LocalizationResult, List of class RegionOfInterest, List of class Quadrilateral
-	- result_type                   : Intermediate result type
-	- barcode_complement_mode       : The BarcodeComplementMode used when generating the current intermediate result
-	- bcm_index                     : The list index of current used ColourClusteringMode in the ColourClusteringModes setting
-	- deformation_resisting_mode    : The DeformationResistingMode used when generating the current intermediate result
-	- drm_index                     : The list index of current used DeformationResistingMode in the DeformationResistingModes setting
-	- dpm_code_reading_mode         : The DPMCodeReadingMode used when generating the current intermediate result
-	- dpmcrm_index                  : The list index of current used DPMCodeReadingMode in the DPMCodeReadingModes setting
-	- text_filter_mode              : The TextFilterMode used when generating the current intermediate result
-	- tfm_index                     : The list index of current used TextFilterMode in the TextFilterModes setting
-	- localization_mode             : The LocalizationMode used when generating the current intermediate result
-	- lm_index                      : The list index of current used LocalizationMode in the LocalizationModes setting
-	- binarization_mode             : The BinarizationMode used when generating the current intermediate result
-	- bm_index                      : The list index of current used BinarizationMode in the BinarizationModes setting
-	- image_preprocessing_mode      : The ImagePreprocessingMode used when generating the current intermediate result
-	- ipm_index                     : The list index of current used ImagePreprocessingMode in the ImagePreprocessingModes setting
-	- region_predetection_mode      : The RegionPredetectionMode used when generating the current intermediate result
-	- rpm_index                     : The list index of current used RegionPredetectionMode in the RegionPredetectionModes setting
-	- grayscale_transformation_mode : The GrayscaleTransformationMode used when generating the current intermediate result
-	- gtm_index                     : The list index of current used GrayscaleTransformationMode in the GrayscaleTransformationModes setting
-	- colour_conversion_mode        : The ColourConversionMode used when generating the current intermediate result
-	- cicm_index                    : The list index of current used ColourConversionMode in the ColourConversionModes setting
-	- colour_clustering_mode        : The ColourClusteringMode used when generating the current intermediate result
-	- ccm_index                     : The list index of current used ColourClusteringMode in the ColourClusteringModes setting
-	- rotation_matrix               : The rotation matrix
-	- roi_id                        : The ID of the ROI (Region Of Interest) generated by the SDK. -1 means the original image.
-	- scale_down_ratio              : The scale down ratio
-	- frame_id                      : The ID of the operated frame
+- data_type                     : The data type of the intermediate result
+- results                       : One of the following types: List of class Contour, List of class ImageData, List of class LineSegment, List of class LocalizationResult, List of class RegionOfInterest, List of class Quadrilateral
+- result_type                   : Intermediate result type
+- barcode_complement_mode       : The BarcodeComplementMode used when generating the current intermediate result
+- bcm_index                     : The list index of current used ColourClusteringMode in the ColourClusteringModes setting
+- deformation_resisting_mode    : The DeformationResistingMode used when generating the current intermediate result
+- drm_index                     : The list index of current used DeformationResistingMode in the DeformationResistingModes setting
+- dpm_code_reading_mode         : The DPMCodeReadingMode used when generating the current intermediate result
+- dpmcrm_index                  : The list index of current used DPMCodeReadingMode in the DPMCodeReadingModes setting
+- text_filter_mode              : The TextFilterMode used when generating the current intermediate result
+- tfm_index                     : The list index of current used TextFilterMode in the TextFilterModes setting
+- localization_mode             : The LocalizationMode used when generating the current intermediate result
+- lm_index                      : The list index of current used LocalizationMode in the LocalizationModes setting
+- binarization_mode             : The BinarizationMode used when generating the current intermediate result
+- bm_index                      : The list index of current used BinarizationMode in the BinarizationModes setting
+- image_preprocessing_mode      : The ImagePreprocessingMode used when generating the current intermediate result
+- ipm_index                     : The list index of current used ImagePreprocessingMode in the ImagePreprocessingModes setting
+- region_predetection_mode      : The RegionPredetectionMode used when generating the current intermediate result
+- rpm_index                     : The list index of current used RegionPredetectionMode in the RegionPredetectionModes setting
+- grayscale_transformation_mode : The GrayscaleTransformationMode used when generating the current intermediate result
+- gtm_index                     : The list index of current used GrayscaleTransformationMode in the GrayscaleTransformationModes setting
+- colour_conversion_mode        : The ColourConversionMode used when generating the current intermediate result
+- cicm_index                    : The list index of current used ColourConversionMode in the ColourConversionModes setting
+- colour_clustering_mode        : The ColourClusteringMode used when generating the current intermediate result
+- ccm_index                     : The list index of current used ColourClusteringMode in the ColourClusteringModes setting
+- rotation_matrix               : The rotation matrix
+- roi_id                        : The ID of the ROI (Region Of Interest) generated by the SDK. -1 means the original image.
+- scale_down_ratio              : The scale down ratio
+- frame_id                      : The ID of the operated frame
+- rpm_colour_argument_index     : The index of ForeAndBackgroundColour argument used for RegionPredetectionMode
 
 
 #### Exception Class Interface
 - **BarcodeReaderError**
 
 #### Main Class Interface
 - **BarcodeReader** : Defines a class that provides functions for decoding barcodes in images. This is the main interface for recognizing barcodes.
-	- ***Attributes*** :
+
+	- ***Attributes***:
 
 		- version     : The Dynamsoft Barcode Reader - Python Edition version
 		- dbr_version : The Dynamsoft Barcode Reader version
@@ -877,6 +882,17 @@ Describes the text result order mode.
 			- @return text_results      <list[class TextResult]> : All text results.
 			- @exception BarcodeReaderError
 
+		- decode_buffer_manually(self, buffer, width, height, stride, image_pixel_format, template_name="")
+			- @description Decodes barcodes from the memory buffer containing image pixels in defined format.
+			- @param buffer <bytes or bytearray> : The array of bytes which contain the image data.
+			- @param width  <int> : The width of the image in pixels.
+			- @param height <int> : The height of the image in pixels.
+			- @param stride <int> : The stride (or scan width) of the image.
+			- @param image_pixel_format <EnumImagePixelFormat> : The image pixel format used in the image byte array.
+			- @param template_name(optional) <str> : The template name.
+			- @return text_results <list[class TextResult]> : All text results.
+			- @exception BarcodeReaderError : If error happens, this function will throw a BarcodeReaderError exception that can report the detailed error message.
+
 		- decode_file_stream(file_stream, template_name="")
 			- @description Decodes barcodes from an image file in memory.
 			- @param file_stream <bytearray> : The image file bytes in memory.
@@ -910,7 +926,7 @@ Describes the text result order mode.
 		- get_length_of_frame_queue()
 			- @description Gets current length of the inner frame queue.
 			- @return frame_queue_length <int> : The length of the inner frame queue.
-	```
+
 
 ### Appendix