《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,向一个文件中写入一个数组。