《zw版·Halcon-delphi系列原创教程》 Halcon分类函数014,tuple，元组

《zw版·Halcon-delphi系列原创教程》 Halcon分类函数014,tuple，元组

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

• :: 用符号“**”，替换：“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 ** CountRelation( RelationName, out NumOfTuples);
  2 说明,  count_relation,在HALCON数据库中实体的数目。
  3
  4 ** DeserializeTuple( SerializedItemHandle, out Tuple);
  5 说明,  Tuple元组数据转换
  6
  7 ** IntegerToObj( out Objects: X; SurrogateTuple);
  8 说明,  integer_to_obj,将一个整型数转换为一个图标。
  9
 10 ** ObjToInteger( Objects: X; Index, Number, out SurrogateTuple);
 11 说明,  obj_to_integer,将一个图标转换为一个整型数。
 12
 13 ** ReadTuple( FileName, out Tuple);
 14 说明,  read_tuple,从一个文件中读取一个数组。
 15
 16 ** ReceiveTuple( Socket, out Tuple);
 17 说明,  receive_tuple,通过插口连接接收一个元组。
 18
 19 ** SendTuple( Socket, Tuple);
 20 说明,  send_tuple,通过插口连接发送一个元组。
 21
 22 ** SerializeTuple( Tuple, out SerializedItemHandle);
 23 说明,  tuple元组数据序列化
 24
 25 ** TupleAbs( T, out Abs);
 26 说明,  tuple_abs,计算一个元组的绝对值。
 27
 28 ** TupleAcos( T, out ACos);
 29 说明,  tuple_acos,计算一个元组的反余弦。
 30
 31 ** TupleAdd( S1, S2, out Sum);
 32 说明,  tuple_add,两个元组相加。
 33
 34 ** TupleAnd( T1, T2, out And_);
 35 说明,  tuple_and,两个元组的逻辑与。
 36
 37 ** TupleAsin( T, out ASin);
 38 说明,  tuple_asin,计算一个元组的反余弦。
 39
 40 ** TupleAtan( T, out ATan);
 41 说明,  tuple_atan,计算一个元组的反正切。
 42
 43 ** TupleAtan2( Y, X, out ATan);
 44 说明,  tuple_atan2,计算一个元组四个象限的反正切。
 45
 46 ** TupleBand( T1, T2, out BAnd);
 47 说明,  tuple_band,计算两个元组的按位运算。
 48
 49 ** TupleBnot( T, out BNot);
 50 说明,  tuple_bnot,两个元组逐位取逻辑非。
 51
 52 ** TupleBor( T1, T2, out BOr);
 53 说明,  tuple_bor,计算两个元组的按位运算。
 54
 55 ** TupleBxor( T1, T2, out BXor);
 56 说明,  tuple_bxor,两个元组逐位进行互斥逻辑或运算。
 57
 58 ** TupleCeil( T, out Ceil);
 59 说明,  tuple_ceil,计算一个元组的上限函数。
 60
 61 ** TupleChr( T, out Chr);
 62 说明,  tuple_chr,根据ASCII码将整型元组转换为字符串。
 63
 64 ** TupleChrt( T, out Chrt);
 65 说明,  tuple_chrt,根据ASCII码将整型元组转换为字符串。
 66
 67 ** TupleConcat( T1, T2, out Concat);
 68 说明,  tuple_concat,合并两个元组为一个新的。
 69
 70 ** TupleCos( T, out Cos);
 71 说明,  tuple_cos,计算一个元组的余弦。
 72
 73 ** TupleCosh( T, out Cosh);
 74 说明,  tuple_cosh,计算一个元组的双曲余弦。
 75
 76 ** TupleCumul( Tuple, out Cumul);
 77 说明,  tuple_cumul,计算一个元组的累计和。
 78
 79 ** TupleDeg( Rad, out Deg);
 80 说明,  tuple_deg,将一个元组从弧度转换为角度。
 81
 82 ** TupleDeviation( Tuple, out Deviation);
 83 说明,  tuple_deviation,返回一个元组元素的标准差。
 84
 85 ** TupleDiv( Q1, Q2, out Quot);
 86 说明,  tuple_div,将两个元组相除。
 87
 88 ** TupleEnvironment( Names, out Values);
 89 说明,  tuple_environment,读取一个或多个环境变量。
 90
 91 ** TupleEqual( T1, T2, out Equal);
 92 说明,  tuple_equal,测试两个元组是否相同。
 93
 94 ** TupleEqualElem( T1, T2, out Equal);
 95 说明,  测试两个元组元素是否相同。
 96
 97 ** TupleExp( T, out Exp);
 98 说明,  tuple_exp,元组的指数运算。
 99
100 ** TupleFabs( T, out Abs);
101 说明,  tuple_fabs,计算一个元组（例如浮点数）的绝对值。
102
103 ** TupleFind( Tuple, ToFind, out Indices);
104 说明,  tuple_find,返回一个元组所有出现的符号，同时位于另一个元组内。
105
106 ** TupleFirstN( Tuple, Index, out Selected);
107 说明,  tuple_first_n,选取一个元组的第一个元素。
108
109 ** TupleFloor( T, out Floor);
110 说明,  tuple_floor,计算一个元组的地板函数”。
111
112 ** TupleFmod( T1, T2, out Fmod);
113 说明,  tuple_fmod,计算两个元组浮点数相除的余数。
114
115 ** TupleGen( Length, _, out Newtuple);
116 说明,  tuple_gen_const,创建一个特殊长度的元组和初始化它的元素。
117
118 ** TupleGenSequence( Start, End_, Step, out Sequence);
119 说明,  创建等序化的元组和初始化它的元素。
120
121 ** TupleGreater( T1, T2, out Greater);
122 说明,  tuple_greater,测试一个元组是否大于另一个元组。
123
124 ** TupleGreaterElem( T1, T2, out Greater);
125 说明,  测试一个元组元素是否大于等于另一个。
126
127 ** TupleGreaterEqual( T1, T2, out Greatereq);
128 说明,  tuple_greater_equal,测试一个元组是否大于等于另一个。
129
130 ** TupleGreaterEqualElem( T1, T2, out Greatereq);
131 说明,  测试一个元组元素是否等于另一个。
132
133 ** TupleHistoRange( Tuple, Min, Max, NumBins, out Histo, out BinSize);
134 说明,  元组直方图
135
136 ** TupleInsert( Tuple, Index, InsertTuple, out Extended);
137 说明,  元组插入
138
139 ** TupleInt( T, out Int);
140 说明,  tuple_int,讲一个元组转换为一个整型元组。
141
142 ** TupleInverse( Tuple, out Inverted);
143 说明,  tuple_inverse,将一个元组反置（反转）。
144
145 ** TupleIsInt( T, out IsInt);
146 说明,  元组整数测试
147
148 ** TupleIsIntElem( T, out IsInt);
149 说明,  元组元素整数测试
150
151 ** TupleIsMixed( T, out IsMixed);
152 说明,  元组混合测试
153
154 ** TupleIsNumber( T, out IsNumber);
155 说明,  tuple_is_number,检测一个字符串元组是否表示数字。
156
157 ** TupleIsReal( T, out IsReal);
158 说明,  元组实数测试
159
160 ** TupleIsRealElem( T, out IsReal);
161 说明,  元组元素实数测试
162
163 ** TupleIsString( T, out IsString);
164 说明,  元组字符串测试
165
166 ** TupleIsStringElem( T, out IsString);
167 说明,  元组元素字符串测试
168
169 ** TupleLastN( Tuple, Index, out Selected);
170 说明,  tuple_last_n,选择从符号n”开始到元组末尾的所有元素。
171
172 ** TupleLdexp( T1, T2, out Ldexp);
173 说明,  tuple_ldexp,计算两个元组的返回长双精度指数函数。
174
175 ** TupleLength( Tuple, out Length);
176 说明,  tuple_length,返回一个元组元素数目。
177
178 ** TupleLess( T1, T2, out Less);
179 说明,  tuple_less,测试一个元组是否小于另一个元组。
180
181 ** TupleLessElem( T1, T2, out Less);
182 说明,  测试一个元组元素是否小于另一个元组。
183
184 ** TupleLessEqual( T1, T2, out Lesseq);
185 说明,  tuple_less_equal,测试一个元组是否小于等于另一个。
186
187 ** TupleLessEqualElem( T1, T2, out Lesseq);
188
189 ** TupleLog( T, out Log);
190 说明,  tuple_log,计算一个元组的自然对数。
191
192 ** TupleLog10( T, out Log);
193 说明,  tuple_log10,计算一个元组底为10的对数。
194
195 ** TupleLsh( T, Shift, out Lsh);
196 说明,  tuple_lsh,元组逐位左移。
197
198 ** TupleMax( Tuple, out Max);
199 说明,  tuple_max,返回一个元组的最大元素。
200
201 ** TupleMax2( T1, T2, out Max2);
202 说明,  tuple_max2,计算两个元组的元素宽度的最大值。
203
204 ** TupleMean( Tuple, out Mean);
205 说明,  tuple_mean,返回一定数量元组的平均值。
206
207 ** TupleMedian( Tuple, out Median);
208 说明,  tuple_median,返回一个元组元素的中值。
209
210 ** TupleMin( Tuple, out Min);
211 说明,  tuple_min,返回一个元组的最小元素。
212
213 ** TupleMin2( T1, T2, out Min2);
214 说明,  tuple_min2,计算两个元组的元素宽度的最小值。
215
216 ** TupleMod( T1, T2, out Mod_);
217 说明,  tuple_mod,计算两个元组整型数相除的余数。
218
219 ** TupleMult( P1, P2, out Prod);
220 说明,  tuple_mult,两个元组相乘。
221
222 ** TupleNeg( T, out Neg);
223 说明,  tuple_neg,将一个元组取反。
224
225 ** TupleNot( T, out Not_);
226 说明,  tuple_not,两个元组的逻辑非。
227
228 ** TupleNotEqual( T1, T2, out Nequal);
229 说明,  tuple_not_equal,测试两个元组是不是不等。
230
231 ** TupleNotEqualElem( T1, T2, out Nequal);
232 说明,  测试两个元组元素是不是不等。
233
234 ** TupleNumber( T, out Number);
235 说明,  tuple_number,将一个字符串元组转换为一个数字元组。
236
237 ** TupleOr( T1, T2, out Or_);
238 说明,  tuple_or,两个元组的逻辑或。
239
240 ** TupleOrd( T, out Ord);
241 说明,  tuple_ord,将长度为1的字符串的元组转换为它们相应的ASCII码元组。
242
243 ** TupleOrds( T, out Ords);
244 说明,  tuple_ords,将一个字符串的元组转换为它们ASCII码的元组。
245
246 ** TuplePow( T1, T2, out Pow);
247 说明,  tuple_pow,计算两个元组的冥函数。
248
249 ** TupleRad( Deg, out Rad);
250 说明,  tuple_rad,将一个元组从角度转换为弧度。
251
252 ** TupleRand( Length, out Rand);
253 说明,  tuple_rand,返回任意值为0或1的元组。
254
255 ** TupleReal( T, out Real);
256 说明,  tuple_real,将一个元组转换为一个浮点数的元组。
257
258 ** TupleRegexpMatch( Data, Expression, out Matches);
259 说明,  tuple_regexp_match,利用公式提取子链。
260
261 ** TupleRegexpReplace( Data, Expression, Replace, out Result);
262 说明,  tuple_regexp_replace,用有规律的公式代替一个子链。
263
264 ** TupleRegexpSelect( Data, Expression, out Selection);
265 说明,  tuple_regexp_select,选择符合公式的元组元素。
266
267 ** TupleRegexpTest( Data, Expression, out NumMatches);
268 说明,  tuple_regexp_test,测试一个字符串是否满足一个规则公式的要求。
269
270 ** TupleRemove( Tuple, Index, out Reduced);
271 说明,  tuple_remove,从一个元组中移出元素。
272
273 ** TupleReplace( Tuple, Index, ReplaceTuple, out Replaced);
274 说明,  元组替换
275
276 ** TupleRound( T, out Round);
277 说明,  tuple_round,将一个元组转换为一个整型数的元组。
278
279 ** TupleRsh( T, Shift, out Rsh);
280 说明,  tuple_rsh,元组逐位右移。
281
282 ** TupleSelect( Tuple, Index, out Selected);
283 说明,  tuple_select,选择一个元组中单一元素。
284
285 ** TupleSelectMask( Tuple, Mask, out Selected);
286 说明,  选择元组掩码
287
288 ** TupleSelectRange( Tuple, Leftindex, Rightindex, out Selected);
289 说明,  tuple_select_range,选择一个元组中的一些元素。
290
291 ** TupleSelectRank( Tuple, RankIndex, out Selected);
292 说明,  tuple_select_rank,选择一个元组中序号为n的元素。
293
294 ** TupleSgn( T, out Sgn);
295 说明,  tuple_sgn,计算一个元组的正负。
296
297 ** TupleSin( T, out Sin);
298 说明,  tuple_sin,计算一个元组的正弦。
299
300 ** TupleSinh( T, out Sinh);
301 说明,  tuple_sinh,计算一个元组的双曲正弦。
302
303 ** TupleSort( Tuple, out Sorted);
304 说明,  tuple_sort,按照升序分类（排列）元组的元素。
305
306 ** TupleSortIndex( Tuple, out Indices);
307 说明,  tuple_sort_index,将元组的元素分类并返回分类元组的目录。
308
309 ** TupleSplit( String_, Separator, out Substrings);
310 说明,  tuple_split,在预定义的独立字符间将字符串分离为子链。
311
312 ** TupleSqrt( T, out Sqrt);
313 说明,  tuple_sqrt,计算一个元组的平方根（二次方根）。
314
315 ** TupleStrBitSelect( Tuple, Index, out Selected);
316 说明,  tuple_str_bit_select,选择一个元组中单一符号或位。
317
318 ** TupleStrchr( String_, ToFind, out Position);
319 说明,  tuple_strchr,前向搜索一个位于字符串元组内的字符。
320
321 ** TupleStrFirstN( String_, Position, out Substring);
322 说明,  tuple_str_first_n,分割从第一个字符直到字符串元组外的位置n”处。
323
324 ** TupleString( T, Format, out String_);
325 说明,  tuple_string,将一个元组转换为一个字符串元组。
326
327 ** TupleStrLastN( String_, Position, out Substring);
328 说明,  tuple_str_last_n,从字符串元组外位置n”处开始分割所有的字符。
329
330 ** TupleStrlen( T1, out Length);
331 说明,  tuple_strlen,字符串元组中每个字符串的长度。
332
333 ** TupleStrrchr( String_, ToFind, out Position);
334 说明,  tuple_strrchr,后向搜索一个位于字符串元组内的字符。
335
336 ** TupleStrrstr( String_, ToFind, out Position);
337 说明,  tuple_strrstr,后向搜索一个位于字符串元组内的字符串。
338
339 ** TupleStrstr( String_, ToFind, out Position);
340 说明,  tuple_strstr,前向搜索一个位于字符串元组内的字符串。
341
342 ** TupleSub( D1, D2, out Diff);
343 说明,  tuple_sub,两个元组相减。
344
345 ** TupleSubstr( String_, Position1, Position2, out Substring);
346 说明,  两个元组字符串相减。
347
348 ** TupleSum( Tuple, out Sum);
349 说明,  tuple_sum,返回一个元组所有元素的和。
350
351 ** TupleTan( T, out Tan);
352 说明,  tuple_tan,计算一个元组的正切。
353
354 ** TupleTanh( T, out Tanh);
355 说明,  tuple_tanh,计算一个远足的双曲正切。
356
357 ** TupleType( T, out Type_);
358 说明,  两个元组类型
359
360 ** TupleTypeElem( T, out Types);
361 说明,  两个元组元素类型
362
363 ** TupleUniq( Tuple, out Uniq);
364 说明,  tuple_uniq,丢弃元组中除成功归类的元素外的所有元素。
365
366 ** TupleXor( T1, T2, out Xor_);
367 说明,  tuple_xor,两个元组的逻辑互斥或。
368
369 ** WriteTuple( Tuple, FileName);
370 说明,  write_tuple,向一个文件中写入一个数组。