奕瑞平板探测器SDK说明.pptxVIP

纲要认识我们的SDK包我们为客户的软件集成工作提供了哪些基础资料认识示例代码示例代码功能介绍，运行示例代码常见问题排查客户软件集成问题客户软件集成常见问题认识我们的SDK包SDK包结构认识我们的SDK包(Dev)Dev是development的缩写，软件开发需要的文件保存在此文件夹中dll：DynamicLinkLibrary动态链接库dll文件可以看作对于已有代码的一个封装，我们将变量、函数、类封装到dll文件中，供客户的exe去使用。认识我们的SDK包(Dev).h后缀代表header，头文件.cs后缀代表class，类文件客户想使用封装在dll中的变量、函数、类，就需要在C++/C#工程中引用这些.h/.cs文件。认识我们的SDK包(Dev)离线处理库：封装一些使用频率较低的功能，以及额外收费功能。比如离线校正、递归降噪。不同型号平板的初始工作目录。认识我们的SDK包(Tools)SDK运行环境。认识我们的SDK包(Help)SDK编程指南文档认识我们的SDK包(Help)从上至下依次为：C工程示例代码C++工程示例代码C#工程示例代码C++工程，简单平板控制程序(具有UI界面)C#工程，简单平板控制程序(具有UI界面)C++工程，图像格式tiff-raw转换程序C++工程，Defect模板生成程序，离线Defect校正程序认识示例代码以Cpp文件夹为例，其内包含IRayExamples.slnsln即solution缩写，意为解决方案。使用VisualStudio(简称VS)可以打开这个解决方案。认识示例代码在VS中的SolutionExplorer窗口，我们可以看到该解决方案中共包含15个工程。每个工程各自展示了控制平板完成一项基本操作所需要的指令工作流，这种化整为零的展示方式，更利于客户的理解与学习。认识示例代码从上至下依次为：下载校正模板(从PC至FPD)动态平板切换工作模式(DynamicApplicationMode)动态平板生成preoffset+gain+defect校正模板(Cfg_CalibrationFlow=1)动态平板生成gain+defect校正模板(Cfg_CalibrationFlow=0、2)动态平板生成preoffset校正模板动态平板连续采集动态平板单帧采集(此工程不通用，因为许多动态平板不支持Cmd_ClearAcq)静态平板生成去栅校正模板并激活校正采图像口内平板采集口内平板生成defect校正模板口内平板生成gain校正模板基础类Detector.cpp(业务集成类)静态平板采集静态平板生成gain+defect校正模板，上传至FPD并激活HW校正认识示例代码以工程Dynamic_SeqAcq为例，该工程是动态平板用户软件集成时，很适合参考的示例。我们在运行该示例代码时，可能遇到如下问题：1.dll加载失败排查事项：1.是否把SDK包\Dev\bin\x64(w32)中所有文件放到了Dynamic_SeqAcq.exe同级目录2.VS中编译平台选择是否与dll版本保持一致3.SDK包\Tools\env_setup\microsoft中的开发环境是否正确安装认识示例代码2.未找到指定的平板工作目录排查事项：1.GetWorkDirPath函数能否定位到workdir_path.txt2.workdir_path.txt的内容中，是否为正确的平板工作目录路径(最好写绝对路径)3.workdir_path.txt指向的目录是否存在，该工作目录是否对应正确的平板型号认识示例代码3.平板连接失败排查事项：1.网卡适配器设置(检查IP地址、巨型帧、接收缓冲区、流量控制等，是否按照产品说明书设置)2.config.ini文件中Cfg_HostIP、Cfg_RemoteIP设置是否正确认识示例代码4.图像获取异常(收不到图/与设定帧率不符)排查事项：1.网卡适配器设置(检查IP地址、巨型帧、接收缓冲区、流量控制等，是否按照产品说明书设置)2.平板的同步模式是否设为syncout认识示例代码下图为Dynamic_SeqAcq示例一次成功的运行结果截图排查客户软件集成问题常见平板工作流举例。注意，这里展示的工作流是笔者接触到的有限种类平板探测器，大多数都支持的工作流。但有些平板探测器的软件集成较为特殊，需要找SDK软件工程师提供专门的集成指南文档（如MERCU1717VN）较为典型的一种动态板工作流(同步模式FluroSync_SyncOut)Create(创建平板对象)-Cmd_Connect(连接)-Cmd_SetCaliSubset(设置工作模式)-Cmd_OffsetGeneration(offset模板刷新建议10分钟做一次)-Cmd