【机器视觉】 dev_set_tool_geometry算子

约定不等于承诺〃 2022-10-08 00:47 106阅读 0赞

## 00. 目录 ##

### 文章目录 ###

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

## 01. 概述 ##

dev\_set\_tool\_geometry - 设置指定tool的位置和大小。

## 02. 签名 ##

`dev_set_tool_geometry( : : ToolId, Row, Column, Width, Height : )`

## 03. 描述 ##

dev\_set\_tool\_geometry使用ToolId的id来设置tool的位置和尺寸。

传递ToolId还有种替代方案，可以传递在算子dev\_open\_tool中使用的名称。 在这种情况下，任意的符合条件的参数ToolId都会使用到。

参数Row和Column可以用来修改tool的位置。 为了不改变该位置，可以传递’default’。

参数Width和Height可以用来修改tool的大小。 为了不改变大小，可以传递’default’。 如果Width和Height小于tool的最小尺寸，则使用最小尺寸。

温馨提示:

> 如果在此算子中直接传递tool名称，只会作用到最新的打开的tool。

**原文描述**：

dev\_set\_tool\_geometry sets the position and dimension of the tool with the id ToolId.

Instead of using the ToolId, given during opening the tool, you can use the name that has to be used in dev\_open\_tool. In that case a arbitrary tool, which fits the parameter ToolId, is used.

The parameters Row and Column can be used to modify the position of the tool. In order to unmodify the position ‘default’ can be passed.

The parameters Width and Height can be used to modify the size of the tools. In order to unmodify the size ‘default’ can be passed. If Width and Height are less than the minimum size of the tool the minimum size is used.

## 04. 注意 ##

此算子不支持代码导出

## 05. 参数 ##

**ToolId (input\_control) 　　dev\_tool → (string)**  
　　Tool identifier.

**Row (input\_control) 　　 rectangle.origin.y → (integer / string)**  
　　Row index of upper left corner.  
　　Default value: ‘default’  
　　Minimum increment: 1  
　　Recommended increment: 1

**Column (input\_control)　　 rectangle.origin.x → (integer / string)**  
　　Column index of upper left corner.  
　　Default value: ‘default’  
　　Minimum increment: 1  
　　Recommended increment: 1

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

**Height (input\_control) 　　 rectangle.extent.y → (integer)**  
　　Height of the tool.  
　　Default value: ‘default’  
　　Minimum increment: 1  
　　Recommended increment: 1  
　　Restriction: Height > 0

**HDevelop例程**

> dev\_open\_tool.hdev Open and adjust tools in HDevelop

**程序示例**

dev_open_tool ('zoom_window', 0, 0, Width, 'default', 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