《zw版·Halcon-delphi系列原创教程》 Halcon分类函数011,ocr，字符识别

《zw版·Halcon-delphi系列原创教程》 Halcon分类函数011,ocr，字符识别

为方便阅读，在不影响说明的前提下，笔者对函数进行了简化：

• :: 用符号“**”，替换：“procedure”
• :: 用大写字母“X”，替换：“IHUntypedObjectX”
• :: 省略了字符：“const”、“OleVariant”

【示例】 说明

函数：

procedure AddNoiseWhiteContourXld( const Contours: IHUntypedObjectX; out NoisyContours: IHUntypedObjectX; NumRegrPoints: OleVariant; Amp: OleVariant);

简化后为：

** AddNoiseWhiteContourXld( Contours: X; out NoisyContours: X; NumRegrPoints, Amp);

 ** AppendOcrTrainf( Character: X; Image: X; Class_, TrainingFile);
 说明,  append_ocr_trainf,将字符添加到一个测试文件中。

 ** ClearAllOcrClassKnn;
 说明,  清除所有创建的OCR-knn分级器

 ** ClearAllOcrClassMlp;
 说明,  clear_all_ocr_class_mlp,清除所有的create_ocr_class_mlp创建的OCR分级器，释放分级器占据的存储空间。

 ** ClearAllOcrClassSvm;
 说明,  clear_all_ocr_class_svm,清除所有的基于OCR分级器的SVM，释放相应的存储空间。

 ** ClearOcrClassKnn( OCRHandle);

 ** ClearOcrClassMlp( OCRHandle);
 说明,  clear_ocr_class_mlp,清除所有的由OCRHandle给定的且由create_ocr_class_mlp创建的OCR分级器，释放所有的分级器占据的存储空间。

 ** ClearOcrClassSvm( OCRHandle);
 说明,  clear_ocr_class_svm,清除基于OCR分级器的一个SVM，释放相应的存储空间。

 ** CloseAllOcrs;
 说明,  close_all_ocrs,删除所有光字符，释放存储空间，但会丢失所有的测试数据。

 ** CloseOcr( OCRHandle);
 说明,  close_ocr,重新分配拥有OcrHandle数目的分级器的存储，但所有相应的数据会丢失，不过这些数据可由write_ocr事先保存。

 ** ConcatOcrTrainf( SingleFiles, ComposedFile);
 说明,  concat_ocr_trainf,合并测试文件。

 ** CreateOcrClassBox( WidthPattern, HeightPattern, Interpolation, Features, Character, out OCRHandle);
 说明,  create_ocr_class_box,创建新的OCR分级器。

 ** CreateOcrClassKnn( WidthCharacter, HeightCharacter, Interpolation, Features, Characters, GenParamNames, GenParamValues, out OCRHandle);
 说明,  创建knn分级器。

 ** CreateOcrClassMlp( WidthCharacter, HeightCharacter, Interpolation, Features, Characters, NumHidden, Preprocessing, NumComponents, RandSeed, out OCRHandle);
 说明,  create_ocr_class_mlp,利用MLP（多层感知器）创建一个新的OCR分级器。

 ** CreateOcrClassSvm( WidthCharacter, HeightCharacter, Interpolation, Features, Characters, KernelType, KernelParam, Nu, Mode, Preprocessing, NumComponents, out OCRHandle);
 说明,  create_ocr_class_svm,利用支持向量机创建一个OCR分级器。

 ** DeserializeOcr( SerializedItemHandle, out OCRHandle);
 说明,  ocr数据转换

 ** DeserializeOcrClassKnn( SerializedItemHandle, out OCRHandle);
 说明,  ocr-knn分类器数据转换

 ** DeserializeOcrClassMlp( SerializedItemHandle, out OCRHandle);
 说明,  ocr-mlp分类器数据转换

 ** DeserializeOcrClassSvm( SerializedItemHandle, out OCRHandle);
 说明,  ocr-svm分类器数据转换

 ** DoOcrMulti( Character: X; Image: X; OCRHandle, out Class_, out Confidence);
 说明,  do_ocr_multi,给每一个Character（字符）分配一个类。

 ** DoOcrMultiClassKnn( Character: X; Image: X; OCRHandle, out Class_, out Confidence);
 说明,  do_ocr_multi,给多个Character（字符）分配一个KNN类。

 ** DoOcrMultiClassMlp( Character: X; Image: X; OCRHandle, out Class_, out Confidence);
 说明,  do_ocr_multi_class_mlp,为根据给定区域字符和OCR分级器OCRHandle的灰度图像值而给定的每个字符计算出最好的类，将类返回到Class中，且将类的置信度返回到Confidence中。

 ** DoOcrMultiClassSvm( Character: X; Image: X; OCRHandle, out Class_);
 说明,  do_ocr_multi_class_svm,根据基于OCR分级器的SVM将大量字符分类。

 ** DoOcrSingle( Character: X; Image: X; OCRHandle, out Classes, out Confidences);
 说明,  do_ocr_single,给一些Character（字符）分配一些类。

 ** DoOcrSingleClassKnn( Character: X; Image: X; OCRHandle, NumClasses, NumNeighbors, out Class_, out Confidence);
 说明,  do_ocr_multi,给每一个Character（字符）分配一个KNN类。

 ** DoOcrSingleClassMlp( Character: X; Image: X; OCRHandle, Num, out Class_, out Confidence);
 说明,  do_ocr_single_class_mlp,为根据给定区域字符和OCR分级器OCRHandle的灰度图像值而给定的字符计算出最好的Num类，将类返回到Class中，且将类的置信度返回到Confidence中。

 ** DoOcrSingleClassSvm( Character: X; Image: X; OCRHandle, Num, out Class_);
 说明,  do_ocr_single_class_svm,根据基于OCR分级器的SVM将单个字符分类。

 ** DoOcrWordKnn( Character: X; Image: X; OCRHandle, Expression, NumAlternatives, NumCorrections, out Class_, out Confidence, out Word, out Score);
 说明,  将字符组作为一个实体。

 ** DoOcrWordMlp( Character: X; Image: X; OCRHandle, Expression, NumAlternatives, NumCorrections, out Class_, out Confidence, out Word, out Score);
 说明,  do_ocr_word_mlp,功能与do?_ocr_multi_class_mlp相同，只是do_ocr_word_mlp将字符组作为一个实体。

 ** DoOcrWordSvm( Character: X; Image: X; OCRHandle, Expression, NumAlternatives, NumCorrections, out Class_, out Word, out Score);
 说明,  do_ocr_word_svm,利用OCR分级器将一系列相关字符分类。

 ** GetFeaturesOcrClassKnn( Character: X; OCRHandle, Transform, out Features);
 说明,  根据OCR分级器OCRHandl,e确定的字符计算其特征参数，并将它们返回到Features。

 ** GetFeaturesOcrClassMlp( Character: X; OCRHandle, Transform, out Features);
 说明,  get_features_ocr_class_mlp,为根据OCR分级器OCRHandle确定的字符计算其特征参数，并将它们返回到Features。

 ** GetFeaturesOcrClassSvm( Character: X; OCRHandle, Transform, out Features);
 说明,  get_features_ocr_class_svm,计算一个字符的特征。

 ** GetParamsOcrClassKnn( OCRHandle, out WidthCharacter, out HeightCharacter, out Interpolation, out Features, out Characters, out Preprocessing, out NumTrees);
 说明,  返回knn-ocr分类器的参数。

 ** GetParamsOcrClassMlp( OCRHandle, out WidthCharacter, out HeightCharacter, out Interpolation, out Features, out Characters, out NumHidden, out Preprocessing, out NumComponents);
 说明,  get_params_ocr_class_mlp,返回一个OCR分级器的参数只有当分级器由do_ocr_multi_class_mlp创建时。

 ** GetParamsOcrClassSvm( OCRHandle, out WidthCharacter, out HeightCharacter, out Interpolation, out Features, out Characters, out KernelType, out KernelParam, out Nu, out Mode, out Preprocessing, out NumComponents);
 说明,  get_params_ocr_class_svm,返回一个OCR分级器的参数。

 ** GetPrepInfoOcrClassMlp( OCRHandle, TrainingFile, Preprocessing, out InformationCont, out CumInformationCont);
 说明,  get_prep_info_ocr_class_mlp,计算OCR分级器预设定矢量特性的信息。

 ** GetPrepInfoOcrClassSvm( OCRHandle, TrainingFile, Preprocessing, out InformationCont, out CumInformationCont);
 说明,  get_prep_info_ocr_class_svm,计算基于OCR分级器的SVM的预定义特征矢量的信息内容。

 ** GetSupportVectorNumOcrClassSvm( OCRHandle, out NumSupportVectors, out NumSVPerSVM);
 说明,  get_support_vector_num_ocr_class_svm,返回OCR分级器支持的矢量的数目。

 ** GetSupportVectorOcrClassSvm( OCRHandle, IndexSupportVector, out Index);
 说明,  get_support_vector_ocr_class_svm,返回基于支持向量机的已测试OCR分级器中支持向量坐标。

 ** InfoOcrClassBox( OCRHandle, out WidthPattern, out HeightPattern, out Interpolation, out WidthMaxChar, out HeightMaxChar, out Features, out Characters);
 说明,  info_ocr_class_box,反馈ocr的有关信息。

 ** OcrChangeChar( OCRHandle, Character);
 说明,  ocr_change_char,为字符建立新的查阅表。

 ** OcrGetFeatures( Character: X; OCRHandle, out FeatureVector);
 说明,  ocr_get_features,计算给定Character（字符）的特征参数。

 ** ProtectOcrTrainf( TrainingFile, Password, TrainingFileProtected);

 ** ReadOcr( FileName, out OCRHandle);
 说明,  read_ocr,从文件的FileName（文件名）读取OCR分级器。

 ** ReadOcrClassKnn( FileName, out OCRHandle);
 说明,  读取ocr-knn数据

 ** ReadOcrClassMlp( FileName, out OCRHandle);
 说明,  read_ocr_class_mlp,从一个文件中读取OCR分级器。

 ** ReadOcrClassSvm( FileName, out OCRHandle);
 说明,  read_ocr_class_svm,从文件中读取基于OCR分级器的SVM。

 ** ReadOcrTrainf( out Characters: X; TrainingFile, out CharacterNames);
 说明,  read_ocr_trainf,从文件中读取字符，将其转换到图像中。

 ** ReadOcrTrainfNames( TrainingFile, out CharacterNames, out CharacterCount);
 说明,  read_ocr_trainf_names,查询哪些字符存储在测试文件中。

 ** ReadOcrTrainfNamesProtected( TrainingFile, Password, out CharacterNames, out CharacterCount);
 说明,  读取ocr数据

 ** ReadOcrTrainfSelect( out Characters: X; TrainingFile, SearchNames, out FoundNames);
 说明,  read_ocr_trainf_select,从文件中读取测试特定字符，将其转换到图像中。

 ** ReduceOcrClassSvm( OCRHandle, Method, MinRemainingSV, MaxError, out OCRHandleReduced);
 说明,  reduce_ocr_class_svm,根据一个减小的SVM来接近一个基于OCR分级器的SVM。

 ** SelectFeatureSetTrainfKnn( TrainingFile, FeatureList, SelectionMethod, Width, Height, GenParamNames, GenParamValues, out OCRHandle, out FeatureSet, out Score);
 说明,  根据knn训练参数特征选择对象

 ** SelectFeatureSetTrainfMlp( TrainingFile, FeatureList, SelectionMethod, Width, Height, GenParamNames, GenParamValues, out OCRHandle, out FeatureSet, out Score);
 说明,  根据mlp训练参数特征选择对象

 ** SelectFeatureSetTrainfMlpProtected( TrainingFile, Password, FeatureList, SelectionMethod, Width, Height, GenParamNames, GenParamValues, out OCRHandle, out FeatureSet, out Score);
 说明,  根据mlp训练参数特征选择对象

 ** SelectFeatureSetTrainfSvm( TrainingFile, FeatureList, SelectionMethod, Width, Height, GenParamNames, GenParamValues, out OCRHandle, out FeatureSet, out Score);
 说明,  根据svm训练参数特征选择对象

 ** SelectFeatureSetTrainfSvmProtected( TrainingFile, Password, FeatureList, SelectionMethod, Width, Height, GenParamNames, GenParamValues, out OCRHandle, out FeatureSet, out Score);
 说明,  根据svm训练参数特征选择对象

 ** SerializeOcr( OCRHandle, out SerializedItemHandle);
 说明,  ocr数据序列化

 ** SerializeOcrClassKnn( OCRHandle, out SerializedItemHandle);
 说明,  knn分类器数据序列化

 ** SerializeOcrClassMlp( OCRHandle, out SerializedItemHandle);
 说明,  mlp分类器数据序列化

 ** SerializeOcrClassSvm( OCRHandle, out SerializedItemHandle);
 说明,  svm分类器数据序列化

 ** TestdOcrClassBox( Character: X; Image: X; OCRHandle, Class_, out Confidence);
 说明,  testd_ocr_class_box,测试给定类中字符的置信度。

 ** TraindOcrClassBox( Character: X; Image: X; OCRHandle, Class_, out AvgConfidence);
 说明,  traind_ocr_class_box,通过一幅图像的特定区域直接测试分级器。

 ** TrainfOcrClassBox( OCRHandle, TrainingFile, out AvgConfidence);
 说明,  trainf_ocr_class_box,根据指定测试文件测试分级器的OCRHandle。

 ** TrainfOcrClassKnn( OCRHandle, TrainingFile, GenParamNames, GenParamValues);
 说明,  ocr-knn分类器训练

 ** TrainfOcrClassMlp( OCRHandle, TrainingFile, MaxIterations, WeightTolerance, ErrorTolerance, out Error, out ErrorLog);
 说明,  trainf_ocr_class_mlp,测试OCR分级器的OCRHandle，根据存储在OCR文件中的测试特性。

 ** TrainfOcrClassMlpProtected( OCRHandle, TrainingFile, Password, MaxIterations, WeightTolerance, ErrorTolerance, out Error, out ErrorLog);
 说明,  ocr-mlp分类器训练

 ** TrainfOcrClassSvm( OCRHandle, TrainingFile, Epsilon, TrainMode);
 说明,  trainf_ocr_class_svm,测试一个OCR分级器。

 ** TrainfOcrClassSvmProtected( OCRHandle, TrainingFile, Password, Epsilon, TrainMode);
 说明,  ocr-svm分类器训练

 ** WriteOcr( OCRHandle, FileName);
 说明,  write_ocr,将OCR分级器的OCRHandle写入文件的FileName（文件名）。

 ** WriteOcrClassKnn( OCRHandle, FileName);
 说明,  保存ocr-knn分类器数据

 ** WriteOcrClassMlp( OCRHandle, FileName);
 说明,  write_ocr_class_mlp,将OCR分级器的OCRHandle写入由文件名确定的文件中。

 ** WriteOcrClassSvm( OCRHandle, FileName);
 说明,  write_ocr_class_svm,将一个OCR分级器写入文件。

 ** WriteOcrTrainf( Character: X; Image: X; Class_, TrainingFile);
 说明,  write_ocr_trainf,将已测试的字符存储到文件中。

 ** WriteOcrTrainfImage( Character: X; Class_, TrainingFile);
 说明,  write_ocr_trainf_image,将字符写入正在测试的文件中。

 ** ZeroCrossing( Image: X; out RegionCrossing: X);
 说明,  zero_crossing,从一幅图像中提取零相交。

 ** ZeroCrossingsFunct1D( Function_, out ZeroCrossings);
 说明,  zero_crossings_funct_1d,计算一个函数的零点。

 ** ZeroCrossingSubPix( Image: X; out ZeroCrossings: X);
 说明,  zero_crossing_sub_pix,根据子像素准确性从一幅图像中提取零相交。