Information concerning the currently used HORUS system parameter.
The operator get_system returns information concerning the currently activated HORUS 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' HORUS\ version number, e.g.: 3.08 'last_update' Date of creation of the HORUS\ library 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 HORUS-procedures (system defined + user defined). Host language: ------------- 'min_integer' Smallest representable integer. 'max_integer' Biggest representable integer.. +'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 HORUS\ procedure. +'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). +'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_grey_4' Number of colors reserved under X-Windows concerning the output of graylevels (disp_grey) on machines with 4 bitplanes (16 colors). +'num_grey_6' Number of colors reserved under X-Windows concerning the output of graylevels (disp_grey) on machines with 6 bitplanes (64 colors). +'num_grey_8' Number of colors reserved under X-Windows concerning the output of graylevels (disp_grey) on machines with 8 bitplanes (256 colors). +'num_grey_percentage' Under X-windows HORUS\ reserves a certain number of available colors to allow the representation of graylevels (disp_grey). This shall interfere with other X applications as little as possible. However, if HORUS\ does not succeed in reserving a miminum percentage of 'num_grey_percentage' of the necessary colors on the X-server, a certain amount of the lookup-table will be claimed for the HORUS\ graylevels regardless of the consequences for other applications. This may result in undesired shifts of color when switching between HORUS\ windows and windows of other applications, or if (outside HORUS) a window-dump is generated. The number of the real graylevels to be reserved depends on the number of available bitplanes on the outputmachine (see also 'num_grey_*'. 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', 'grey', 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_grey_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_2' Number of the HORUS\ graphic colors reserved under X-Windows (for disp_region etc.) on a machine with 2 bitplanes (4 colors). +'num_graphic_4' Number of the HORUS\ graphic colors reserved under X-Windows (for disp_region etc.) on a machine with 4 bitplanes (16 colors). +'num_graphic_6' Number of the HORUS\ graphic colors reserved under X-Windows (for disp_region etc.) on a machine with 6 bitplanes (64 colors). +'num_graphic_8' Number of the HORUS\ graphic colors reserved under X-Windows (for disp_region etc.) on a machine with 8 bitplanes (256 colors). +'graphic_colors' All colors under X Windows which can be used by HORUS. From this list the first num_graphic_x colors will be reserved as graphic colors. On default, HORUS\ supplies in this case the same list as by calling query_all_colors. However, the list can be adapted individually with the help of the operator set_system. Note: In case of a graylevel machine, not the first x colors will be reserved from the list, but the first graylevels. Image Processing: ----------------- +'neighbourhood' Using the 4 or 8 neighborhood. +'image_dir' Path which will searched for the image file after the default directory (see also: read_image). +'init_new_image' Initialization of images before applying grayvalue transformations. +'store_empty_region' Storing of objects with empty regions. +'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 HORUS\ 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 HORUS\ 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\}.
Query (input_control) |
string(-array) -> string |
Desired system parameter. | |
Default value: 'width' | |
List of values: 'version', 'last_update', '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', 'min_integer', 'max_integer', 'compact_obj', 'flush_graphic', 'backing_store', 'default_font', 'lut_dir', 'x_package', 'last_pixel', 'num_grey_4', 'num_grey_6', 'num_grey_8', 'num_grey_percentage', 'num_graphic_2', 'num_graphic_4', 'num_graphic_6', 'num_graphic_8', 'num_graphic_percentage', 'graphic_colors', 'neighbourhood', 'image_dir', 'init_new_image', 'store_empty_region', 'no_object_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' |
Information (output_control) |
integer(-array) -> integer / real / string |
Current value of the system parameter. |
The operator get_system returns the value TRUE if the parameters are correct. Otherwise an exception is raised.