Dev

docx/CHANGELOG.md

@@ -1,3 +1,16 @@
+# [0.39](https://github.com/shelllet/winui/compare/main...dev) (2024-09-30)
+
+### Changed：
+1. 修复动作分组隐藏问题。
+2. 修复一些其它崩溃问题。
+3. 调整部分 *UI* 界面。
+4. [颜色统计](./actions/algorithm/ColorPercentage.md)，运行时参数 *差值* 变更为 *HSV* 三个分量的差值。
+
+### Note
+
+1. 使用管理员权限运行 *winui++*, 无法显示 *动作* 的拖动效果（已知问题）。
+2. 64位下载(x64)：https://bitbucket.org/winui-release/version/downloads/winui0.39.0-setup.x64.exe
+
 # [0.38](https://github.com/shelllet/winui/compare/main...dev) (2024-09-06)
 
 ### Changed：

docx/_sidebar.md

@@ -21,7 +21,7 @@
   - [动作](./actions/README.md)
     - 系统
       - [等待](./actions/system/Wait.md)
-      - [启动应用程序](./actions/system/StartProcess.md)
+      - [启动应用](./actions/system/StartProcess.md)
       - [添加用户](./actions/system/UserAdd.md)
       - [打开应用](./actions/system/OpenApplication.md)
       - [打开文件](./actions/system/LaunchFile.md)
@@ -118,15 +118,16 @@
       - [特征匹配](./actions/detection/FeatureDetect.md)
       - [模板匹配](./actions/detection/MatchTemplate.md)
       - [查找轮廓](./actions/detection/FindContours.md)
+      - [颜色辨识](./actions/detection/ImageColorDiscrimination.md)
     - 绘图
       - [绘制矩形](./actions/draw/DrawRect.md)
       - [填充颜色](./actions/draw/FillColor.md)
     - 深度学习
-      - [目标分类](./actions/dnn/ImageClassification.md)
-      - [对象检测](./actions/dnn/ObjectDetection.md)
-      - [中文识别](./actions/dnn/TextChinese.md)
-      - [文本块检测](./actions/dnn/TextDetection.md)
-      - [二维码识别](./actions/dnn/QRCode.md)
+      - [目标分类](./actions/ai/ImageClassification.md)
+      - [对象检测](./actions/ai/ObjectDetection.md)
+      - [中文识别](./actions/ai/TextChinese.md)
+      - [文本块检测](./actions/ai/TextDetection.md)
+      - [二维码识别](./actions/ai/QRCode.md)
     - 媒体
       - [窗口截图](./actions/media/CaptureWindow.md)
       - [全屏截图](./actions/media/CaptureFullScreen.md)
@@ -227,7 +228,8 @@
       - [分组](./actions/control/GroupAction.md)
     - 算法
       - [分割字符串](./actions/algorithm/SplitString.md)
-      - [非零图像](./actions/algorithm/ImageIsColored.md)
+      - [合并字符串](./actions/algorithm/JoinString.md)
+      - [提取子串](./actions/algorithm/SubString.md)
       - [访问数组](./actions/algorithm/AccessArray.md)
       - [访问对象](./actions/algorithm/AccessKey.md)
       - [数组长度](./actions/algorithm/ArraySize.md)
@@ -238,12 +240,10 @@
       - [周长筛选](./actions/algorithm/FilterPerimeter.md)
       - [形状筛选](./actions/algorithm/FilterVertex.md)
       - [椭圆筛选](./actions/algorithm/FilterEllipse.md)
-      - [随机数](./actions/algorithm/RandomNumber.md)
+      - [随机数字](./actions/algorithm/RandomNumber.md)
       - [随机坐标](./actions/algorithm/RandomPoint.md)
       - [图像差值](./actions/algorithm/ImageDifference.md)
       - [颜色统计](./actions/algorithm/ColorPercentage.md)
-      - [合并字符串](./actions/algorithm/JoinString.md)
-      - [提取子串](./actions/algorithm/SubString.md)
       - [添加元素](./actions/algorithm/PushBack.md)
       - [删除元素](./actions/algorithm/PopBack.md)
     - 类型
@@ -286,7 +286,7 @@
     - [主机地址](./types/HostAddress.md)
     - [元组](./types/Tuple.md)
   - 枚举类型
-    - [ThresholdTypes](./enums/ThresholdTypes.md)
+    - [Colors](./enums/Colors.md)
     - [Directions](./enums/Directions.md)
     - [ColorConversionCodes](./enums/ColorConversionCodes.md)
     - [ContourShape](./enums/ContourShape.md)

docx/actions/dnn/TextChinese.md → docx/actions/ai/TextChinese.md

@@ -22,16 +22,7 @@
 
 ## 输出 
 
-> 识别结果, 参考 [`RecognitionResults`](./types/RecognitionResults.md)。
-
-
-## 脚本调用    
-
-```python
-import simple;
-
-
-```
+> 识别结果, 参考： [`RecognitionResults`](./types/RecognitionResult.md)。
 
 ### 其它
 

docx/actions/algorithm/AccessArray.md

@@ -13,7 +13,7 @@
 > 数组，包含多个元素的对象。
 
 * 索引，
-> 正值从前至后访问，负值从后至前访问。例如：*0* 可以访问第一个元素，*-1* 可以访问最后一个元素。
+> 正值从前至后访问，负值从后至前访问。索引从 *0* 开始。 例如：*0* 可以访问第一个元素，*-1* 可以访问最后一个元素。
 
 ## 输出
 

docx/actions/algorithm/CalculateCenter.md

@@ -10,8 +10,8 @@
 
 ## 运行参数
 
-* 值
-> 可计算中心坐标的数据。
+* 数据
+> 可计算中心坐标的数据，比如：[模板匹配](./actions/detection/MatchTemplate.md) 的输出结果。
 
 ## 输出
 

docx/actions/algorithm/ColorPercentage.md

@@ -1,5 +1,5 @@
 # 颜色统计 
-该动作可以统计某一颜色在图像当中所占的比例。
+该动作可以统计某一颜色在整个图像当中所占的比例。
 
 ![ColorPercentage](./images/04.png ':size=90%')
 
@@ -12,15 +12,22 @@
 ## 运行参数
 
 * 图像
-> 要进行颜色统计的图像，通常可以选择一个区域进行统计。
+> 要进行颜色统计的图像。
 * 颜色
->  所要统计的颜色。 由于 *HSV* 颜色空间更符合人的主观视觉感知, 通常使用 *HSV* 颜色空间。
-* 误差
-> 包含近似颜色的差值。
+>  所要统计的颜色。 由于 *HSV* 颜色空间更符合人的主观视觉感知, 通常使用 *HSV* 颜色空间执行颜色统计。
+
+* 色相差值
+> 包含近似颜色的色相差值，取值范围：`0 ~ 359`。当前颜色的 *H* 值 减去 最小值，当前颜色的 *H* 值 加上 最大值，作为 *色相* 的取值范围。
+
+* 饱和度差值
+> 包含近似颜色的饱和度差值，取值范围：`0 ~ 100`。当前颜色的 *S* 值 减去 最小值，当前颜色的 *S* 值 加上 最大值，作为 *饱和度* 的取值范围。
+
+* 亮度差值
+> 包含近似颜色的亮度范围，取值范围：`0 ~ 100`。当前颜色的 *V* 值 减去 最小值，当前颜色的 *V* 值 加上 最大值，作为 *亮度* 的取值范围。
 
 ## 输出
 
->   所要统计的颜色所占的百分比，参考：[Number](./types/Number.md)。
+>   所要统计的颜色在整个图像中所占的比例，`0 ~ 1` 之间的小数，参考：[Number](./types/Number.md)。
 
 ## 其它
 

docx/actions/algorithm/ConvertPoint.md

@@ -1,5 +1,5 @@
 # 坐标转换 
-窗口坐标转屏幕坐标，或者屏幕坐标转窗口坐标。
+*窗口坐标* 转 *屏幕坐标*，或者 *屏幕坐标* 转 *窗口坐标*。
 
 ![ConvertPoint](./images/10.png ':size=90%')
 
@@ -19,8 +19,8 @@
 * 方法
 > 坐标转换方法，参考：[PointConvertMethod](./enums/PointConvertMethod.md)。
 
-* 标题栏
-> 计算出来坐标是否包含标题栏的高度（前提是窗口有标题栏）。
+* 包含标题栏高度
+> 计算坐标时是否包含标题栏的高度（如果窗口含有标题栏）。通常情况，*Windows* 系统标准标题栏的高度为32px。
 
 ## 输出
 > 转换后的坐标，类型为：[`Point`](./types/Point.md)。

docx/actions/algorithm/FilterArea.md

@@ -1,5 +1,5 @@
 # 面积筛选
-通过计算数组中元素的面积来筛选列表中的元素。
+通过计算 *数组/列表* 中元素的面积来筛选 *数组/列表* 中的元素。
 
 
 ![FilterArea](./images/11.png ':size=90%')
@@ -12,14 +12,14 @@
 ## 运行参数
 
 
-* 值
-> 包含多个可以计算面积的元素列表，比如检测到的轮廓列表。
+* 数据
+> 包含多个可以计算面积的元素列表，比如： [查找轮廓](./actions/detection/FindContours.md)，检测到的轮廓列表。
 * 面积
 > 指定面积范围。
 
 ## 输出
 
-> 包含指定面积的元素列表。如果列表长度不为 `0`, 走左侧分支，否则走右侧分支。
+> 包含指定面积范围的元素列表。如果列表长度不为 `0`, 走左侧分支，否则走右侧分支。
 
 
 ### 其它

docx/actions/algorithm/FilterEllipse.md

@@ -1,5 +1,5 @@
 # 椭圆筛选 
-通过 *椭圆* 或 *圆* 的特征筛选列表中的元素。
+通过 *椭圆/圆* 的特征筛选 *椭圆/圆* *数组/列表* 中的符合条件元素。
 
 ![FilterEllipse](./images/13.png ':size=90%')
 
@@ -11,20 +11,21 @@
 ## 运行参数
 
 
-* 值
->  包含圆或者椭圆的数组： [`Ellipses`](./types/Ellipse.md)。
+* 数据
+>  包含圆或者椭圆的数组，类型：[`Ellipses`](./types/Ellipse.md)。比如动作：[椭圆检测](./actions/detection/EllipseDetection.md)。
 
 * 短轴
-> 短轴的范围，只有该范围内的椭圆或圆才会保留。 
+> 短轴的范围，只有该范围内的 *椭圆/圆* 才会保留。 
+
 * 长轴
-> 长轴的范围，只有该范围内的椭圆或圆才会保留。
+> 长轴的范围，只有该范围内的 *椭圆/圆* 才会保留。
 
 * 角度 
 
->   椭圆角度范围, 圆的角度始终为： *0*
+>   椭圆旋转角度范围, 圆的角度始终为： *0*。
 
 ## 输出
-> 筛选后的列表，参考：[`Ellipses`](./types/Ellipse.md)。如果列表长度不为 `0`, 走左侧分支，否则走右侧分支。
+> 筛选后的 *椭圆/圆* 列表，参考：[`Ellipses`](./types/Ellipse.md)。如果列表长度不为 `0`, 走左侧分支，否则走右侧分支。
 
 
 ## 其它

docx/actions/algorithm/FilterPerimeter.md

@@ -1,5 +1,5 @@
 # 周长筛选 
-计算数组中元素的周长，筛选符合条件的元素。
+通过计算 *数组/列表* 中元素的周长，筛选符合条件的元素。
 
 ![FilterPerimeter](./images/03.png ':size=90%')
 
@@ -9,14 +9,14 @@
 
 
 ## 运行参数
-* 值
-> 包含多个可以计算周长的元素列表，比如检测到的轮廓列表。
+* 数据
+> 包含多个可以计算周长的元素列表，比如： [查找轮廓](./actions/detection/FindContours.md)，检测到的轮廓列表。
 * 周长
 > 指定周长范围。
 
 
 ## 输出
-> 包含指定周长的元素列表。如果列表长度不为 `0`, 走左侧分支，否则走右侧分支。
+> 包含指定周长范围的元素列表。如果列表长度不为 `0`, 走左侧分支，否则走右侧分支。
 
 
 

docx/actions/algorithm/FilterText.md

@@ -1,5 +1,5 @@
 # 文本筛选
-在数组或者列表中，筛选包含指定文本元素。
+在数组或者列表中，筛选包含指定文本的元素。
 
 ![FilterText](./images/02.png ':size=90%')
 
@@ -9,8 +9,8 @@
 
 ## 运行参数
 
-* 值 
->   含有文本的列表，例如 *文字识别* 动作。
+* 数据 
+>   含有文本的列表，例如 [*文字识别*](./actions/ai/TextChinese.md) 动作。
 
 * 文本
 > 文本，*字符串* 类型，参考：[String](./types/String.md)， 支持 [*通配符（WildCard）*](./introduction/process/wildcard.md) 匹配。

docx/actions/algorithm/FilterVertex.md

@@ -1,5 +1,5 @@
 # 形状筛选
-通过计算数组中元素的形状来筛选列表中的元素。
+通过计算 *数组/列表* 中元素的形状是否近似指定的形状来筛选 *数组/列表* 中的元素。
 
 
 ![FilterVertex](./images/12.png ':size=90%')
@@ -12,9 +12,9 @@
 
 
 * 数据
-> 包含多个可以计算形状的元素列表，比如检测到的轮廓列表。
+> 包含多个可以计算形状的元素列表，比如： [查找轮廓](./actions/detection/FindContours.md)，检测到的轮廓列表。
 * 精度
-> 值越小，就越接近所选择的形状。
+> 值越小，就越接近所选择的形状，单位：像素。这是原始曲线与其近似值之间的最大距离。默认值 *3px*。
 * 形状
 > 参考：[Shape](./enums/ContourShape.md)。
 

docx/actions/algorithm/ImageDifference.md

@@ -1,7 +1,7 @@
 # 图像差值 
-这个动作可以比较两个图像，并返回一个显示相似性的度量。结果越低，匹配越好。即使图像旋转、缩放也不会对该比较产生太大影响。
+这个动作可以比较两个图像，并返回一个显示相似性的度量。结果越低，匹配越好。即使图像旋转、缩放也不会对该比较结果产生太大影响。
 
-* 为了获得更高的准确性，请使用二值图像
+* 为了获得更高的准确性，请使用二值图像。
 * 要找到的对象应该是白色的，背景应该是黑色的。
 
 ![ImageDifference](./images/15.png ':size=90%')
@@ -19,7 +19,7 @@
 
 ## 输出
 
-> 相似性的指标（小数）。越低，表示匹配越好。*0*：表示完全匹配，参考： [Number](./types/Number.md)
+> 相似性的指标（小数）。越低，表示匹配越好。如果是 *0*，表示完全匹配，类型参考： [Number](./types/Number.md)。
 
 
 ## 其它

docx/actions/algorithm/JoinString.md

@@ -1,5 +1,5 @@
 # 合并字符串 
-将字符串列表，或者含有字符串的列表（文本检测），合并成字符串。
+将字符串列表，或者含有字符串的列表（如 [文本检测](./actions/ai/TextChinese.md)），合并成字符串。
 
 ![JoinString](./images/16.png ':size=90%')
 
@@ -17,7 +17,7 @@
 
 ## 输出
 
-> 字符串列表，参考：[Strings](./types/String.md)
+> 字符串，参考：[String](./types/String.md)
 
 
 ## 其它

docx/actions/algorithm/PopBack.md

@@ -1,5 +1,5 @@
 # 删除元素 
-删除容器中的最后一个元素。
+删除容器当中的最后一个元素。
 
 ![PopBack](./images/20.png ':size=90%')
 

docx/actions/algorithm/RandomNumber.md

@@ -1,5 +1,5 @@
-# 随机数 
-生成随机数。
+# 随机数字
+生成一个随机数字。
 
 
 ![RandomNumber](./images/01.png ':size=90%')
@@ -10,11 +10,8 @@
 
 ## 运行参数
 
-* 最小值
->
-
-* 最大值
->
+* 范围
+> 生成随机数的范围。
 
 ## 输出
 
@@ -25,5 +22,12 @@
 
 示例：https://github.com/shelllet/WinUi/blob/main/algorithm/random_num.simple
 
+## 脚本
+
+````
+import random
+
+random.randint(1, 100)
 
-!> 该动作被执行之后就会生成确定的随机数。其他所有引用该动作的运行参数,都会是相同的值。如果想使用不同的随机数值，请创建多个*随机数*动作，或者使用*Python* 表达式：https://learnku.com/docs/pymotw/random-pseudorandom-number-generators/3387
+````
+!> 该动作被执行之后就会生成确定的随机数。所有引用该动作的运行参数，都会使用相同的随机数。