|
上位机HALCON视觉 system系统相关函数介绍
上位机HALCON视觉 system系统相关函数介绍
一．open_compute_device( : : DeviceIdentifier : DeviceHandle) 函数打开参数DeviceIdentifier指向的电脑设备。 返回结果保存在参数 DeviceHandle.。 通过函数activate_compute_device开关电脑设备DeviceHandle 二.release_compute_device( : : DeviceHandle : ) 关闭一个电脑设备DeviceHandle 三.query_available_compute_devices( : : : DeviceIdentifier)
函数返回可用的电脑设备列表。 使用get_compute_device_info查询一个指定的设备信息。 使用open_compute_device打开HALCON内的设备。 目前只支持OpenCL兼容的GPUs, GPUs支持扩展cl_khr_byte_addressable_store图像对象。 Radeon HD 5000系列的ATI/AMD板卡，或更新的版本也支持； 当前不支持通过Windows远程桌面使用OpenCL，因为Windows远程桌面不允许访问显卡驱动。 你可以使用VNC的解决方案在远程计算机上使用OpenCL。当然你可以在Linux机器上通过SSH使用OpenCL。 建议使用 最新的GPU的图形驱动程序。要在Linux系统上访问GPU，您应是 'video'组的成员。 四. activate_compute_device( : : DeviceHandle : ) 激活一个电脑设备 五. deactivate_compute_device( : : DeviceHandle : ) 停用指定电脑设备DeviceHandle 六. deactivate_all_compute_devices( : : : ) 停用全部的电脑设备 七. get_compute_device_info( : : DeviceIdentifier, InfoName : Info) 获取指定电脑设备的信息 不同于函数get_compute_device_param，此函数查询静态信息，使设备不必打开（参考open_compute_device）和激活（参考activate_compute_device） 八. set_compute_device_param( : : DeviceHandle, ParamName, ParamValue : )设置一个电脑设备的参数 九. get_compute_device_param( : : DeviceHandle, ParamName : ParamValue) 获取电脑设备参数信息 'alloc_pinned' 如果“true”，所有操作符的输出图像矩阵都是在页锁定（所谓的“钉住”）内存中创建的。'asynchronous_execution' 如果“true”，在电脑设备上执行的运算符不等待设备计算完成，但在启动计算之后返回。'buffer_cache_capacity' 计算设备缓冲区缓存的最大大小（以字节为单位）。 'buffer_cache_used' 计算设备缓冲区缓存的当前大小（以字节为单位） 'image_cache_capacity' 计算设备图像缓存的最大大小（以字节为单位）。 'image_cache_used' 计算设备图像缓存的当前大小（以字节为单位）。 'pinned_mem_cache_capacity' 页锁定（内存）内存缓存的最大大小（以字节为单位） 'pinned_mem_cache_used' 页面锁定内存缓存的当前大小（以字节为单位） 十. init_compute_device( : : DeviceHandle, Operators : ) 初始化电脑设备及在参数 Operators 准备一系列的算子。 此外，设备被激活为当前线程使用。 使用get_operator_info测试函数是否可以在计算设备上执行。 十一. release_all_compute_devices( : : : ) 关闭全部电脑设备 十二. count_relation( : : RelationName : NumOfTuples) 在通过传递参数’database'到set_system打开数据库后，HALCON的五个关系数据库之一的条目个数就可以通过此函数获得； HALCON的数据库由五个称作关系的表组成。在这种关系的单个条目称为数组，（不与Halcon元组命名对象数组混淆）。
如果启用，Halcon数据库包含区域数据，图像矩阵和xlds的基本关系，以及HALCON的对象和Halcon数组的容器关系。 HALCON的对象区域和图像由两个关系的元素组成：在区域数据关系中包含一个数组指针的区域。 一个映像还包括一个指向区域数据关系中的元组的指针（如一个区域） 另外还有一个或多个指向矩阵关系中的数组的指针。 如果有多个矩阵指针，则该图像称为多通道图像。
这两个区域和图像称为对象。一个区域可以看作是没有图像矩阵的图像的特殊情况。由于要有效管理内存的原因，区域数据关系和图像矩阵关系的数组将被不同的对象一起使用。 因此，可能有比图像矩阵更多的图像。 只有这两个低级的关系对内存消耗。图像对象（区域和图像）只包含区域和矩阵数据上的引用，因此只需要几个字节的内存。 例程: set_system('database','true') reset_obj_db(512,512,3) count_relation('image',I1) count_relation('region',R1) count_relation('XLD',X1) count_relation('object',O1) count_relation('tuple',T1) read_image(X,'monkey') count_relation('image',I2) count_relation('region',R2) count_relation('XLD',X2) count_relation('object',O2) count_relation('tuple',T2)
* * Result:I1 = 1 (undefined image) * R1 = 2 (full and empty region) * X1 = 0 (no XLD data) * O1 = 2 (full and empty objects) * T1 = 0 (always 0 in the normal mode )
* I2 = 2 (additionally the image 'monkey') * R2 = 2 (read_image uses the full region) *X2 = 0 (no XLD data) * O2 = 3 (additionally the image object X) * T2 = 0.
十三. get_modules( : : : UsedModules, ModuleKey) 获得当前所有函数(算子)使用的模块数量。 每个算子属于一个模块（最大值为32）。每个模块都有一个名字，保存在参数 UsedModules。 基于所使用的模块，生成了许可证管理器所需的密钥。get_modules通常是在一个程序结束后，用来检查使用的模块。
十四. reset_obj_db( : : DefaultImageWidth, DefaultImageHeight, DefaultChannels : ) 用于初始化 HALCON 系统 五个关系（灰度数据，区域数据，xlds，图像对象和tuplets对象）是HALCON图像处理所需要将安装的（参见count_relation）。 如果启用了HALCON数据库(set_system('database','true')）和关系已经存在，所有在关系里的数据项都被释放！ 参数defaultimagewidth和defaultimageheight提供全局最大图像尺寸的初始值。 如果第一次创建的对象是一个图像，（例如，read_image），设定值不被使用，如果是小于所创建的对象的大小。 另外，如果要创建的第一个对象是一个区域，新图像大于设置值时，才调整值。 这不是创建或读取的第一个图像的唯一情况：如果创建较大的图像，则全局图像大小将始终被放大。 全局图像大小用于随后打开的窗户（open_window）和内存评估，裁剪区域。 每当剪辑模式启动，会根据全局图像大小（set_system（'clip_region'TRUE'））进行区域剪辑。 如果使用不同大小的图像，这可能会导致问题。在这种情况下，只有一个区域小于或等于最大图像大小时才有效； 参数defaultchannels返回一个图像对象通道最频繁的数。 如果使用大部分区域，则该值可设置为0。 如果在一个图像中需要设置比初始设置的更多的信道，则该图像将动态地放大该数字。如果在初始化时设置的通道少于图像所必需的通道，则多余的通道将被设置为未定义。对于用户来说，这似乎是不存在的，但是，内存分配是不必要的。 参数值可通过 get_system.获取； 十四. get_check( : : : Check) 执行get_check用户可以查询什么样的控制方式当前使用与否。Check给出的数组包含控制模式的名称（参见set_check），如果相应的控制无效 前面加一个波浪号（~，例如，“~数据）。 十五. get_error_text( : : ErrorCode : ErrorMessage) 返回相应的HALCON的错误代码错误信息。 这与抛出异常提示文本相同。 如果错误处理是由用户自己编写的操作，函数get_error_text特别有用（参见set_check（：：“~give_error”：））。 运行代码查看效果: get_check (Check) dev_set_check ('give_error') dev_error_var (ErrorNum, 0) read_image(image,'fabrik') dev_error_var (ErrorNum, 1) get_error_text (ErrorNum, ErrorMessage)
在C++环境中可这么写 Herror err; char message[MAX_STRING];
set_check("~give_error"); err = send_region(region,socket_id); set_check("give_error"); if (err != H_MSG_TRUE) { get_error_text((Hlong)err,message); fprintf(stderr,"my error message: %s\n",message); exit(1); }
十六. get_extended_error_info( : : : OperatorName, ErrorCode, ErrorMessage) 返回当前线程最新的扩展错误信息 operatorname包含了halcon发送错误代码算子的名称。 ErrorCode 含有实际错误代码和ErrorMessage对应含有错误信息。 如果没有错误代码被设置，或HALCON的错误来自没有扩展的错误信息，OperatorName包含空字符串和ErrorCode设置为0。 请参考指定运算符引用的返回值，来确定函数是否提供和在何种场合提供扩展错误信息。 十七. get_spy( : : Class : Value) 获得HALCON调试工具当前配制信息； 对应的函数还有query_spy.，set_spy，参阅获得更多信息； 十八. query_spy( : : : Classes, Values) 获得HALCON调试工具存在的设置； 十九. set_check( : : Check : ) 开关HALCON的控制模式； 二十. set_spy( : : Class, Value : ) 开关HALCON调试工具的某一功能；
二十一到三十五函数为 HALCON 对Advantech(研华)数字I/O产品的支持，实现应用可选择自己熟悉语言使用研华产品
二十一. control_io_interface( : : IOInterfaceName, Action, Argument : Result) 在 I/O接口执行一个动作。 所支持的参数是特定于接口的，并在相应的I/O接口的文档中列出，这些文档可以在目录'doc/html/reference/io'中找到。 特定值keep_open '在接口卸载时使用。 如果参数Argument设置为“true”，接口保持加载直至HALCON进程终止。如果设置为“false”，一旦设备实例关闭，该接口将被卸载。这是默认行为。 二十二。query_io_interface( : : IOInterfaceName, Query : Result) 获取指定IO设备接口信息； 想要获取的信息通过Query.指定，如果参数传递正确， Result 返回一系列支持值； 一般来说，向参数Query传递interface_name”进行查询，返回所有可用的I/O接口。在这种情况下参数iointerfacename的值被忽略。 请检查目录'doc/html/reference/io' 中关于特定I/O设备接口的文档，其中列出了所有支持的接口特定参数 二十三. open_io_device( : : IOInterfaceName, IODeviceName, GenParamName,GenParamValue : IODeviceHandle) 为指定的设备打开与配制一个IO接口； 设备接口的底层库的库名称指定给iointerfacename。 当配置该设备接口的第一个特定设备时，将动态加载接口库。 具体设备参数IODeviceName自己定义。 可用的名字可以通过query_io_interface查询。 该设备可以通过genparamvalue ，genparamname配置参数。 设备实例通过IODeviceHandle返回。 如果该设备的实例再需要，它应该通过close_io_device被释放和关闭。 打开一个特定的设备后，其传输通道可以通过调用open_io_channel打开。 随后IO通道的值就可以通过函数 read_io_channel和write_io_channel 进行读取或写入； 打开设备实例可以重新用set_io_device_param和get_io_device_param进行设置。 查看目录doc/html/reference/io' 中有关特定I/O设备接口的文档，其中列出了所有支持的设备特定参数。 二十四. close_io_device( : : IODeviceHandle : ) 关闭指定IO设备 二十五.query_io_device( : : IODeviceHandle, IOChannelName, Query : Result) 获取指定IO设备的通道信息 二十六.get_io_device_param( : : IODeviceHandle, ParamName : ParamValue) 获取一IO设备实例的设置； 二十七.set_io_device_param( : : IODeviceHandle, ParamName, ParamValue : ) 设置IO设备实例参数 二十八.control_io_device( : : IODeviceHandle, Action, Argument : Result) 在IO设备上执行一个动作 二十九.open_io_channel( : : IODeviceHandle, IOChannelName, GenParamName,GenParamValue : IOChannelHandle) 打开与配制一个已经打开的IO设备的传输通道； 设备实例必须事先通过open_io_device打开，通过参数iodevicehandle传递进来。 通过传递到IOChannelName的名称，通道自动确认。 可用调用函数query_io_device，传递参数io_channel_name，查询有效的通道名。 通道可以通过参数 GenParamName andGenParamValue配置； 每个传输通道返回保存在参数IOChannelHandle。 如果通道实例不再需要，应该被释放和关闭，通过函数close_io_channel。 此外，通过调用close_io_device关闭设备实例时，它会自动关闭时，。 三十。close_io_channel( : : IOChannelHandle : ) 关闭IO通道 三十一.control_io_channel( : : IOChannelHandle, ParamAction, ParamArgument  aramValue) 在传输通道上执行一个动作 三十二.get_io_channel_param( : : IOChannelHandle, ParamName : ParamValue) 获取IO通道的指定参数 三十三.read_io_channel( : : IOChannelHandle : Value, Status) 从指定IO通道读取一个值 ； 通道通过IOChannelHandle指定，可通过open_io_channel打开与配置。 返回值保存在Value； 参数Status返回值信息中的状态。值0表示可以读取相应的值。任何其他状态值都取决于接口。 三十四. set_io_channel_param( : : IOChannelHandle, ParamName, ParamValue : ) 设置IO通道指定的值； 三十五。write_io_channel( : : IOChannelHandle, Value : Status) 向指定IO通道写入一个值 ；
三十六.get_chapter_info( : : Chapter : Info) 给出关于章节算子的相关信息。例如get_chapter_info ('Legacy', Info) 三十七.get_keywords( : : OperatorName : Keywords) 获取参数OperatorName的关键字 三十八.get_operator_info( : : OperatorName, Slot : Information) 获取HALCON算子的相关信息 三十九.get_operator_name( : : Pattern : OperatorNames) 搜索含有参数Pattern指定关键字的算子，如果输入一个空字符串，将返回所有可用算子的名称。 四十. get_param_info(: : OperatorName, ParamName, Slot : Information) 获取算子参数相关的信息 有效的信息形式（槽），可用算子query_param_info获取。 四十一. get_param_names(: : OperatorName : InpObjPar, OutpObjPar, InpCtrlPar,OutpCtrlPar) 获取HALCON算子的参数名 四十二. get_param_num( : : OperatorName : CName, InpObjPar, OutpObjPar, InpCtrlPar,OutpCtrlPar, Type) 返回指定函数的输入和输出对象参数的数量，以及为说明halcon算子的输入和输出控制参数。 以及C函数形式的函数名称（CNAME），和输出参数类型指示操作员是系统操作员还是用户程序。 四十三. get_param_types(: : OperatorName : InpCtrlParType, OutpCtrlParType) 获取HALCON算子控制参数的缺省数据类型 四十四. query_operator_info( : : : Slots) 获取算子slots相关的信息 四十五.query_param_info( : : : Slots) 获取算子slots的在线信息 四十六。search_operator( : : Keyword : OperatorNames) 搜索含有Keyword 的算子 四十七.count_seconds( : : : Seconds) 函数用于测量时间。 每调用返回一个时间值。 两个连续调用的值的差表示时间间隔，单位s。测量时间的方式可以通过set_system（'clock_mode '，…）设置 四十八. get_system_time(: : : MSecond, Second, Minute, Hour, Day, YDay, Month,Year) 获取系统当前时间 四十九.system_call( : : Command : ) 执行系统指令 在Windows操作系统上，系统命令可以带前缀“start / B避免等待启动的应用程序。 在类Unix操作系统，如果命令包含空字符串,交互式shell（'csh -i）将开始执行，。 五十.wait_seconds( : : Seconds : ) 指定等待Seconds 时间再执行程序，单位s; 五十一.get_aop_info( : : OperatorName, IndexName, IndexValue, InfoName : InfoValue) 返回算子的automatic operatorparallelization (AOP)信息 五十二.optimize_aop( : : OperatorName, IconicType, FileName, ParamName, ParamValue: ) 检查硬件相关自动操作并行化的能力 五十三.query_aop_info( : : OperatorName, IndexName, IndexValue : Name, Value) 获取算子AOP信息的索引结构 五十四. read_aop_knowledge( : : FileName, ParamName, ParamValue : Attributes,OperatorNames) 根据AOP的行为加载硬件知识 五十五.set_aop_info( : : OperatorName, IndexName, IndexValue, InfoName, InfoValue : ) 设置算子AOP信息 五十六. write_aop_knowledge( : : FileName, ParamName, ParamValue : ) 将AOP的硬件相关知识写入文件。 五十七.get_system( : : Query : Information) 获取HALCON系统的当前参数 五十八.set_system( : : SystemParameter, Value : ) 设置系统参数 五十九.open_serial( : : PortName : SerialHandle) 打开一个串口设备 该设备的名称是由参数 PortName确定，由操作系统管理。 在Windows电脑上，常使用“com1到'com4”，而Unix系统的串行设备通常被称为“/dev/tty *”。 串行设备的参数，例如其速度或数据位的数量，在设备打开后被设置为相应设备的系统默认值。可通过set_serial_param改变。 六十.close_serial( : : SerialHandle : ) 关闭一个串行设备 六十一.clear_serial( : : SerialHandle, Channel : ) 清空串口的输入,输出缓存区； 六十二.get_serial_param( : : SerialHandle : BaudRate, DataBits, FlowControl,Parity, StopBits, TotalTimeOut, InterCharTimeOut) 获取串口通讯相关参数 六十三.read_serial( : : SerialHandle, NumCharacters : Data) 从串口读取数据 六十四.set_serial_param( : : SerialHandle, BaudRate, DataBits, FlowControl, Parity,StopBits, TotalTimeOut, InterCharTimeOut : ) 设置串口参数 六十五.write_serial( : : SerialHandle, Data : ) 向串口写入数据 六十六.create_serialized_item_ptr( : : Pointer, Size, Copy : SerializedItemHandle) 创建一个串行化通讯用数据缓存块 六十七.get_serialized_item_ptr( : : SerializedItemHandle : Pointer, Size) 访问串口数据块指针 六十八.fwrite_serialized_item( : : FileHandle, SerializedItemHandle : ) 保存串口数据到文件 六十九.fread_serialized_item( : : FileHandle : SerializedItemHandle) 从文件读取串口数据 七十.clear_serialized_item( : : SerializedItemHandle : ) 删除一个串口数据项
multithreading多线程与sockets套接字多借助自己熟悉的平台完成，HALCON内对应的 函数可参阅菜单栏 算子->system->multithreading或sockets下函数
| 
