update for 0.39

Author: shelllet

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,6 +118,7 @@
       - [特征匹配](./actions/detection/FeatureDetect.md)
       - [模板匹配](./actions/detection/MatchTemplate.md)
       - [查找轮廓](./actions/detection/FindContours.md)
+      - [颜色辨识](./actions/detection/ImageColorDiscrimination.md)
     - 绘图
       - [绘制矩形](./actions/draw/DrawRect.md)
       - [填充颜色](./actions/draw/FillColor.md)
@@ -239,11 +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/ImageIsColored.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/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/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/ImageIsColored.md

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

docx/actions/algorithm/PopBack.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
+````
+!> 该动作被执行之后就会生成确定的随机数。所有引用该动作的运行参数，都会使用相同的随机数。

docx/actions/algorithm/RandomNumber.md

@@ -1,5 +1,5 @@
 # 随机坐标 
-生成随机坐标。
+生成随机坐标位置。
 
 ![RandomPoint](./images/14.png ':size=90%')
 
@@ -12,7 +12,7 @@
 * 中心坐标
 >   参考： [Point](./types/Point.md)：
 * 半径
-> 参考： [Number](./types/Number.md)：
+> 指定一个半径，可以生成一个以中心坐标为圆心，该半径范围内的一个随机位置。 参考： [Number](./types/Number.md)：
 
 ## 输出
 
@@ -24,4 +24,4 @@
 示例：https://github.com/shelllet/WinUi/blob/main/algorithm/RandomPoint.simple
 
 
-!> 该动作被执行之后就会生成确定的随机坐标。其他所有引用该动作的运行参数,都会是相同的值。如果想使用不同的随机坐标，请创建多个*随机坐标*动作，或者使用*Python*脚本动作。
+!> 该动作被执行之后就会生成确定的随机坐标。其他所有引用该动作的运行参数,都会使用相同的随机坐标。

docx/actions/algorithm/RandomPoint.md

@@ -0,0 +1,27 @@
+# 颜色辨识
+
+辨别图像的颜色是否为指定颜色。
+
+![ImageColorDiscrimination](./images/09.png ':size=90%')
+
+## 子流程
+
+> 不支持
+
+## 运行参数
+
+* 图像
+> 待辨识的图像，一般使用纯色图像辨识。
+
+* 颜色
+> 参考：[Colors](./enums/Colors.md)。注意：`RED`(红色) 和 `BLUE`(蓝色)使用 *BGR* 颜色模式。
+
+## 输出
+
+> 参考：[Boolean](./types/Boolean.md)， 图像符合指定的颜色走左边分支流程，否则走右边流程分支。
+
+
+
+## 其它
+
+示例： https://github.com/shelllet/WinUi/blob/main/algorithm/ImageIsColored.simple