《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);

  1 ** AppendOcrTrainf( Character: X; Image: X; Class_, TrainingFile); 
  2 说明,  append_ocr_trainf,将字符添加到一个测试文件中。
  3 
  4 ** ClearAllOcrClassKnn; 
  5 说明,  清除所有创建的OCR-knn分级器
  6 
  7 ** ClearAllOcrClassMlp; 
  8 说明,  clear_all_ocr_class_mlp,清除所有的create_ocr_class_mlp创建的OCR分级器，释放分级器占据的存储空间。
  9 
 10 ** ClearAllOcrClassSvm; 
 11 说明,  clear_all_ocr_class_svm,清除所有的基于OCR分级器的SVM，释放相应的存储空间。
 12 
 13 ** ClearOcrClassKnn( OCRHandle);
 14 
 15 ** ClearOcrClassMlp( OCRHandle); 
 16 说明,  clear_ocr_class_mlp,清除所有的由OCRHandle给定的且由create_ocr_class_mlp创建的OCR分级器，释放所有的分级器占据的存储空间。
 17 
 18 ** ClearOcrClassSvm( OCRHandle); 
 19 说明,  clear_ocr_class_svm,清除基于OCR分级器的一个SVM，释放相应的存储空间。
 20 
 21 ** CloseAllOcrs; 
 22 说明,  close_all_ocrs,删除所有光字符，释放存储空间，但会丢失所有的测试数据。
 23 
 24 ** CloseOcr( OCRHandle); 
 25 说明,  close_ocr,重新分配拥有OcrHandle数目的分级器的存储，但所有相应的数据会丢失，不过这些数据可由write_ocr事先保存。
 26 
 27 ** ConcatOcrTrainf( SingleFiles, ComposedFile); 
 28 说明,  concat_ocr_trainf,合并测试文件。
 29 
 30 ** CreateOcrClassBox( WidthPattern, HeightPattern, Interpolation, Features, Character, out OCRHandle); 
 31 说明,  create_ocr_class_box,创建新的OCR分级器。
 32 
 33 ** CreateOcrClassKnn( WidthCharacter, HeightCharacter, Interpolation, Features, Characters, GenParamNames, GenParamValues, out OCRHandle); 
 34 说明,  创建knn分级器。
 35 
 36 ** CreateOcrClassMlp( WidthCharacter, HeightCharacter, Interpolation, Features, Characters, NumHidden, Preprocessing, NumComponents, RandSeed, out OCRHandle); 
 37 说明,  create_ocr_class_mlp,利用MLP（多层感知器）创建一个新的OCR分级器。
 38 
 39 ** CreateOcrClassSvm( WidthCharacter, HeightCharacter, Interpolation, Features, Characters, KernelType, KernelParam, Nu, Mode, Preprocessing, NumComponents, out OCRHandle); 
 40 说明,  create_ocr_class_svm,利用支持向量机创建一个OCR分级器。
 41 
 42 ** DeserializeOcr( SerializedItemHandle, out OCRHandle); 
 43 说明,  ocr数据转换
 44 
 45 ** DeserializeOcrClassKnn( SerializedItemHandle, out OCRHandle); 
 46 说明,  ocr-knn分类器数据转换
 47 
 48 ** DeserializeOcrClassMlp( SerializedItemHandle, out OCRHandle); 
 49 说明,  ocr-mlp分类器数据转换
 50 
 51 ** DeserializeOcrClassSvm( SerializedItemHandle, out OCRHandle); 
 52 说明,  ocr-svm分类器数据转换
 53 
 54 ** DoOcrMulti( Character: X; Image: X; OCRHandle, out Class_, out Confidence); 
 55 说明,  do_ocr_multi,给每一个Character（字符）分配一个类。
 56 
 57 ** DoOcrMultiClassKnn( Character: X; Image: X; OCRHandle, out Class_, out Confidence); 
 58 说明,  do_ocr_multi,给多个Character（字符）分配一个KNN类。
 59 
 60 ** DoOcrMultiClassMlp( Character: X; Image: X; OCRHandle, out Class_, out Confidence); 
 61 说明,  do_ocr_multi_class_mlp,为根据给定区域字符和OCR分级器OCRHandle的灰度图像值而给定的每个字符计算出最好的类，将类返回到Class中，且将类的置信度返回到Confidence中。
 62 
 63 ** DoOcrMultiClassSvm( Character: X; Image: X; OCRHandle, out Class_); 
 64 说明,  do_ocr_multi_class_svm,根据基于OCR分级器的SVM将大量字符分类。
 65 
 66 ** DoOcrSingle( Character: X; Image: X; OCRHandle, out Classes, out Confidences); 
 67 说明,  do_ocr_single,给一些Character（字符）分配一些类。
 68 
 69 ** DoOcrSingleClassKnn( Character: X; Image: X; OCRHandle, NumClasses, NumNeighbors, out Class_, out Confidence); 
 70 说明,  do_ocr_multi,给每一个Character（字符）分配一个KNN类。
 71 
 72 ** DoOcrSingleClassMlp( Character: X; Image: X; OCRHandle, Num, out Class_, out Confidence); 
 73 说明,  do_ocr_single_class_mlp,为根据给定区域字符和OCR分级器OCRHandle的灰度图像值而给定的字符计算出最好的Num类，将类返回到Class中，且将类的置信度返回到Confidence中。
 74 
 75 ** DoOcrSingleClassSvm( Character: X; Image: X; OCRHandle, Num, out Class_); 
 76 说明,  do_ocr_single_class_svm,根据基于OCR分级器的SVM将单个字符分类。
 77 
 78 ** DoOcrWordKnn( Character: X; Image: X; OCRHandle, Expression, NumAlternatives, NumCorrections, out Class_, out Confidence, out Word, out Score); 
 79 说明,  将字符组作为一个实体。
 80 
 81 ** DoOcrWordMlp( Character: X; Image: X; OCRHandle, Expression, NumAlternatives, NumCorrections, out Class_, out Confidence, out Word, out Score); 
 82 说明,  do_ocr_word_mlp,功能与do?_ocr_multi_class_mlp相同，只是do_ocr_word_mlp将字符组作为一个实体。
 83 
 84 ** DoOcrWordSvm( Character: X; Image: X; OCRHandle, Expression, NumAlternatives, NumCorrections, out Class_, out Word, out Score); 
 85 说明,  do_ocr_word_svm,利用OCR分级器将一系列相关字符分类。
 86 
 87 ** GetFeaturesOcrClassKnn( Character: X; OCRHandle, Transform, out Features); 
 88 说明,  根据OCR分级器OCRHandl,e确定的字符计算其特征参数，并将它们返回到Features。
 89 
 90 ** GetFeaturesOcrClassMlp( Character: X; OCRHandle, Transform, out Features); 
 91 说明,  get_features_ocr_class_mlp,为根据OCR分级器OCRHandle确定的字符计算其特征参数，并将它们返回到Features。
 92 
 93 ** GetFeaturesOcrClassSvm( Character: X; OCRHandle, Transform, out Features); 
 94 说明,  get_features_ocr_class_svm,计算一个字符的特征。
 95 
 96 ** GetParamsOcrClassKnn( OCRHandle, out WidthCharacter, out HeightCharacter, out Interpolation, out Features, out Characters, out Preprocessing, out NumTrees); 
 97 说明,  返回knn-ocr分类器的参数。
 98 
 99 ** GetParamsOcrClassMlp( OCRHandle, out WidthCharacter, out HeightCharacter, out Interpolation, out Features, out Characters, out NumHidden, out Preprocessing, out NumComponents); 
100 说明,  get_params_ocr_class_mlp,返回一个OCR分级器的参数只有当分级器由do_ocr_multi_class_mlp创建时。
101 
102 ** GetParamsOcrClassSvm( OCRHandle, out WidthCharacter, out HeightCharacter, out Interpolation, out Features, out Characters, out KernelType, out KernelParam, out Nu, out Mode, out Preprocessing, out NumComponents); 
103 说明,  get_params_ocr_class_svm,返回一个OCR分级器的参数。
104 
105 ** GetPrepInfoOcrClassMlp( OCRHandle, TrainingFile, Preprocessing, out InformationCont, out CumInformationCont); 
106 说明,  get_prep_info_ocr_class_mlp,计算OCR分级器预设定矢量特性的信息。
107 
108 ** GetPrepInfoOcrClassSvm( OCRHandle, TrainingFile, Preprocessing, out InformationCont, out CumInformationCont); 
109 说明,  get_prep_info_ocr_class_svm,计算基于OCR分级器的SVM的预定义特征矢量的信息内容。
110 
111 ** GetSupportVectorNumOcrClassSvm( OCRHandle, out NumSupportVectors, out NumSVPerSVM); 
112 说明,  get_support_vector_num_ocr_class_svm,返回OCR分级器支持的矢量的数目。
113 
114 ** GetSupportVectorOcrClassSvm( OCRHandle, IndexSupportVector, out Index); 
115 说明,  get_support_vector_ocr_class_svm,返回基于支持向量机的已测试OCR分级器中支持向量坐标。
116 
117 ** InfoOcrClassBox( OCRHandle, out WidthPattern, out HeightPattern, out Interpolation, out WidthMaxChar, out HeightMaxChar, out Features, out Characters); 
118 说明,  info_ocr_class_box,反馈ocr的有关信息。
119 
120 ** OcrChangeChar( OCRHandle, Character); 
121 说明,  ocr_change_char,为字符建立新的查阅表。
122 
123 ** OcrGetFeatures( Character: X; OCRHandle, out FeatureVector); 
124 说明,  ocr_get_features,计算给定Character（字符）的特征参数。
125 
126 ** ProtectOcrTrainf( TrainingFile, Password, TrainingFileProtected);
127 
128 ** ReadOcr( FileName, out OCRHandle); 
129 说明,  read_ocr,从文件的FileName（文件名）读取OCR分级器。
130 
131 ** ReadOcrClassKnn( FileName, out OCRHandle); 
132 说明,  读取ocr-knn数据
133 
134 ** ReadOcrClassMlp( FileName, out OCRHandle); 
135 说明,  read_ocr_class_mlp,从一个文件中读取OCR分级器。
136 
137 ** ReadOcrClassSvm( FileName, out OCRHandle); 
138 说明,  read_ocr_class_svm,从文件中读取基于OCR分级器的SVM。
139 
140 ** ReadOcrTrainf( out Characters: X; TrainingFile, out CharacterNames); 
141 说明,  read_ocr_trainf,从文件中读取字符，将其转换到图像中。
142 
143 ** ReadOcrTrainfNames( TrainingFile, out CharacterNames, out CharacterCount); 
144 说明,  read_ocr_trainf_names,查询哪些字符存储在测试文件中。
145 
146 ** ReadOcrTrainfNamesProtected( TrainingFile, Password, out CharacterNames, out CharacterCount); 
147 说明,  读取ocr数据
148 
149 ** ReadOcrTrainfSelect( out Characters: X; TrainingFile, SearchNames, out FoundNames); 
150 说明,  read_ocr_trainf_select,从文件中读取测试特定字符，将其转换到图像中。
151 
152 ** ReduceOcrClassSvm( OCRHandle, Method, MinRemainingSV, MaxError, out OCRHandleReduced); 
153 说明,  reduce_ocr_class_svm,根据一个减小的SVM来接近一个基于OCR分级器的SVM。
154 
155 ** SelectFeatureSetTrainfKnn( TrainingFile, FeatureList, SelectionMethod, Width, Height, GenParamNames, GenParamValues, out OCRHandle, out FeatureSet, out Score); 
156 说明,  根据knn训练参数特征选择对象
157 
158 ** SelectFeatureSetTrainfMlp( TrainingFile, FeatureList, SelectionMethod, Width, Height, GenParamNames, GenParamValues, out OCRHandle, out FeatureSet, out Score); 
159 说明,  根据mlp训练参数特征选择对象
160 
161 ** SelectFeatureSetTrainfMlpProtected( TrainingFile, Password, FeatureList, SelectionMethod, Width, Height, GenParamNames, GenParamValues, out OCRHandle, out FeatureSet, out Score); 
162 说明,  根据mlp训练参数特征选择对象
163 
164 ** SelectFeatureSetTrainfSvm( TrainingFile, FeatureList, SelectionMethod, Width, Height, GenParamNames, GenParamValues, out OCRHandle, out FeatureSet, out Score); 
165 说明,  根据svm训练参数特征选择对象
166 
167 ** SelectFeatureSetTrainfSvmProtected( TrainingFile, Password, FeatureList, SelectionMethod, Width, Height, GenParamNames, GenParamValues, out OCRHandle, out FeatureSet, out Score); 
168 说明,  根据svm训练参数特征选择对象
169 
170 ** SerializeOcr( OCRHandle, out SerializedItemHandle); 
171 说明,  ocr数据序列化
172 
173 ** SerializeOcrClassKnn( OCRHandle, out SerializedItemHandle); 
174 说明,  knn分类器数据序列化
175 
176 ** SerializeOcrClassMlp( OCRHandle, out SerializedItemHandle); 
177 说明,  mlp分类器数据序列化
178 
179 ** SerializeOcrClassSvm( OCRHandle, out SerializedItemHandle); 
180 说明,  svm分类器数据序列化
181 
182 ** TestdOcrClassBox( Character: X; Image: X; OCRHandle, Class_, out Confidence); 
183 说明,  testd_ocr_class_box,测试给定类中字符的置信度。
184 
185 ** TraindOcrClassBox( Character: X; Image: X; OCRHandle, Class_, out AvgConfidence); 
186 说明,  traind_ocr_class_box,通过一幅图像的特定区域直接测试分级器。
187 
188 ** TrainfOcrClassBox( OCRHandle, TrainingFile, out AvgConfidence); 
189 说明,  trainf_ocr_class_box,根据指定测试文件测试分级器的OCRHandle。
190 
191 ** TrainfOcrClassKnn( OCRHandle, TrainingFile, GenParamNames, GenParamValues); 
192 说明,  ocr-knn分类器训练
193 
194 ** TrainfOcrClassMlp( OCRHandle, TrainingFile, MaxIterations, WeightTolerance, ErrorTolerance, out Error, out ErrorLog); 
195 说明,  trainf_ocr_class_mlp,测试OCR分级器的OCRHandle，根据存储在OCR文件中的测试特性。
196 
197 ** TrainfOcrClassMlpProtected( OCRHandle, TrainingFile, Password, MaxIterations, WeightTolerance, ErrorTolerance, out Error, out ErrorLog); 
198 说明,  ocr-mlp分类器训练
199 
200 ** TrainfOcrClassSvm( OCRHandle, TrainingFile, Epsilon, TrainMode); 
201 说明,  trainf_ocr_class_svm,测试一个OCR分级器。
202 
203 ** TrainfOcrClassSvmProtected( OCRHandle, TrainingFile, Password, Epsilon, TrainMode); 
204 说明,  ocr-svm分类器训练
205 
206 ** WriteOcr( OCRHandle, FileName); 
207 说明,  write_ocr,将OCR分级器的OCRHandle写入文件的FileName（文件名）。
208 
209 ** WriteOcrClassKnn( OCRHandle, FileName); 
210 说明,  保存ocr-knn分类器数据
211 
212 ** WriteOcrClassMlp( OCRHandle, FileName); 
213 说明,  write_ocr_class_mlp,将OCR分级器的OCRHandle写入由文件名确定的文件中。
214 
215 ** WriteOcrClassSvm( OCRHandle, FileName); 
216 说明,  write_ocr_class_svm,将一个OCR分级器写入文件。
217 
218 ** WriteOcrTrainf( Character: X; Image: X; Class_, TrainingFile); 
219 说明,  write_ocr_trainf,将已测试的字符存储到文件中。
220 
221 ** WriteOcrTrainfImage( Character: X; Class_, TrainingFile); 
222 说明,  write_ocr_trainf_image,将字符写入正在测试的文件中。
223 
224 ** ZeroCrossing( Image: X; out RegionCrossing: X); 
225 说明,  zero_crossing,从一幅图像中提取零相交。
226 
227 ** ZeroCrossingsFunct1D( Function_, out ZeroCrossings); 
228 说明,  zero_crossings_funct_1d,计算一个函数的零点。
229 
230 ** ZeroCrossingSubPix( Image: X; out ZeroCrossings: X); 
231 说明,  zero_crossing_sub_pix,根据子像素准确性从一幅图像中提取零相交。