【机器视觉】 dev_open_tool算子

Dear 丶 2022-10-07 10:59 184阅读 0赞

## 00. 目录 ##

### 文章目录 ###

*   *  00. 目录
     *  01. 概述
     *  02. 签名
     *  03. 描述
     *  04. 注意
     *  05. 参数
     *  06. 结果
     *  07. 附录

## 01. 概述 ##

dev\_open\_tool - 打开HDevelop工具，非模态对话框或助手。

## 02. 签名 ##

`dev_open_tool( : : ToolName, Row, Column, Width, Height, GenParamName, GenParamValue : ToolId)`

## 03. 描述 ##

dev\_open\_tool打开一个HDevelop工具，一个非模态对话框或者助手。 参数ToolName含有要打开的工具的名称。 这个算子返回刚创建的工具的ToolId，这个ToolId可以使用像dev\_set\_tool\_geometry，dev\_show\_tool，dev\_close\_tool这样的算子用于寻址一个特定的工具。 打开的工具会自动激活。

对于ToolName为’halcon\_news’，返回一个空的ToolId，因为这只是查看新闻网页页面。

通过GenParamNames和GenParamValues，可以指定显示哪个页面和更多功能，功能见下文。 GenParamNames和GenParamValues是可选的。 如果它们设置为\[\]，则工具将以默认设置打开。

此算子可以支持以下工具：

<table> 
 <thead> 
  <tr> 
   <th>ToolName</th> 
   <th>Main Windows</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>‘graphics_window’</td> 
   <td>图形窗口</td> 
  </tr> 
  <tr> 
   <td>‘operator_window’</td> 
   <td>算子窗口</td> 
  </tr> 
  <tr> 
   <td>‘program_listing’</td> 
   <td>程序列表</td> 
  </tr> 
  <tr> 
   <td>‘variable_view’</td> 
   <td>变量窗口</td> 
  </tr> 
 </tbody> 
</table>

<table> 
 <thead> 
  <tr> 
   <th>ToolName</th> 
   <th>Assistants</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>‘calibration_assistant’</td> 
   <td>相机标定助手</td> 
  </tr> 
  <tr> 
   <td>‘image_acquisition_assistant’</td> 
   <td>图像采集助手</td> 
  </tr> 
  <tr> 
   <td>‘matching_assistant’</td> 
   <td>匹配助手</td> 
  </tr> 
  <tr> 
   <td>‘measure1d_assistant’</td> 
   <td>一维测量助手</td> 
  </tr> 
  <tr> 
   <td>‘ocr_assistant’</td> 
   <td>OCR助手</td> 
  </tr> 
 </tbody> 
</table>

<table> 
 <thead> 
  <tr> 
   <th>ToolName</th> 
   <th>Tools</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>‘call_stack’</td> 
   <td>调用堆栈</td> 
  </tr> 
  <tr> 
   <td>‘feature_histogram’</td> 
   <td>特征直方图</td> 
  </tr> 
  <tr> 
   <td>‘feature_inspection’</td> 
   <td>特征检测</td> 
  </tr> 
  <tr> 
   <td>‘gray_histogram’</td> 
   <td>灰度直方图</td> 
  </tr> 
  <tr> 
   <td>‘line_profile’</td> 
   <td>轮廓线</td> 
  </tr> 
  <tr> 
   <td>‘zoom_window’</td> 
   <td>缩放窗口</td> 
  </tr> 
  <tr> 
   <td>‘ocr_training_file_browser’</td> 
   <td>OCR训练文件浏览器</td> 
  </tr> 
 </tbody> 
</table>

<table> 
 <thead> 
  <tr> 
   <th>ToolName</th> 
   <th>Dialogs</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>‘browse_examples_dialog’</td> 
   <td>浏览示例对话框</td> 
  </tr> 
  <tr> 
   <td>‘create_procedure_dialog’</td> 
   <td>创建程序对话框</td> 
  </tr> 
  <tr> 
   <td>‘edit_procedure_interface_dialog’</td> 
   <td>编辑程序接口对话框</td> 
  </tr> 
  <tr> 
   <td>‘find_replace_dialog’</td> 
   <td>查找替换对话框</td> 
  </tr> 
  <tr> 
   <td>‘output_console’</td> 
   <td>输出控制台</td> 
  </tr> 
  <tr> 
   <td>‘program_line_view’</td> 
   <td>程序行视图</td> 
  </tr> 
  <tr> 
   <td>‘breakpoints_dialog’</td> 
   <td>程序行视图/断点</td> 
  </tr> 
  <tr> 
   <td>‘bookmarks_dialog’</td> 
   <td>程序行视图/书签</td> 
  </tr> 
  <tr> 
   <td>‘invalid_lines_dialog’</td> 
   <td>程序行视图/无效行</td> 
  </tr> 
  <tr> 
   <td>‘visualization_parameters_dialog’</td> 
   <td>可视化参数对话框</td> 
  </tr> 
  <tr> 
   <td>‘help’</td> 
   <td>帮助浏览器</td> 
  </tr> 
  <tr> 
   <td>‘preferences’</td> 
   <td>参数对话框</td> 
  </tr> 
  <tr> 
   <td>‘halcon_news’</td> 
   <td>HALCON新闻网站</td> 
  </tr> 
 </tbody> 
</table>

以下工具可用GenParamNames和GenParamValues来设置更多细节：

**’calibration\_assistant’ - 相机标定助手：**

*‘page’:*

要显示的页面。

<table> 
 <thead> 
  <tr> 
   <th>Value</th> 
   <th>Page</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>‘setup’</td> 
   <td>安装</td> 
  </tr> 
  <tr> 
   <td>‘calibration’</td> 
   <td>标定</td> 
  </tr> 
  <tr> 
   <td>‘results’</td> 
   <td>结果</td> 
  </tr> 
  <tr> 
   <td>‘code_generation’</td> 
   <td>代码生成</td> 
  </tr> 
 </tbody> 
</table>

例如：dev\_open\_tool（‘calibration\_assistant’，…，‘page’，‘results’，…）打开标定助手并显示结果标签卡。

**’image\_acquisition\_assistant’ - 图像采集助手：**

*‘page’:*

要显示的页面。

<table> 
 <thead> 
  <tr> 
   <th>Value</th> 
   <th>Page</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>‘source’</td> 
   <td>资源</td> 
  </tr> 
  <tr> 
   <td>‘connection’</td> 
   <td>连接</td> 
  </tr> 
  <tr> 
   <td>‘parameters’</td> 
   <td>参数</td> 
  </tr> 
  <tr> 
   <td>‘code_generation’</td> 
   <td>代码生成</td> 
  </tr> 
 </tbody> 
</table>

例如：dev\_open\_tool（‘image\_acquisition’，…，‘page’，‘source’，…）打开图像采集助手并显示资源页面。

**’matching\_assistant’ - 匹配助手：**

*‘page’:*

要显示的页面。

<table> 
 <thead> 
  <tr> 
   <th>Value</th> 
   <th>Page</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>‘model_creation’</td> 
   <td>创建</td> 
  </tr> 
  <tr> 
   <td>‘model_parameter’</td> 
   <td>参数</td> 
  </tr> 
  <tr> 
   <td>‘model_use’</td> 
   <td>应用</td> 
  </tr> 
  <tr> 
   <td>‘inspect’</td> 
   <td>检测</td> 
  </tr> 
  <tr> 
   <td>‘code_generation’</td> 
   <td>代码生成</td> 
  </tr> 
 </tbody> 
</table>

例如：dev\_open\_tool（‘matching\_assistant’，…，‘page’，‘inspect’，…）打开匹配助手并显示”检测"标签卡。

**’measure1d\_assistant’ - 测量助手：**

*‘page’:*

要显示的页面。

<table> 
 <thead> 
  <tr> 
   <th>Value</th> 
   <th>Page</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>‘input’</td> 
   <td>输入</td> 
  </tr> 
  <tr> 
   <td>‘edges’</td> 
   <td>边缘</td> 
  </tr> 
  <tr> 
   <td>‘fuzzy’</td> 
   <td>模糊</td> 
  </tr> 
  <tr> 
   <td>‘results’</td> 
   <td>结果</td> 
  </tr> 
  <tr> 
   <td>‘code_generation’</td> 
   <td>代码生成</td> 
  </tr> 
 </tbody> 
</table>

例如：dev\_open\_tool（‘measure1d\_assistant’，…，‘page’，‘edges’，…）打开测量助手并显示“边缘”标签卡。

**’program\_line\_view’： - 程序行视图对话框**

*“page”:*

要显示的页面。

<table> 
 <thead> 
  <tr> 
   <th>Value</th> 
   <th>Page</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>‘invalid_lines’</td> 
   <td>无效行</td> 
  </tr> 
  <tr> 
   <td>‘find_all’</td> 
   <td>查找所有</td> 
  </tr> 
  <tr> 
   <td>‘breakpoints’</td> 
   <td>断点</td> 
  </tr> 
  <tr> 
   <td>‘bookmarks’</td> 
   <td>书签</td> 
  </tr> 
 </tbody> 
</table>

例如：dev\_open\_tool（‘program\_line\_view’，…，‘page’，‘breakpoints’，…）打开程序行视图对话框，并显示“断点”标签卡。

**’help’ - 帮助浏览器：**

GenParamNames的可能条目是’page’，‘operator’，‘manual’。

*“page”:*

要显示的页面。

<table> 
 <thead> 
  <tr> 
   <th>Value</th> 
   <th>Page</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>‘contents’</td> 
   <td>目录</td> 
  </tr> 
  <tr> 
   <td>‘operator’</td> 
   <td>算子</td> 
  </tr> 
  <tr> 
   <td>‘search’</td> 
   <td>搜索</td> 
  </tr> 
  <tr> 
   <td>‘index’</td> 
   <td>Index</td> 
  </tr> 
  <tr> 
   <td>‘bookmarks’</td> 
   <td>书签</td> 
  </tr> 
 </tbody> 
</table>

例如：dev\_open\_tool（‘help’，…，‘page’，‘search’，…）打开帮助工具并选择“搜索”标签卡。

*“operator”:*

要显示哪个算子的html界面。

例如：dev\_open\_tool（‘help’，…，’\[‘page’，‘operator’\]，\[‘search’，‘read\_image’\] …）打开帮助工具，选择搜索标签卡并显示算子read\_image的介绍。

*“manual”:*

手动显示哪个html界面。

**’preferences’ - 首选项对话框：**

*“page”:*

其中要显示的页面是两个值的组合。 一个组的选择和该组中的选项卡。 这两个值必须用“/”分隔。如下面的例子。

例如：dev\_open\_tool（‘preferences’，…，‘page’，‘user\_interface / language’，…）显示来自组“user\_interface”的页面“language”。

可能的组是：

<table> 
 <thead> 
  <tr> 
   <th>Value</th> 
   <th>Group</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>‘user_interface’</td> 
   <td>用户接口</td> 
  </tr> 
  <tr> 
   <td>‘procedures’</td> 
   <td>函数</td> 
  </tr> 
  <tr> 
   <td>‘general_options’</td> 
   <td>一般属性</td> 
  </tr> 
  <tr> 
   <td>‘visualization_settings’</td> 
   <td>可视化设置</td> 
  </tr> 
  <tr> 
   <td>‘runtime_settings’</td> 
   <td>运行时设置</td> 
  </tr> 
 </tbody> 
</table>

*‘user\_interface’:*

要显示的组。

<table> 
 <thead> 
  <tr> 
   <th>Value</th> 
   <th>Page</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>‘user_interface/program_listing’</td> 
   <td>程序列表</td> 
  </tr> 
  <tr> 
   <td>‘user_interface/fonts’</td> 
   <td>字体</td> 
  </tr> 
  <tr> 
   <td>‘user_interface/language’</td> 
   <td>语言</td> 
  </tr> 
  <tr> 
   <td>‘user_interface/layout’</td> 
   <td>布局</td> 
  </tr> 
 </tbody> 
</table>

*‘procedure’:*

要显示的组

<table> 
 <thead> 
  <tr> 
   <th>Value</th> 
   <th>Page</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>‘procedures/directories’</td> 
   <td>目录</td> 
  </tr> 
  <tr> 
   <td>‘procedures/external_procedures’</td> 
   <td>外部函数</td> 
  </tr> 
  <tr> 
   <td>‘procedures/manage_procedure_libraries’</td> 
   <td>管理函数库</td> 
  </tr> 
  <tr> 
   <td>‘procedures/manage_passwords’</td> 
   <td>管理密码</td> 
  </tr> 
  <tr> 
   <td>‘procedures/procedure_use’</td> 
   <td>函数使用</td> 
  </tr> 
  <tr> 
   <td>‘procedures/unresolved_procedure_calls’</td> 
   <td>未实现的函数调用</td> 
  </tr> 
 </tbody> 
</table>

*‘general\_options’:*

要显示的组。

<table> 
 <thead> 
  <tr> 
   <th>Page</th> 
   <th>Value</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>‘general_options/general_options’</td> 
   <td>一般选项</td> 
  </tr> 
  <tr> 
   <td>‘general_options/experienced_user’</td> 
   <td>高级用户</td> 
  </tr> 
 </tbody> 
</table>

*‘visualization\_settings’:*

要显示的组。

<table> 
 <thead> 
  <tr> 
   <th>Value</th> 
   <th>Page</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>‘visualization_settings/pen’</td> 
   <td>画笔</td> 
  </tr> 
  <tr> 
   <td>‘visualization_settings/lut’</td> 
   <td>查找表</td> 
  </tr> 
  <tr> 
   <td>‘visualization_settings/paint’</td> 
   <td>显示</td> 
  </tr> 
 </tbody> 
</table>

*‘runtime\_settings’：*

要显示的组。

<table> 
 <thead> 
  <tr> 
   <th>Value</th> 
   <th>Page</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>‘runtime_settings/runtime_settings’</td> 
   <td>运行设置</td> 
  </tr> 
  <tr> 
   <td>‘runtime_settings/override_operator_behavior’</td> 
   <td>重载算子行为</td> 
  </tr> 
 </tbody> 
</table>

Row和Column参数可用于设置打开工具的位置。 为了提供标准行为，即通常打开工具的最后一个位置，可以设置为“default”。

参数Width和Height用于打开设置特定的尺寸的tool。如果提供标准行为，即通常以最后打开工具的尺寸，可以通过“default”。 如果Width和Height小于tool的最小尺寸，则使用tool的最小尺寸。

通过按窗口框的关闭按钮或通过调用dev\_close\_tool来关闭该tool。

**原文描述**：

dev\_open\_tool opens a HDevelop tool, a non-modal dialog, or assistant. The parameter ToolName contains the name of the tool which should be opened. This operator returns the ToolId of the newly created tool, which can be used by operators like dev\_set\_tool\_geometry, dev\_show\_tool, dev\_close\_tool to address a specific tool. The opened tool automatically becomes active.

For the ToolName.‘halcon\_news’ an empty ToolId is returned, because this simply should view the news page.

With GenParamName and GenParamValue it can be specified which page is displayed and more. See below. The use of GenParamName and GenParamValue is optional. If they are set to \[\] the tool opens with default settings.

The parameters Row and Column can be used to open the tool at a specific position. In order to apply the standard behavior, that is in general opening the tool at the last position, ‘default’ can be passed.

The parameters Width and Height can be used to open the tool with a specific size. In order to apply the standard behavior, that is in general opening the tool with the last size, ‘default’ can be passed. If Width and Height are less than the minimum size of the tool the minimum size is used.

The tool is closed by pressing the Close button of the window frame, or by calling dev\_close\_tool.

## 04. 注意 ##

此算子不支持代码导出

## 05. 参数 ##

**ToolName (input\_control) string → (string)**  
　　要打开的tool的名称和tool的其他参数。

**Row (input\_control) rectangle.origin.y → (integer / string)**  
　　工具左上角坐标的行索引。  
　　Default value: ‘default’  
　　Minimum increment: 1  
　　Recommended increment: 1

**Column (input\_control) rectangle.origin.x → (integer / string)**  
　　工具左上角坐标的列索引。  
　　Default value: ‘default’  
　　Minimum increment: 1  
　　Recommended increment: 1

**Width (input\_control) rectangle.extent.x → (integer / string)**  
　　tool的宽度。  
　　Default value: ‘default’  
　　Minimum increment: 1  
　　Recommended increment: 1  
　　Restriction: Width > 0

**Height (input\_control) rectangle.extent.y → (integer / string)**  
　　tool的高度。  
　　Default value: ‘default’  
　　Minimum increment: 1  
　　Recommended increment: 1  
　　Restriction: Height > 0

**GenParamNames (input\_control) attribute.name(-array) → (string)**  
　　通用参数的名称。  
　　Default value: \[\]

**GenParamValues (input\_control) attribute.value(-array) → (string)**  
　　通用参数的值。  
　　Default value: \[\]

**ToolId (output\_control) dev\_tool → (string)**  
　　tool标识符（ID）。

**HDevelop例程**

> tuple\_substr.hdev Cut characters out of a string tuple  
> tuple\_select\_mask.hdev Select elements of a tuple specified by a mask  
> tuple\_replace.hdev Replace elements of a tuple  
> tuple\_insert.hdev Insert elements into a tuple  
> tuple\_compare\_elem.hdev Compare tuples elementwise  
> dev\_open\_tool.hdev Open and adjust tools in HDevelop

**程序示例**

dev_open_tool ('zoom_window',0, 0, Width, Height, [], [], ToolId)
    dev_close_tool (ToolId)

## 06. 结果 ##

如果指定参数的值正确，则dev\_open\_tool返回2（H\_MSG\_TRUE）。 否则会引发异常并返回错误代码。

## 07. 附录 ##

**7.1 机器视觉博客汇总**  
网址：[https://dengjin.blog.csdn.net/article/details/116837497][https_dengjin.blog.csdn.net_article_details_116837497]

[https_dengjin.blog.csdn.net_article_details_116837497]: https://dengjin.blog.csdn.net/article/details/116837497