ClassesClassesClassesClasses | | | | Operators

store_par_knowledgestore_par_knowledgeStoreParKnowledgestore_par_knowledgeStoreParKnowledgeStoreParKnowledge (Operator)

Name

store_par_knowledgestore_par_knowledgeStoreParKnowledgestore_par_knowledgeStoreParKnowledgeStoreParKnowledge — Store knowledge about automatic parallelization in file.

Warning

store_par_knowledgestore_par_knowledgeStoreParKnowledgestore_par_knowledgeStoreParKnowledgeStoreParKnowledge is obsolete and is only provided for reasons of backward compatibility. New applications should use the operator write_aop_knowledgewrite_aop_knowledgeWriteAopKnowledgewrite_aop_knowledgeWriteAopKnowledgeWriteAopKnowledge to store optimization data for the automatic operator parallelization instead.

Signature

store_par_knowledge( : : FileName : )

Herror store_par_knowledge(const char* FileName)

Herror T_store_par_knowledge(const Htuple FileName)

Herror store_par_knowledge(const HTuple& FileName)

void StoreParKnowledge(const HTuple& FileName)

static void HSystem::StoreParKnowledge(const HString& FileName)

static void HSystem::StoreParKnowledge(const char* FileName)

void HOperatorSetX.StoreParKnowledge([in] VARIANT FileName)

void HSystemX.StoreParKnowledge([in] BSTR FileName)

static void HOperatorSet.StoreParKnowledge(HTuple fileName)

static void HSystem.StoreParKnowledge(string fileName)

Description

store_par_knowledgestore_par_knowledgeStoreParKnowledgestore_par_knowledgeStoreParKnowledgeStoreParKnowledge 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_potentialcheck_par_hw_potentialCheckParHwPotentialcheck_par_hw_potentialCheckParHwPotentialCheckParHwPotential. There, HALCON stores the knowledge in a specific file in the HALCON installation directory (Linux/OS X) or within the “registry” (Windows). This enables HALCON to use the knowledge again later on. With store_par_knowledgestore_par_knowledgeStoreParKnowledgestore_par_knowledgeStoreParKnowledgeStoreParKnowledge it is possible to store this knowledge explicitly as an ASCII file. At this, FileNameFileNameFileNameFileNameFileNamefileName denotes the name of this file (incl. path and file extension). The stored knowledge can be read again later on by using load_par_knowledgeload_par_knowledgeLoadParKnowledgeload_par_knowledgeLoadParKnowledgeLoadParKnowledge.

Parallelization

Parameters

FileNameFileNameFileNameFileNameFileNamefileName (input_control)  filename.write HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Name of parallelization knowledge file.

Default value: '' "" "" "" "" ""

Result

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

Module

Foundation


ClassesClassesClassesClasses | | | | Operators