更新CameraX至v1.2.1

zxing-lite/src/main/java/com/king/zxing/DecodeConfig.java

@@ -12,11 +12,12 @@ import java.util.Map;
 
 import androidx.annotation.FloatRange;
 
-
 /**
  * 解码配置：主要用于在扫码识别时，提供一些配置，便于扩展。通过配置可决定内置分析器的能力，从而间接的控制并简化扫码识别的流程
  * <p></>
  * 设置解码 {@link #setHints(Map)}内置的一些解码可参见如下：
+ *
+ * @author <a href="mailto:jenly1314@gmail.com">Jenly</a>
  * @see {@link DecodeFormatManager#DEFAULT_HINTS}
  * @see {@link DecodeFormatManager#ALL_HINTS}
  * @see {@link DecodeFormatManager#CODE_128_HINTS}
@@ -24,7 +25,7 @@ import androidx.annotation.FloatRange;
  * @see {@link DecodeFormatManager#ONE_DIMENSIONAL_HINTS}
  * @see {@link DecodeFormatManager#TWO_DIMENSIONAL_HINTS}
  * @see {@link DecodeFormatManager#DEFAULT_HINTS}
- *
+ * <p>
  * 如果不满足您也可以通过{@link DecodeFormatManager#createDecodeHints(BarcodeFormat...)}自己配置支持的格式
  *
  * <p></>
@@ -32,18 +33,16 @@ import androidx.annotation.FloatRange;
  * {@link #setFullAreaScan(boolean)} 设置是否支持全区域扫码识别，优先级比识别区域高
  * {@link #setAnalyzeAreaRect(Rect)} 设置需要分析识别区域，优先级比识别区域比例高，当设置了指定的分析区域时，识别区域比例和识别区域偏移量相关参数都将无效
  * {@link #setAreaRectRatio(float)} 设置识别区域比例，默认{@link #DEFAULT_AREA_RECT_RATIO}，设置的比例最终会在预览区域裁剪基于此比例的一个矩形进行扫码识别，优先级最低
- *
+ * <p>
  * 因为{@link androidx.camera.view.PreviewView}的预览区域是经过裁剪的，所以这里的区域并不是用户所能预览到的区域，而是指Camera预览的真实区域，
  * 您还可以通过{@link CameraScan#setCameraConfig(CameraConfig)}去自定义配置{@link CameraConfig}的配置信息控制预览相关配置信息
- *
+ * <p>
  * 即判定区域分析的优先级顺序为:{@link #setFullAreaScan(boolean)} -> {@link #setAnalyzeAreaRect(Rect)} -> {@link #setAreaRectRatio(float)}
  * <p></>
- *
- * @author <a href="mailto:jenly1314@gmail.com">Jenly</a>
  */
 public class DecodeConfig {
 
-    private Map<DecodeHintType,Object> hints = DecodeFormatManager.DEFAULT_HINTS;
+    private Map<DecodeHintType, Object> hints = DecodeFormatManager.DEFAULT_HINTS;
 
     public static final float DEFAULT_AREA_RECT_RATIO = 0.8f;
 
@@ -92,7 +91,7 @@ public class DecodeConfig {
      */
     private int areaRectHorizontalOffset;
 
-    public DecodeConfig(){
+    public DecodeConfig() {
 
     }
 
@@ -102,9 +101,11 @@ public class DecodeConfig {
 
     /**
      * 设置解码
-     * @param hints {@link DecodeFormatManager}
      *
-     * 内置的一些解码可参见如下：
+     * @param hints {@link DecodeFormatManager}
+     *              <p>
+     *              内置的一些解码可参见如下：
+     * @return
      * @see {@link DecodeFormatManager#DEFAULT_HINTS}
      * @see {@link DecodeFormatManager#ALL_HINTS}
      * @see {@link DecodeFormatManager#CODE_128_HINTS}
@@ -112,10 +113,8 @@ public class DecodeConfig {
      * @see {@link DecodeFormatManager#ONE_DIMENSIONAL_HINTS}
      * @see {@link DecodeFormatManager#TWO_DIMENSIONAL_HINTS}
      * @see {@link DecodeFormatManager#DEFAULT_HINTS}
-     *
+     * <p>
      * 如果不满足您也可以通过{@link DecodeFormatManager#createDecodeHints(BarcodeFormat...)}自己配置支持的格式
-     *
-     * @return
      */
     public DecodeConfig setHints(Map<DecodeHintType, Object> hints) {
         this.hints = hints;
@@ -124,6 +123,7 @@ public class DecodeConfig {
 
     /**
      * 是否支持识别反色码，黑白颜色反转
+     *
      * @return
      */
     public boolean isSupportLuminanceInvert() {
@@ -132,6 +132,7 @@ public class DecodeConfig {
 
     /**
      * 设置是否支持识别反色码，黑白颜色反转
+     *
      * @param supportLuminanceInvert 默认为{@code false}，想要增强支持扫码识别反色码时可使用，相应的也会增加性能消耗。
      * @return
      */
@@ -142,6 +143,7 @@ public class DecodeConfig {
 
     /**
      * 是否支持扫垂直的条码
+     *
      * @return
      */
     public boolean isSupportVerticalCode() {
@@ -150,6 +152,7 @@ public class DecodeConfig {
 
     /**
      * 设置是否支持扫垂直的条码
+     *
      * @param supportVerticalCode 默认为{@code false}，想要增强支持扫码识别垂直的条码时可使用，相应的也会增加性能消耗。
      * @return
      */
@@ -160,6 +163,7 @@ public class DecodeConfig {
 
     /**
      * 是否支持使用多解码
+     *
      * @return
      */
     public boolean isMultiDecode() {
@@ -168,9 +172,10 @@ public class DecodeConfig {
 
     /**
      * 是否支持使用多解码
-     * @see {@link HybridBinarizer} , {@link GlobalHistogramBinarizer}
+     *
      * @param multiDecode 默认为{@code true}
      * @return
+     * @see {@link HybridBinarizer} , {@link GlobalHistogramBinarizer}
      */
     public DecodeConfig setMultiDecode(boolean multiDecode) {
         isMultiDecode = multiDecode;
@@ -178,7 +183,8 @@ public class DecodeConfig {
     }
 
     /**
-     *  是否支持识别反色码（条码黑白颜色反转的码）使用多解码
+     * 是否支持识别反色码（条码黑白颜色反转的码）使用多解码
+     *
      * @return
      */
     public boolean isSupportLuminanceInvertMultiDecode() {
@@ -187,9 +193,10 @@ public class DecodeConfig {
 
     /**
      * 设置是否支持识别反色码（条码黑白颜色反转的码）使用多解码
-     * @see {@link HybridBinarizer} , {@link GlobalHistogramBinarizer}
-     * @param supportLuminanceInvertMultiDecode  默认为{@code false}，想要增强支持扫码识别反色码时可使用，相应的也会增加性能消耗。
+     *
+     * @param supportLuminanceInvertMultiDecode 默认为{@code false}，想要增强支持扫码识别反色码时可使用，相应的也会增加性能消耗。
      * @return
+     * @see {@link HybridBinarizer} , {@link GlobalHistogramBinarizer}
      */
     public DecodeConfig setSupportLuminanceInvertMultiDecode(boolean supportLuminanceInvertMultiDecode) {
         isSupportLuminanceInvertMultiDecode = supportLuminanceInvertMultiDecode;
@@ -198,6 +205,7 @@ public class DecodeConfig {
 
     /**
      * 是否支持垂直的条码，使用多解码
+     *
      * @return
      */
     public boolean isSupportVerticalCodeMultiDecode() {
@@ -205,8 +213,8 @@ public class DecodeConfig {
     }
 
     /**
-     * 设置是否支持垂直的条码，使用多解码
-     * @see {@link HybridBinarizer} , {@link GlobalHistogramBinarizer}
+     * 设置是否支持垂直的条码，使用多解码；解码时，对应的二值化的实现： {@link HybridBinarizer} , {@link GlobalHistogramBinarizer}
+     *
      * @param supportVerticalCodeMultiDecode 默认为{@code false}，想要增强支持扫码识别垂直的条码时可使用，相应的也会增加性能消耗。
      * @return
      */
@@ -217,6 +225,7 @@ public class DecodeConfig {
 
     /**
      * 需要分析识别区域
+     *
      * @return
      */
     public Rect getAnalyzeAreaRect() {
@@ -225,18 +234,16 @@ public class DecodeConfig {
 
     /**
      * 设置需要分析识别区域，优先级比识别区域比例高，当设置了指定的分析区域时，识别区域比例和识别区域偏移量相关参数都将无效
-     * @param analyzeAreaRect
-     *
-     * 识别区域可设置的方式有如下几种：
-     * {@link #setFullAreaScan(boolean)} 设置是否支持全区域扫码识别，优先级比识别区域高
-     * {@link #setAnalyzeAreaRect(Rect)} 设置需要分析识别区域，优先级比识别区域比例高，当设置了指定的分析区域时，识别区域比例和识别区域偏移量相关参数都将无效
-     * {@link #setAreaRectRatio(float)} 设置识别区域比例，默认{@link #DEFAULT_AREA_RECT_RATIO}，设置的比例最终会在预览区域裁剪基于此比例的一个矩形进行扫码识别，优先级最低
-     *
-     * 因为{@link androidx.camera.view.PreviewView}的预览区域是经过裁剪的，所以这里的区域并不是用户所能预览到的区域，而是指Camera预览的真实区域，
-     * 您还可以通过{@link CameraScan#setCameraConfig(CameraConfig)}去自定义配置{@link CameraConfig}的配置信息控制预览相关配置信息
-     *
-     * 即判定区域分析的优先级顺序为:{@link #setFullAreaScan(boolean)} -> {@link #setAnalyzeAreaRect(Rect)} -> {@link #setAreaRectRatio(float)}
      *
+     * @param analyzeAreaRect 识别区域可设置的方式有如下几种：
+     *                        {@link #setFullAreaScan(boolean)} 设置是否支持全区域扫码识别，优先级比识别区域高
+     *                        {@link #setAnalyzeAreaRect(Rect)} 设置需要分析识别区域，优先级比识别区域比例高，当设置了指定的分析区域时，识别区域比例和识别区域偏移量相关参数都将无效
+     *                        {@link #setAreaRectRatio(float)} 设置识别区域比例，默认{@link #DEFAULT_AREA_RECT_RATIO}，设置的比例最终会在预览区域裁剪基于此比例的一个矩形进行扫码识别，优先级最低
+     *                        <p>
+     *                        因为{@link androidx.camera.view.PreviewView}的预览区域是经过裁剪的，所以这里的区域并不是用户所能预览到的区域，而是指Camera预览的真实区域，
+     *                        您还可以通过{@link CameraScan#setCameraConfig(CameraConfig)}去自定义配置{@link CameraConfig}的配置信息控制预览相关配置信息
+     *                        <p>
+     *                        即判定区域分析的优先级顺序为:{@link #setFullAreaScan(boolean)} -> {@link #setAnalyzeAreaRect(Rect)} -> {@link #setAreaRectRatio(float)}
      * @return
      */
     public DecodeConfig setAnalyzeAreaRect(Rect analyzeAreaRect) {
@@ -246,6 +253,7 @@ public class DecodeConfig {
 
     /**
      * 是否支持全区域扫码识别
+     *
      * @return
      */
     public boolean isFullAreaScan() {
@@ -254,17 +262,18 @@ public class DecodeConfig {
 
     /**
      * 设置是否支持全区域扫码识别，优先级比识别区域高
+     *
      * @param fullAreaScan 默认为{@code true}
-     *
-     * 识别区域可设置的方式有如下几种：
-     * {@link #setFullAreaScan(boolean)} 设置是否支持全区域扫码识别，优先级比识别区域高
-     * {@link #setAnalyzeAreaRect(Rect)} 设置需要分析识别区域，优先级比识别区域比例高，当设置了指定的分析区域时，识别区域比例和识别区域偏移量相关参数都将无效
-     * {@link #setAreaRectRatio(float)} 设置识别区域比例，默认{@link #DEFAULT_AREA_RECT_RATIO}，设置的比例最终会在预览区域裁剪基于此比例的一个矩形进行扫码识别，优先级最低
-     *
-     * 因为{@link androidx.camera.view.PreviewView}的预览区域是经过裁剪的，所以这里的区域并不是用户所能预览到的区域，而是指Camera预览的真实区域，
-     * 您还可以通过{@link CameraScan#setCameraConfig(CameraConfig)}去自定义配置{@link CameraConfig}的配置信息控制预览相关配置信息
-     *
-     * 即判定区域分析的优先级顺序为:{@link #setFullAreaScan(boolean)} -> {@link #setAnalyzeAreaRect(Rect)} -> {@link #setAreaRectRatio(float)}
+     *                     <p>
+     *                     识别区域可设置的方式有如下几种：
+     *                     {@link #setFullAreaScan(boolean)} 设置是否支持全区域扫码识别，优先级比识别区域高
+     *                     {@link #setAnalyzeAreaRect(Rect)} 设置需要分析识别区域，优先级比识别区域比例高，当设置了指定的分析区域时，识别区域比例和识别区域偏移量相关参数都将无效
+     *                     {@link #setAreaRectRatio(float)} 设置识别区域比例，默认{@link #DEFAULT_AREA_RECT_RATIO}，设置的比例最终会在预览区域裁剪基于此比例的一个矩形进行扫码识别，优先级最低
+     *                     <p>
+     *                     因为{@link androidx.camera.view.PreviewView}的预览区域是经过裁剪的，所以这里的区域并不是用户所能预览到的区域，而是指Camera预览的真实区域，
+     *                     您还可以通过{@link CameraScan#setCameraConfig(CameraConfig)}去自定义配置{@link CameraConfig}的配置信息控制预览相关配置信息
+     *                     <p>
+     *                     即判定区域分析的优先级顺序为:{@link #setFullAreaScan(boolean)} -> {@link #setAnalyzeAreaRect(Rect)} -> {@link #setAreaRectRatio(float)}
      * @return
      */
     public DecodeConfig setFullAreaScan(boolean fullAreaScan) {
@@ -274,6 +283,7 @@ public class DecodeConfig {
 
     /**
      * 识别区域比例，默认{@link #DEFAULT_AREA_RECT_RATIO}，设置的比例最终会在预览区域裁剪基于此比例的一个矩形进行扫码识别
+     *
      * @return
      */
     public float getAreaRectRatio() {
@@ -282,27 +292,26 @@ public class DecodeConfig {
 
     /**
      * 设置识别区域比例，默认{@link #DEFAULT_AREA_RECT_RATIO}，设置的比例最终会在预览区域裁剪基于此比例的一个矩形进行扫码识别，优先级最低
-     * @param areaRectRatio
-     *
-     * 识别区域可设置的方式有如下几种：
-     * {@link #setFullAreaScan(boolean)} 设置是否支持全区域扫码识别，优先级比识别区域高
-     * {@link #setAnalyzeAreaRect(Rect)} 设置需要分析识别区域，优先级比识别区域比例高，当设置了指定的分析区域时，识别区域比例和识别区域偏移量相关参数都将无效
-     * {@link #setAreaRectRatio(float)} 设置识别区域比例，默认{@link #DEFAULT_AREA_RECT_RATIO}，设置的比例最终会在预览区域裁剪基于此比例的一个矩形进行扫码识别，优先级最低
-     *
-     * 因为{@link androidx.camera.view.PreviewView}的预览区域是经过裁剪的，所以这里的区域并不是用户所能预览到的区域，而是指Camera预览的真实区域，
-     * 您还可以通过{@link CameraScan#setCameraConfig(CameraConfig)}去自定义配置{@link CameraConfig}的配置信息控制预览相关配置信息
-     *
-     * 即判定区域分析的优先级顺序为:{@link #setFullAreaScan(boolean)} -> {@link #setAnalyzeAreaRect(Rect)} -> {@link #setAreaRectRatio(float)}
      *
+     * @param areaRectRatio 识别区域可设置的方式有如下几种：
+     *                      {@link #setFullAreaScan(boolean)} 设置是否支持全区域扫码识别，优先级比识别区域高
+     *                      {@link #setAnalyzeAreaRect(Rect)} 设置需要分析识别区域，优先级比识别区域比例高，当设置了指定的分析区域时，识别区域比例和识别区域偏移量相关参数都将无效
+     *                      {@link #setAreaRectRatio(float)} 设置识别区域比例，默认{@link #DEFAULT_AREA_RECT_RATIO}，设置的比例最终会在预览区域裁剪基于此比例的一个矩形进行扫码识别，优先级最低
+     *                      <p>
+     *                      因为{@link androidx.camera.view.PreviewView}的预览区域是经过裁剪的，所以这里的区域并不是用户所能预览到的区域，而是指Camera预览的真实区域，
+     *                      您还可以通过{@link CameraScan#setCameraConfig(CameraConfig)}去自定义配置{@link CameraConfig}的配置信息控制预览相关配置信息
+     *                      <p>
+     *                      即判定区域分析的优先级顺序为:{@link #setFullAreaScan(boolean)} -> {@link #setAnalyzeAreaRect(Rect)} -> {@link #setAreaRectRatio(float)}
      * @return
      */
-    public DecodeConfig setAreaRectRatio(@FloatRange(from = 0.5,to = 1.0) float areaRectRatio) {
+    public DecodeConfig setAreaRectRatio(@FloatRange(from = 0.5, to = 1.0) float areaRectRatio) {
         this.areaRectRatio = areaRectRatio;
         return this;
     }
 
     /**
      * 识别区域垂直方向偏移量，支持负数，大于0时，居中心向下偏移，小于0时，居中心向上偏移
+     *
      * @return
      */
     public int getAreaRectVerticalOffset() {
@@ -311,6 +320,7 @@ public class DecodeConfig {
 
     /**
      * 设置识别区域垂直方向偏移量，支持负数，大于0时，居中心向下偏移，小于0时，居中心向上偏移
+     *
      * @param areaRectVerticalOffset
      * @return
      */
@@ -321,6 +331,7 @@ public class DecodeConfig {
 
     /**
      * 识别区域水平方向偏移量，支持负数，大于0时，居中心向右偏移，小于0时，居中心向左偏移
+     *
      * @return
      */
     public int getAreaRectHorizontalOffset() {
@@ -329,6 +340,7 @@ public class DecodeConfig {
 
     /**
      * 设置识别区域水平方向偏移量，支持负数，大于0时，居中心向右偏移，小于0时，居中心向左偏移
+     *
      * @param areaRectHorizontalOffset
      * @return
      */