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

 ** CountRelation( RelationName, out NumOfTuples);
 说明,  count_relation,在HALCON数据库中实体的数目。

 ** DeserializeTuple( SerializedItemHandle, out Tuple);
 说明,  Tuple元组数据转换

 ** IntegerToObj( out Objects: X; SurrogateTuple);
 说明,  integer_to_obj,将一个整型数转换为一个图标。

 ** ObjToInteger( Objects: X; Index, Number, out SurrogateTuple);
 说明,  obj_to_integer,将一个图标转换为一个整型数。

 ** ReadTuple( FileName, out Tuple);
 说明,  read_tuple,从一个文件中读取一个数组。

 ** ReceiveTuple( Socket, out Tuple);
 说明,  receive_tuple,通过插口连接接收一个元组。

 ** SendTuple( Socket, Tuple);
 说明,  send_tuple,通过插口连接发送一个元组。

 ** SerializeTuple( Tuple, out SerializedItemHandle);
 说明,  tuple元组数据序列化

 ** TupleAbs( T, out Abs);
 说明,  tuple_abs,计算一个元组的绝对值。

 ** TupleAcos( T, out ACos);
 说明,  tuple_acos,计算一个元组的反余弦。

 ** TupleAdd( S1, S2, out Sum);
 说明,  tuple_add,两个元组相加。

 ** TupleAnd( T1, T2, out And_);
 说明,  tuple_and,两个元组的逻辑与。

 ** TupleAsin( T, out ASin);
 说明,  tuple_asin,计算一个元组的反余弦。

 ** TupleAtan( T, out ATan);
 说明,  tuple_atan,计算一个元组的反正切。

 ** TupleAtan2( Y, X, out ATan);
 说明,  tuple_atan2,计算一个元组四个象限的反正切。

 ** TupleBand( T1, T2, out BAnd);
 说明,  tuple_band,计算两个元组的按位运算。

 ** TupleBnot( T, out BNot);
 说明,  tuple_bnot,两个元组逐位取逻辑非。

 ** TupleBor( T1, T2, out BOr);
 说明,  tuple_bor,计算两个元组的按位运算。

 ** TupleBxor( T1, T2, out BXor);
 说明,  tuple_bxor,两个元组逐位进行互斥逻辑或运算。

 ** TupleCeil( T, out Ceil);
 说明,  tuple_ceil,计算一个元组的上限函数。

 ** TupleChr( T, out Chr);
 说明,  tuple_chr,根据ASCII码将整型元组转换为字符串。

 ** TupleChrt( T, out Chrt);
 说明,  tuple_chrt,根据ASCII码将整型元组转换为字符串。

 ** TupleConcat( T1, T2, out Concat);
 说明,  tuple_concat,合并两个元组为一个新的。

 ** TupleCos( T, out Cos);
 说明,  tuple_cos,计算一个元组的余弦。

 ** TupleCosh( T, out Cosh);
 说明,  tuple_cosh,计算一个元组的双曲余弦。

 ** TupleCumul( Tuple, out Cumul);
 说明,  tuple_cumul,计算一个元组的累计和。

 ** TupleDeg( Rad, out Deg);
 说明,  tuple_deg,将一个元组从弧度转换为角度。

 ** TupleDeviation( Tuple, out Deviation);
 说明,  tuple_deviation,返回一个元组元素的标准差。

 ** TupleDiv( Q1, Q2, out Quot);
 说明,  tuple_div,将两个元组相除。

 ** TupleEnvironment( Names, out Values);
 说明,  tuple_environment,读取一个或多个环境变量。

 ** TupleEqual( T1, T2, out Equal);
 说明,  tuple_equal,测试两个元组是否相同。

 ** TupleEqualElem( T1, T2, out Equal);
 说明,  测试两个元组元素是否相同。

 ** TupleExp( T, out Exp);
 说明,  tuple_exp,元组的指数运算。

 ** TupleFabs( T, out Abs);
 说明,  tuple_fabs,计算一个元组（例如浮点数）的绝对值。

 ** TupleFind( Tuple, ToFind, out Indices);
 说明,  tuple_find,返回一个元组所有出现的符号，同时位于另一个元组内。

 ** TupleFirstN( Tuple, Index, out Selected);
 说明,  tuple_first_n,选取一个元组的第一个元素。

 ** TupleFloor( T, out Floor);
 说明,  tuple_floor,计算一个元组的地板函数”。

 ** TupleFmod( T1, T2, out Fmod);
 说明,  tuple_fmod,计算两个元组浮点数相除的余数。

 ** TupleGen( Length, _, out Newtuple);
 说明,  tuple_gen_const,创建一个特殊长度的元组和初始化它的元素。

 ** TupleGenSequence( Start, End_, Step, out Sequence);
 说明,  创建等序化的元组和初始化它的元素。

 ** TupleGreater( T1, T2, out Greater);
 说明,  tuple_greater,测试一个元组是否大于另一个元组。

 ** TupleGreaterElem( T1, T2, out Greater);
 说明,  测试一个元组元素是否大于等于另一个。

 ** TupleGreaterEqual( T1, T2, out Greatereq);
 说明,  tuple_greater_equal,测试一个元组是否大于等于另一个。

 ** TupleGreaterEqualElem( T1, T2, out Greatereq);
 说明,  测试一个元组元素是否等于另一个。

 ** TupleHistoRange( Tuple, Min, Max, NumBins, out Histo, out BinSize);
 说明,  元组直方图

 ** TupleInsert( Tuple, Index, InsertTuple, out Extended);
 说明,  元组插入

 ** TupleInt( T, out Int);
 说明,  tuple_int,讲一个元组转换为一个整型元组。

 ** TupleInverse( Tuple, out Inverted);
 说明,  tuple_inverse,将一个元组反置（反转）。

 ** TupleIsInt( T, out IsInt);
 说明,  元组整数测试

 ** TupleIsIntElem( T, out IsInt);
 说明,  元组元素整数测试

 ** TupleIsMixed( T, out IsMixed);
 说明,  元组混合测试

 ** TupleIsNumber( T, out IsNumber);
 说明,  tuple_is_number,检测一个字符串元组是否表示数字。

 ** TupleIsReal( T, out IsReal);
 说明,  元组实数测试

 ** TupleIsRealElem( T, out IsReal);
 说明,  元组元素实数测试

 ** TupleIsString( T, out IsString);
 说明,  元组字符串测试

 ** TupleIsStringElem( T, out IsString);
 说明,  元组元素字符串测试

 ** TupleLastN( Tuple, Index, out Selected);
 说明,  tuple_last_n,选择从符号n”开始到元组末尾的所有元素。

 ** TupleLdexp( T1, T2, out Ldexp);
 说明,  tuple_ldexp,计算两个元组的返回长双精度指数函数。

 ** TupleLength( Tuple, out Length);
 说明,  tuple_length,返回一个元组元素数目。

 ** TupleLess( T1, T2, out Less);
 说明,  tuple_less,测试一个元组是否小于另一个元组。

 ** TupleLessElem( T1, T2, out Less);
 说明,  测试一个元组元素是否小于另一个元组。

 ** TupleLessEqual( T1, T2, out Lesseq);
 说明,  tuple_less_equal,测试一个元组是否小于等于另一个。

 ** TupleLessEqualElem( T1, T2, out Lesseq);

 ** TupleLog( T, out Log);
 说明,  tuple_log,计算一个元组的自然对数。

 ** TupleLog10( T, out Log);
 说明,  tuple_log10,计算一个元组底为10的对数。

 ** TupleLsh( T, Shift, out Lsh);
 说明,  tuple_lsh,元组逐位左移。

 ** TupleMax( Tuple, out Max);
 说明,  tuple_max,返回一个元组的最大元素。

 ** TupleMax2( T1, T2, out Max2);
 说明,  tuple_max2,计算两个元组的元素宽度的最大值。

 ** TupleMean( Tuple, out Mean);
 说明,  tuple_mean,返回一定数量元组的平均值。

 ** TupleMedian( Tuple, out Median);
 说明,  tuple_median,返回一个元组元素的中值。

 ** TupleMin( Tuple, out Min);
 说明,  tuple_min,返回一个元组的最小元素。

 ** TupleMin2( T1, T2, out Min2);
 说明,  tuple_min2,计算两个元组的元素宽度的最小值。

 ** TupleMod( T1, T2, out Mod_);
 说明,  tuple_mod,计算两个元组整型数相除的余数。

 ** TupleMult( P1, P2, out Prod);
 说明,  tuple_mult,两个元组相乘。

 ** TupleNeg( T, out Neg);
 说明,  tuple_neg,将一个元组取反。

 ** TupleNot( T, out Not_);
 说明,  tuple_not,两个元组的逻辑非。

 ** TupleNotEqual( T1, T2, out Nequal);
 说明,  tuple_not_equal,测试两个元组是不是不等。

 ** TupleNotEqualElem( T1, T2, out Nequal);
 说明,  测试两个元组元素是不是不等。

 ** TupleNumber( T, out Number);
 说明,  tuple_number,将一个字符串元组转换为一个数字元组。

 ** TupleOr( T1, T2, out Or_);
 说明,  tuple_or,两个元组的逻辑或。

 ** TupleOrd( T, out Ord);
 说明,  tuple_ord,将长度为1的字符串的元组转换为它们相应的ASCII码元组。

 ** TupleOrds( T, out Ords);
 说明,  tuple_ords,将一个字符串的元组转换为它们ASCII码的元组。

 ** TuplePow( T1, T2, out Pow);
 说明,  tuple_pow,计算两个元组的冥函数。

 ** TupleRad( Deg, out Rad);
 说明,  tuple_rad,将一个元组从角度转换为弧度。

 ** TupleRand( Length, out Rand);
 说明,  tuple_rand,返回任意值为0或1的元组。

 ** TupleReal( T, out Real);
 说明,  tuple_real,将一个元组转换为一个浮点数的元组。

 ** TupleRegexpMatch( Data, Expression, out Matches);
 说明,  tuple_regexp_match,利用公式提取子链。

 ** TupleRegexpReplace( Data, Expression, Replace, out Result);
 说明,  tuple_regexp_replace,用有规律的公式代替一个子链。

 ** TupleRegexpSelect( Data, Expression, out Selection);
 说明,  tuple_regexp_select,选择符合公式的元组元素。

 ** TupleRegexpTest( Data, Expression, out NumMatches);
 说明,  tuple_regexp_test,测试一个字符串是否满足一个规则公式的要求。

 ** TupleRemove( Tuple, Index, out Reduced);
 说明,  tuple_remove,从一个元组中移出元素。

 ** TupleReplace( Tuple, Index, ReplaceTuple, out Replaced);
 说明,  元组替换

 ** TupleRound( T, out Round);
 说明,  tuple_round,将一个元组转换为一个整型数的元组。

 ** TupleRsh( T, Shift, out Rsh);
 说明,  tuple_rsh,元组逐位右移。

 ** TupleSelect( Tuple, Index, out Selected);
 说明,  tuple_select,选择一个元组中单一元素。

 ** TupleSelectMask( Tuple, Mask, out Selected);
 说明,  选择元组掩码

 ** TupleSelectRange( Tuple, Leftindex, Rightindex, out Selected);
 说明,  tuple_select_range,选择一个元组中的一些元素。

 ** TupleSelectRank( Tuple, RankIndex, out Selected);
 说明,  tuple_select_rank,选择一个元组中序号为n的元素。

 ** TupleSgn( T, out Sgn);
 说明,  tuple_sgn,计算一个元组的正负。

 ** TupleSin( T, out Sin);
 说明,  tuple_sin,计算一个元组的正弦。

 ** TupleSinh( T, out Sinh);
 说明,  tuple_sinh,计算一个元组的双曲正弦。

 ** TupleSort( Tuple, out Sorted);
 说明,  tuple_sort,按照升序分类（排列）元组的元素。

 ** TupleSortIndex( Tuple, out Indices);
 说明,  tuple_sort_index,将元组的元素分类并返回分类元组的目录。

 ** TupleSplit( String_, Separator, out Substrings);
 说明,  tuple_split,在预定义的独立字符间将字符串分离为子链。

 ** TupleSqrt( T, out Sqrt);
 说明,  tuple_sqrt,计算一个元组的平方根（二次方根）。

 ** TupleStrBitSelect( Tuple, Index, out Selected);
 说明,  tuple_str_bit_select,选择一个元组中单一符号或位。

 ** TupleStrchr( String_, ToFind, out Position);
 说明,  tuple_strchr,前向搜索一个位于字符串元组内的字符。

 ** TupleStrFirstN( String_, Position, out Substring);
 说明,  tuple_str_first_n,分割从第一个字符直到字符串元组外的位置n”处。

 ** TupleString( T, Format, out String_);
 说明,  tuple_string,将一个元组转换为一个字符串元组。

 ** TupleStrLastN( String_, Position, out Substring);
 说明,  tuple_str_last_n,从字符串元组外位置n”处开始分割所有的字符。

 ** TupleStrlen( T1, out Length);
 说明,  tuple_strlen,字符串元组中每个字符串的长度。

 ** TupleStrrchr( String_, ToFind, out Position);
 说明,  tuple_strrchr,后向搜索一个位于字符串元组内的字符。

 ** TupleStrrstr( String_, ToFind, out Position);
 说明,  tuple_strrstr,后向搜索一个位于字符串元组内的字符串。

 ** TupleStrstr( String_, ToFind, out Position);
 说明,  tuple_strstr,前向搜索一个位于字符串元组内的字符串。

 ** TupleSub( D1, D2, out Diff);
 说明,  tuple_sub,两个元组相减。

 ** TupleSubstr( String_, Position1, Position2, out Substring);
 说明,  两个元组字符串相减。

 ** TupleSum( Tuple, out Sum);
 说明,  tuple_sum,返回一个元组所有元素的和。

 ** TupleTan( T, out Tan);
 说明,  tuple_tan,计算一个元组的正切。

 ** TupleTanh( T, out Tanh);
 说明,  tuple_tanh,计算一个远足的双曲正切。

 ** TupleType( T, out Type_);
 说明,  两个元组类型

 ** TupleTypeElem( T, out Types);
 说明,  两个元组元素类型

 ** TupleUniq( Tuple, out Uniq);
 说明,  tuple_uniq,丢弃元组中除成功归类的元素外的所有元素。

 ** TupleXor( T1, T2, out Xor_);
 说明,  tuple_xor,两个元组的逻辑互斥或。

 ** WriteTuple( Tuple, FileName);
 说明,  write_tuple,向一个文件中写入一个数组。