store_par_knowledge ( : : FileName : )

Store knowledge about automatic parallelization in file.

store_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 calling the operator check_par_hw_potential. There, HALCON stores the knowledge in a specific file in the HALCON installation directory (Linux/UNIX) or within the ``registry'' (Windows). This enables HALCON to use the knowledge again later on. With store_par_knowledge it is possible to store this knowledge explicitely as an ASCII file. At this, FileName denotes the name of this file (incl. path and file extension). The stored knowledge can be read again later on by using load_par_knowledge.


Parameters

FileName (input_control)
filename.named -> string
Name of parallelization knowledge file.
Default value: ''


Result

store_par_knowledge returns 2 (H_MSG_TRUE) if all parameters are correct.


Parallelization Information

store_par_knowledge is local and processed completely exclusively without parallelization.


Possible Predecessors

check_par_hw_potential


Possible Successors

load_par_knowledge


See also

load_par_knowledge, check_par_hw_potential


Module

Foundation



Copyright © 1996-2008 MVTec Software GmbH