《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,根据子像素准确性从一幅图像中提取零相交。