update for 0.39

shelllet · Sep 30, 2024 · 4bf41a6 · 4bf41a6
1 parent 5a17ff3
commit 4bf41a6
Show file tree

Hide file tree

Showing 16 changed files with 102 additions and 58 deletions.
diff --git a/docx/CHANGELOG.md b/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：

diff --git a/docx/_sidebar.md b/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)

diff --git a/docx/actions/algorithm/ColorPercentage.md b/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)。
 
 ## 其它
 

diff --git a/docx/actions/algorithm/ImageDifference.md b/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)。
 
 
 ## 其它

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

diff --git a/docx/actions/algorithm/RandomNumber.md b/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
+````
+!> 该动作被执行之后就会生成确定的随机数。所有引用该动作的运行参数，都会使用相同的随机数。
diff --git a/docx/actions/algorithm/RandomPoint.md b/docx/actions/algorithm/RandomPoint.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*脚本动作。
+!> 该动作被执行之后就会生成确定的随机坐标。其他所有引用该动作的运行参数,都会使用相同的随机坐标。
diff --git a/docx/actions/algorithm/images/05.png b/docx/actions/algorithm/images/05.png
diff --git a/docx/actions/detection/ImageColorDiscrimination.md b/docx/actions/detection/ImageColorDiscrimination.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
diff --git a/docx/actions/detection/images/09.png b/docx/actions/detection/images/09.png
diff --git a/docx/actions/system/StartProcess.md b/docx/actions/system/StartProcess.md
@@ -1,4 +1,4 @@
-# 启动应用程序
+# 启动应用
 
 启动应用程序,并等待程序结束。
 

diff --git a/docx/actions/window/EnumWindows.md b/docx/actions/window/EnumWindows.md
@@ -12,16 +12,18 @@
 ## 运行参数
 
 * [窗口](./types/Wnd.md)
-  > 如果不为空，则枚举相应的子窗口,否则，枚举所有的顶层窗口
+  > 如果不为空，则枚举相应的子窗口,否则，枚举所有的顶层窗口。
 * 标题
-> 根据窗口标题过滤
+> 根据窗口标题过滤，可为空，不执行过滤。
 * 类名
-> 根据窗口类名过滤
+> 根据窗口类名过滤，可为空，不执行过滤。
 
 * 排序
 > 参考 [WindowSortDirection](../enums/WindowSortDirection.md)
+
 * 异步处理子流程
-  > 开启线程处理每个枚举到的窗口
+  > 开启线程处理每个枚举到的窗口。
+  
 ## 输出
 
 > 窗口： [`Wnds`](./types/Wnd.md)    

diff --git a/docx/actions/window/FindWindow.md b/docx/actions/window/FindWindow.md
@@ -10,12 +10,14 @@
 
 ## 运行参数
 
-* [父窗口](./types/Wnd.md)
+* 父窗口
 > 默认为空，如果不为空，查找相应的子窗口，不为空，则查找当前系统所有的顶层窗口。可借助 *Spy++* 来辅助操作。
-* [标题](./types/String.md)
-> 窗口标题
-* [窗口类](./types/String.md)
-  > 窗口类名
+
+* 标题
+> 窗口标题，支持 [通配符匹配](./introduction/workflow/wildcard.md)。
+
+* 窗口类
+  > 窗口类名，支持 [通配符匹配](./introduction/workflow/wildcard.md)。
 
 ## 输出
 

diff --git a/docx/actions/window/images/10.png b/docx/actions/window/images/10.png
diff --git a/docx/enums/Colors.md b/docx/enums/Colors.md
@@ -0,0 +1,12 @@
+# Colors
+
+* BLACK
+> 黑色，*RGB* 颜色值（0, 0, 0）
+* WHITE
+> 白色，*RGB* 颜色值（255, 255, 255）
+* RED
+> 红色，*RGB* 颜色值（255, 0, 0）；*BGR* 颜色值（0, 0, 255）。
+* GREEN
+> 绿色，*RGB* 颜色值（0, 255, 0）
+* BLUE
+> 蓝色，*RGB* 颜色值（0, 0, 255）；*BGR* 颜色值（255, 0, 0）。