set_window_param — Set window parameters.
set_window_param( : : WindowHandle, Param, Value : )
The operator set_window_param allows to set different parameters
of an open window.
General window parameters:
Enables or disables flushing the contents of the window after the display
of every object. If 'flush' is set to 'false',
flush_buffer must be called to update the contents of the window.
If you want to interact with the content of the graphics window
(e.g., zoom or move the content), you have to set 'flush' to
'true'.
possible values: 'true', 'false'
default value: 'true'
Influences the quality of the rendering of region objects. Especially if
the region to display has to be scaled down for visualization,
'good' produces a more accurate and pleasing impression.
'low' is a bit inaccurate in these cases but significantly
faster. If only the border of the region is displayed
(see set_draw), the fractional part of the line width
(see set_line_width) is ignored.
possible values: 'low', 'good'
default value: 'low'
Sets the background color of the window WindowHandle. The
operator clear_window uses this color to clear the window.
possible values: a string containing the color name (e.g. 'black', 'red')
Allows to change the text in the title bar of an already opened HALCON window.
possible values: a string containing up to 1023 characters
Enables or disables the anti aliasing of contours and regions.
possible values: 'true', 'false'
default value: 'true'
Enables or disables the graphics stack of a window. With
activated graphics stack changing the window part with set_part
triggers the display of previously displayed objects with respect to
the new part. With this it is possible to move or scale the contents of
the window. This parameter has no effect on the graphics stack of a
HDevelop graphics window.
possible values: 'true', 'false'
default value: 'false'
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.
possible values: positive number or 'unlimited'
default value: 50
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 set_paint):
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)
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: [' ',' ',' ']
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'
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'
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.
possible values: 'true', 'false'
default value: 'true'
If set to 'true' a grid is displayed at height 0.
possible values: 'true', 'false'
default value: 'true'
If set to 'true' coordinate axes are displayed.
possible values: 'true', 'false'
default value: 'true'
The parameters 'anti_aliasing', 'flush', 'graphics_stack', 'graphics_stack_max_element_num', 'graphics_stack_max_memory_size', and 'region_quality' depend on the library libcanvas, which might not be available on embedded systems.
WindowHandle (input_control) window → (handle)
Window handle.
Param (input_control) string → (string)
Name of the parameter.
Default value: 'flush'
List of values: 'angle_of_view', 'anti_aliasing', 'axis_captions', 'background_color', 'caption_color', 'display_axes', 'display_grid', 'flush', 'graphics_stack', 'graphics_stack_max_element_num', 'graphics_stack_max_memory_size', 'plot_quality', 'region_quality', 'scale_plot', 'window_title'
Value (input_control) string(-array) → (string / real / integer)
Value to be set.
Default value: 'false'
List of values: 'best', 'black', 'blue', 'false', 'good', 'green', 'low', 'medium', 'orthogonal', 'red', 'true', 'unlimited', 'white'
get_window_param,
set_window_attr,
set_part_style
Foundation