2026/4/5 21:23:20
网站建设
项目流程
2345浏览器网站进入,郑州网站设计公司排名,微信开发者平台入口,阳江市网站建设HALCON算子 reset_metrology_object_fuzzy_param 全解析
一、算子核心定位
reset_metrology_object_fuzzy_param 是HALCON 2D计量#xff08;2D Metrology#xff09;模块的参数重置类算子#xff0c;核心功能是清除指定计量对象中所有通过set_metrology_object_fuzzy_param…HALCON算子reset_metrology_object_fuzzy_param全解析一、算子核心定位reset_metrology_object_fuzzy_param是HALCON 2D计量2D Metrology模块的参数重置类算子核心功能是清除指定计量对象中所有通过set_metrology_object_fuzzy_param配置的模糊参数和模糊函数恢复其默认值。它专门针对2D计量模型中的“模糊规则配置”做重置不影响计量对象的普通参数如测量长度、Sigma、振幅阈值等是调试模糊规则、回滚模糊配置的关键工具。二、算法核心原理句柄与索引校验验证输入的计量模型句柄MetrologyHandle有效性并解析Index参数确定要重置的计量对象范围all遍历所有指定索引则仅处理对应对象模糊参数定位针对每个指定的计量对象定位其内存中存储的所有模糊参数/模糊函数如模糊评分阈值、边缘类型模糊规则、尺寸模糊区间等参数重置清除已配置的模糊参数/函数将所有模糊相关属性恢复为HALCON默认值状态同步修改MetrologyHandle对应的计量模型内存状态因此该句柄被标记为“状态可修改”无返回结果仅执行重置操作无输出参数仅通过返回值H_MSG_TRUE确认执行成功。三、参数全详解一输入参数Input Parameters参数名类型功能说明默认值关键取值规则注意事项MetrologyHandlemetrology_model → (handle)input_control, state is modified指定要重置的2D计量模型句柄-必须为已有效创建/加载的计量模型句柄1. 需通过create_metrology_model/read_metrology_model生成未被clear_metrology_model释放2. 该算子会修改句柄对应的模型状态多线程使用时需同步访问3. 无效句柄直接抛出“句柄无效”异常Indexinteger(-array) → (string / integer)指定要重置的计量对象索引‘all’可选值▪ ‘all’重置模型内所有计量对象的模糊参数▪ 整数/整数数组重置指定索引的计量对象如0、[0,1]1. 整数索引必须是get_metrology_object_indices返回的有效索引2. 若Index为数组会按顺序重置每个索引对应的对象二输出参数该算子无输出参数仅通过返回值2H_MSG_TRUE确认执行成功。四、使用关键注意事项作用范围约束仅重置模糊参数/模糊函数由set_metrology_object_fuzzy_param设置的参数完全不影响普通参数如num_instances、Sigma、measure_length等这些需用reset_metrology_object_param重置句柄状态修改MetrologyHandle是“状态可修改的输入参数”执行该算子后模型的内部状态会变化若多线程同时访问该句柄如一个线程重置、一个线程读取模糊参数必须做同步处理否则可能导致参数读取异常默认值恢复规则重置后所有模糊相关参数回到HALCON出厂默认值如模糊评分阈值恢复为0.5、无自定义模糊函数等需重新调用set_metrology_object_fuzzy_param才能配置新的模糊规则多线程特性多线程类型可重入能与非排他算子并行运行多线程范围全局可从任意线程调用无并行优化仅单线程执行重置操作关键提醒因修改句柄状态跨线程使用该句柄时需手动同步返回值规则执行成功返回2H_MSG_TRUE参数无效如索引错误、句柄无效时直接抛出异常而非返回错误码执行时序无约束无需先调用apply_metrology_model可在创建计量对象后、配置模糊参数后任意时机调用。五、算子调用链路一前置算子Possible Predecessorscreate_metrology_model创建空2D计量模型基础前置add_metrology_object_*如add_metrology_object_circle_measure向模型添加计量对象set_metrology_object_fuzzy_param配置模糊参数/函数该算子的核心前置无此操作则重置无实际意义read_metrology_model加载含模糊参数配置的计量模型可选。二后置算子Possible Successorsset_metrology_object_fuzzy_param重新配置模糊参数/函数最常用后置apply_metrology_model使用重置后的模糊默认参数执行检测get_metrology_object_fuzzy_param验证模糊参数是否已恢复默认值clear_metrology_model释放计量模型句柄收尾操作。六、与相似算子的核心差异算子名称核心区别适用场景reset_metrology_object_fuzzy_param仅重置模糊参数/模糊函数恢复其默认值调试模糊规则、回滚错误的模糊配置reset_metrology_object_param仅重置普通参数如Sigma、振幅阈值、num_instances等恢复其默认值调试普通测量参数、回滚错误的基础配置clear_metrology_model释放整个计量模型句柄销毁所有参数含模糊普通彻底清理模型释放内存八、总结关键点回顾reset_metrology_object_fuzzy_param核心作用是清除指定计量对象的所有模糊参数/函数恢复其默认值仅作用于模糊相关配置不影响普通测量参数该算子会修改计量模型句柄的状态多线程访问该句柄时需手动同步重置后需重新调用set_metrology_object_fuzzy_param才能配置新的模糊规则常用于调试模糊规则时的回滚操作。