HALCON - SetWindowParam

Signature

static void HOperatorSet.SetWindowParam(HTuple windowHandle, HTuple param, HTuple value)

void HWindow.SetWindowParam(string param, HTuple value)

void HWindow.SetWindowParam(string param, string value)

Description

The operator SetWindowParam allows to set different parameters of an open window.

General window parameters:

• 'flush'（true/false）

在显示每一个对象之后是否刷新窗口。如果该值设置为false，必须调用FlushBuffer函数刷新窗口。如果需要与窗口进行交互（缩放与拖拽），则必须色设置该值为true

• 'region_quality'（good/low）

影响区域对象的渲染质量。该值设置为good，区域对象显示更精确且友好；该值设置为low，区域对象显示有些不精确但速度快。如果区域的标间模式设置为margin，则部分边缘可能无法正常显示。

• 'background_color'（black）

设置窗口的背景色，ClearWindow函数使用该颜色清除窗口内容

• 'window_title'

允许修改窗口的标题，最高1023个字符

• 'anti_aliasing'（true/false）

是否开启窗口显示区域与轮廓的反欠采样噪声功能

• 'graphics_stack'（true/false）

开启或关闭窗口的图形堆栈功能。在激活图形堆栈的窗口中调用SetPart改变窗口的显示区域将使用新的显示区域显示原先显示的对象。开启该功能能够实现窗口内容的移动与缩放。该参数对HDevelop 图形窗口无效

• 'graphics_stack_max_element_num'（positive/number(50)/unlimited）

Maximum number of elements in the graphics stack. This number corresponds to the number of display operations recorded. This parameter has no effect on the graphics stack of a HDevelop graphics window and is effective not before the next call to a display operator.

• 'graphics_stack_max_memory_size'

Limits the memory consumption of the graphics stack. If this limit is exceeded, older display operations are removed from the graphics stack. This parameter has no effect on the graphics stack of a HDevelop graphics window and is effective not before the next call to a display operator.

possible values: memory limit in bytes or 'unlimited'

default value: 'unlimited'

Parameters concerning the "3d_plot" (see SetPaint):

• 'angle_of_view'

Set the angle of view of the virtual camera used to display the 3D plot. The angle must be provided in radians and lie within the interval [0,PI). An angle of 0 radians implies orthogonal projection. Another way to choose orthogonal projection is to set "angle_of_view" to "orthogonal".

possible values: 'orthogonal' or an angle in radians

default value: 1.22173 (70 degrees)

• 'axis_captions'

The axis captions for row, column, and height can be set by passing a tuple containing the strings for the captions in the specified order row, column, and height axis (e.g. ['row','col','height']). Pass empty strings to display no captions at all.

possible values: A tuple containing three strings. Each string can contain up to 31 characters.

default value: [' ',' ',' ']

• 'caption_color'

The color of the axis captions for row, column, and height. You can either pass one color for all three axes or a tuple of three colors to set individual colors for each axis.

possible values: a string or tuple with three strings containing the color name (e.g. 'black', 'red')

default value: 'black'

• 'plot_quality'

Influences the quality of the 3D plot. Depending on the capabilities of your graphics card better settings for the quality may reduce the frame rate of the 3D plot significantly.

possible values: 'low', 'medium', 'good', 'best'

default value: 'medium'

• 'scale_plot'（true/false）

If set to 'true' the height values of an image are transformed into the interval [0,255] before display. If set to 'false' the aspect ratio between row/column and height is considered. Images of the type byte, cyclic, or direction are not scaled, i.e. in their cases this parameter is ignored.

• 'display_grid'（true/false）

If set to 'true' a grid is displayed at height 0.

• 'display_axes'（true/false）

是否显示坐标轴