load_par_knowledge — Load knowledge about automatic parallelization from file.
load_par_knowledge is obsolete and is only provided for reasons of backward compatibility. New applications should use the operator read_aop_knowledge to load optimization data for the automatic operator parallelization instead.
load_par_knowledge( : : FileName : )
load_par_knowledge supports the automatic parallelization of HALCON operators, which is used to better utilize multiprocessor hardware in order to speed up the processing of operators. To parallelize the processing of operators automatically HALCON needs some specific knowledge about the used hardware. This hardware-specific knowledge can be obtained by using the operator check_par_hw_potential. In the normal case, HALCON stores this knowledge in a specific file in the HALCON installation directory (Linux/Mac OS X) or within the “registry” (Windows). This enables HALCON to use the knowledge again later on. With load_par_knowledge it is possible to load this knowledge explicitly from an ASCII file. At this, FileName denotes the name of this file (incl. path and file extension). The file must conform to a specific syntax and must have been stored beforehand by using store_par_knowledge. While reading the file load_par_knowledge checks whether its content was written for the currently used computer and whether the contained parallelization information regards the currently used HALCON version (and revision). If this is the case, load_par_knowledge adopts the information so that it will also be used with further HALCON sessions. Otherwise, the information is ignored and load_par_knowledge returns an appropriate error message.
Name of parallelization knowledge file.
Default value: ''
load_par_knowledge returns 2 (H_MSG_TRUE) if all parameters are correct.