【机器视觉】 dev_set_window_extents算子

绝地灬酷狼 2022-10-08 00:50 54阅读 0赞

## 00. 目录 ##

### 文章目录 ###

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

## 01. 概述 ##

dev\_set\_window\_extents - 更改活动图形窗口的位置和大小。

## 02. 签名 ##

`dev_set_window_extents( : : Row, Column, Width, Height : )`

## 03. 描述 ##

dev\_set\_window\_extents更改当前活动图形窗口的位置和/或大小。

参数Row和Column指定窗口的新位置（左上角）。 根据HDevelop的窗口模式，坐标（0,0）分别指的是在MDI模式的主HDevelop窗口中的窗口区域的左上角，以及在SDI模式下的屏幕的左上角。 该位置的负坐标被忽略，即在相应的方向上窗口不会被移动。

参数Width和Height指定窗口的新大小。 这是实际显示图形对象的内部部分的大小。 如果其中一个值是负数，那么相应的尺寸将保持不变。

**原文描述**：

dev\_set\_window\_extents changes the position and/or the size of the currently active graphics window.

The parameters Row and Column specify the new position (upper left corner) of the window. Depending on the window mode of HDevelop, the coordinates (0,0) refer to the upper left corner of the window area in the main HDevelop window in MDI mode, and the upper left corner of the screen in SDI mode, respectively. Negative coordinates of the position are ignored, i.e., in this direction the window will not be moved.

The parameters Width and Height specify the new size of the window. This is the size of the inner part that actually displays the iconic objects. If one of the two values is negative, this dimension will remain unchanged.

## 04. 注意 ##

切勿使用set\_window\_extents更改HDevelop图形窗口的大小和位置。 必须使用算子dev\_set\_window\_extents。

使用HDevelop的代码导出功能，为该算子生成的代码可能与相关的HALCON算子具有不同的行为。 有关将HDevelop图形算子导出为不同编程语言的代码的详细说明，请参阅“HDevelop User’s Guide”中的 Code Export -> General Aspects of Code Generation -> Graphics Windows一章。

## 05. 参数 ##

**Row (input\_control) rectangle.origin.y → (integer)**  
　　Row index of upper left corner.  
　　Default value: 0  
　　Typical range of values: 0 ≤ Row  
　　Minimum increment: 1  
　　Recommended increment: 1  
　　Restriction: (Row >= 0) || (Row == -1)

**Column (input\_control) rectangle.origin.x → (integer)**  
　　Column index of upper left corner.  
　　Default value: 0  
　　Typical range of values: 0 ≤ Column  
　　Minimum increment: 1  
　　Recommended increment: 1  
　　Restriction: (Column >= 0) || (Column == -1)

**Width (input\_control) rectangle.extent.x → (integer)**  
　　Width of the window.  
　　Default value: 256  
　　Typical range of values: 0 ≤ Width  
　　Minimum increment: 1  
　　Recommended increment: 1  
　　Restriction: (Width > 0) || (Width == -1)

**Height (input\_control) rectangle.extent.y → (integer)**  
　　Height of the window.  
　　Default value: 256  
　　Typical range of values: 0 ≤ Height  
　　Minimum increment: 1  
　　Recommended increment: 1  
　　Restriction: (Height > 0) || (Height == -1)

**HDevelop例程**

> vector\_to\_proj\_hom\_mat2d.hdev Rectify image of stadium to simulate overhead view  
> gen\_projective\_mosaic.hdev Combine several images of a PCB into a large mosaic image  
> dev\_set\_window\_extents.hdev Set size and position of a graphics window in HDevelop  
> dev\_set\_part.hdev Set the part of an image to be displayed (zoomed) in a graphics window in HDevelop  
> circular\_barcode.hdev Read a circular bar code printed on a CD  
> cbm\_caliper.hdev Measure the setting of a caliper using component-based matching in a perspectively distorted image  
> barcode\_orientation.hdev Use the bar code parameter ‘orientation’

**程序示例**

dev_close_window ()
    read_image (For5, 'for5')
    get_image_size (For5, Width, Height)
    dev_open_window (0, 0, Width, Height, 'black', WindowHandle)
    dev_display (For5)
    stop ()
    dev_set_window_extents (-1,-1,Width/2,Height/2)
    dev_display (For5)
    stop ()
    dev_set_window_extents (200,200,-1,-1)

## 06. 结果 ##

如果指定参数的值正确，则dev\_set\_window\_extents返回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