Information concerning the currently used HALCON system parameter.
The operator ::get_system returns information concerning the currently activated HALCON system parameters. Some of these parameters can be changed dynamically by using the operator ::set_system. If the string '?' is passed together with Query, the names of all system parameters are provided under Information.
The following system parameters can be queried:
Versions:
----------
'version'
HALCON\ version number, e.g.: 5.2
'last_update'
Date of creation of the HALCON\ library
'revison'
Sub version of the HALCON\ library, e.g.: 1
Upper limits:
------------
'max_contour_length'
Maximum number of contour respectively polygone control points
of a region.
'max_images'
Maximum total of images.
'max_object_images'
Maximum number of channels of an image.
'max_obj_per_par'
Maximum number of image objects which may be used during one
call per parameter.
'max_inp_obj_par'
Maximum number of input parameters.
'max_outp_obj_par'
Maximum number of output parameters.
'max_inp_ctrl_par'
Maximum number of input control parameters.
'max_outp_ctrl_par'
Maximum number of output control parameters.
'max_window'
Maximum number of windows.
'max_window_types'
Maximum number of window systems (e.g.\ 'X Window',
'Starbase', etc.).
'max_proc'
Maximum number of HALCON-procedures (system defined +
user defined).
Host language:
-------------
+'compact_obj'
Some host languages like Prolog allow modifications of the
processing mode for object images (see also
::count_relation):
'true': A common key for all result objects of a procedure
is created.
'false': Each object receives its own key.
Graphic:
--------
+'flush_graphic'
Determines, whether the flush operation is called
or not after each HALCON\ procedure.
+'int2_bits'
Number of significant bits of int2 images.
This number is used when scaling the gray values.
If the values is -1 the gray values will be
automatically scaled (default).
+'backing_store'
Storage of the window contents in case of overlaps.
+'default_font'
Name of the font to set at opening a window.
+'lut_dir'
Path for the default-directory for color tables
(see also: ::set_lut).
+'single_lut'
Beschreibung fehlt.
+'update_lut'
Beschreibung fehlt.
+'x_package'
Number of bytes which are sent to the X server during each
transfer of data.
+'last_pixel'
Largest color table index which may be used.
+'num_gray_4'
Number of colors reserved under X-Window concerning the
output of graylevels (::disp_channel) on machines
with 4 bitplanes (16 colors).
+'num_gray_6'
Number of colors reserved under X-Window concerning the
output of graylevels (::disp_channel) on machines
with 6 bitplanes (64 colors).
+'num_gray_8'
Number of colors reserved under X-Window concerning the
output of graylevels (::disp_channel) on machines
with 8 bitplanes (256 colors).
+'num_gray_percentage'
Under X-windows HALCON\ reserves a certain number of available
colors to allow the representation of graylevels
(::disp_channel). This shall interfere with other
X applications as little as possible. However, if HALCON\ does
not succeed in reserving a miminum percentage of
'num_gray_percentage' of the necessary colors on the X-server,
a certain amount of the lookup-table will be claimed for the
HALCON\ graylevels regardless of the consequences for other
applications.
This may result in undesired shifts of color when switching
between HALCON\ windows and windows of other applications,
or if (outside HALCON) a window-dump is generated. The number
of the real graylevels to be reserved depends on the number of
available bitplanes on the output-machine (see also 'num_gray_*'.
Naturally no colors will be reserved on monochrome machines -
the graylevels will instead be dithered when displayed. If
graylevel-displays are used, only different shades of gray
will be applied ('black', 'white', 'gray', etc.).
Machines with 2 or 3 bitplanes will be considered monochrome
machines, machines with 5 (7) bitplanes like machines with 4 (6)
bitplanes, and machines having more than 8 bitplanes like
machines with 8 bitplanes. A special case are machines providing
a 24 bit display (true color machines). Naturally no colors are
reserved for the display of graylevels in this case.
Note: Before the first window on a machine with x bitplanes is
opened, num_gray_x indicates the number of colors which have to
be reserved for the display of graylevels, afterwards, however,
it will indicate the number of colors which actually have been
reserved.
+'num_graphic_percentage'
Beschreibung fehlt.
+'draw_mode'
Beschreibung fehlt.
+'int_zooming'
Beschreibung fehlt.
+'ignore_colormap'
Beschreibung fehlt.
+'icon_name'
Beschreibung fehlt.
+'num_graphic_2'
Number of the HALCON\ graphic colors reserved under X-Window
(for ::disp_region etc.) on a machine with 2 bitplanes
(4 colors).
+'num_graphic_4'
Number of the HALCON\ graphic colors reserved under X-Window
(for ::disp_region etc.) on a machine with 4 bitplanes
(16 colors).
+'num_graphic_6'
Number of the HALCON\ graphic colors reserved under X-Window
(for ::disp_region etc.) on a machine with 6 bitplanes
(64 colors).
+'num_graphic_8'
Number of the HALCON\ graphic colors reserved under X-Window
(for ::disp_region etc.) on a machine with 8 bitplanes
(256 colors).
Image Processing:
-----------------
+'neighborhood'
Using the 4 or 8 neighborhood.
+'image_dir'
Path which will searched for the image file after the
default directory (see also: ::read_image).
+'only_lines'
Beschreibung fehlt.
+'init_new_image'
Initialization of images before applying grayvalue
transformations.
+'store_empty_region'
Storing of objects with empty regions.
+'empty_region_result'
Beschreibung fehlt.
+'no_object_result'
Behavior for an empty object list.
+'empty_object_result'
Behavior for an empty input region.
+'clip_region'
Clipping of output regions so that they fit the global
image size.
'width'
Current image width.
'height'
Current image height.
'obj_images'
Current number of grayvalue components per image object.
+'current_runlength_number'
Currently used number of chords which can be used
for the encoding of regions.
File:
------
'flush_file'
Buffering of file ouput.
Other:
----------
'num_proc'
Total number of all available HALCON\ procedures.
('num_sys_proc' + 'num_user_proc').
'num_sys_proc'
Number of the system procedures (supported procedures).
'num_user_proc'
Number of the user-defined procedures (see also C interface).
+'latex_dir'
Path for the default directory concerning the LaTex sources
of the HALCON\ documentation.
+'help_dir'
Path for the default help directory for the online help files:
\{german,english\}.\{hlp,sta,idx,num,key\}.
+'user_help_dir'
Path for the user help directory for the online help files:
\{german,english\}[.user].\{hlp,sta,idx,num,key\}.
+'do_low_error'
Flag, if low level error should be printed.
+'language'
Beschreibung fehlt.
|
Query (input_control) |
string(-array) -> HTuple.char * |
| Desired system parameter. | |
| Default value: 'width' | |
| List of values: 'version', 'last_update', 'revision', 'max_images', 'max_obj_per_par', 'max_inmp_obj_par', 'max_outp_obj_par', 'max_inp_ctrl_par', 'max_outp_ctrl_par', 'max_window', 'max_window_type', 'max_proc', 'compact_obj', 'int2_bits', 'flush_graphic', 'backing_store', 'default_font', 'lut_dir', 'single_lut', 'update_lut', 'x_package', 'last_pixel', 'num_gray_4', 'num_gray_6', 'num_gray_8', 'num_gray_percentage', 'num_graphic_2', 'num_graphic_4', 'num_graphic_6', 'num_graphic_8', 'num_graphic_percentage', 'draw_mode', 'int_zooming', 'ignore_colormap', 'icon_name', 'neighborhood', 'image_dir', 'only_lines', 'init_new_image', 'store_empty_region', 'no_object_result', 'empty_region_result', 'empty_region_result', 'clip_region', 'width', 'height', 'obj_images', 'current_runlength_number', 'flush_file', 'num_proc', 'num_sys_proc', 'num_user_proc', 'latex_dir', 'help_dir', 'user_help_dir', 'do_low_error', 'language' | |
|
Information (output_control) |
integer(-array) -> (HTuple.) long * / double * / char * |
| Current value of the system parameter. | |
The operator ::get_system returns the value H_MSG_TRUE if the parameters are correct. Otherwise an exception is raised.
System
