配置要求

LPV 可在 MacOS 10 以上版本的 MacOS 系统上运行，支持 x86 和 Apple M 系列处理器。更多细节，请查阅平台支持和最低配置要求。

安装

下载并解压 lpv_sdk_x.x.x.x_linux_arch.tar.gz 到任意文件夹。

安装 x86_64 版本

mkdir lpv & tar -xf lpv_sdk_x.x.x.x_linux_x86_64.tar.gz -C lpv

安装 arm64 版本

mkdir lpv & tar -xf lpv_sdk_x.x.x.x_linux_arm64.tar.gz -C lpv

授权

使用 License 文件进行授权

运行 LPV bin 目录下的 lpvKeyTool.exe ，生成 lpv.key 文件。
将生成的 lpv.key 文件发给我们或者您的 LPV SDK 技术支持，我们将为您的机器进行授权，并发回 .lic 授权文件。
您需要将授权文件手动放置在以下任一目录下：
- LPV lib 文件夹
- ~/Library/Application Support/LPV/

集成和调用

集成 LPV

在 MacOS 平台，LPV 接口通过 C 符号导出，然后封装为易用性更好的 C++ 类和接口。

在调用方的 C++ 代码中，添加 #include "LPVXXX.h" 引用所需的 LPV 模块，然后通过静态的 LClass::Create() 函数创建对应的 LPV 算法类实例。以下提供了一段简单的调用示例代码：

// 添加 include
#include "LPVCore.h";
#include "LPVGeom.h";
#include "LPVPat.h";
using namespace LPVCoreLib;
using namespace LPVGeomLib;
using namespace LPVPatLib;
 
// 创建算法类实例
// 以下创建了一个 LMatch 对象，并获取了指向其的 ILMatch 接口类指针
ILMatchPtr lmatch = LMatch::Create();
 
// 调用接口函数，如下，设置模板匹配数量，设置角度范围
lmatch->MaxCount = 1;
lmatch->AngleTolerance = 180;
 
// 调用接口函数，处理返回错误码，如下，进行模板匹配
LPVErrorCode errCode = lmatch->Match(sourceImg, roi, out matchResults);
if (errCode != LPVErrorCode::LPVNoError) {}

添加 LPV 到 XCode 工程

打开项目配置
在 PROJECT -> Build Settings -> Search Paths：
- Header Search Paths：增加 LPV include 文件夹
- Library Search Paths：增加 LPV lib 文件夹
在 TARGETS -> Build Phases -> Link Binary With Libraries，从文件添加 LPV 动态链接库
在 TARGETS -> General -> Frameworks and Libraries，修改已添加的 LPV 库的 Embed 类型为 Embed & Sign
用于在 XCode 内调试，在 TARGETS -> Build Settings -> Linking，添加 LPV lib 文件夹到 Runpath Search Paths.

添加 LPV Libraries 到 CMake 工程

编辑 CMakeList.txt，添加 include 路径和库链接路径。

# 设置 C++ 标准为至少 cpp11
set(CMAKE_CXX_STANDARD 11)
 
# 添加 include 路径
# ${LPV_INCLUDE_PATH} 指向 include 文件夹
target_include_directories(${PROJECT_NAME} ${LPV_INCLUDE_PATH})
 
# 链接到 lpv 模块
# ${LPV_LIB_PATH} 指向 lib 文件夹
function(link_lpv_lib module_name)
    find_library(LPV_LIBRARY_${module_name} NAMES ${module_name} PATHS ${LPV_LIB_PATH})
    if(NOT LPV_LIBRARY_${module_name})
        message("!!!! LPV_LIBRARY_${module_name} not found")
    else()
        target_link_libraries(${PROJECT_NAME} ${LPV_LIBRARY_${module_name}})
    endif()
endfunction()
 
link_lpv_lib(lpvCore)
link_lpv_lib(lpvGeom)
link_lpv_lib(lpvPat)

添加 LPV 到 Qt 工程

如果您正在使用 Qt Creator,

右键项目，选择 添加库 。
选择 外部库 ，然后点击下一步。
将 库文件 路径指向 LPV lib 文件夹下的动态链接库。
将 包含路径 路径指向 LPV include 文件夹。
勾选 Mac 平台和库选项。
点击下一步，然后完成。

或者，您也可以手动编辑 .pro 文件，如下所示：

# 添加 include 路径
# ${LPV_INCLUDE_PATH} 指向 include 文件夹
INCLUDEPATH += $$LPV_INCLUDE_PATH
 
# 链接到 lpv 模块
# ${LPV_LIB_PATH} 指向 lib 文件夹
 
LIBS += -L$$LPV_LIB_PATH -llpvCore -llpvGeom -llpvPat
DEPENDPATH += $$LPV_LIB_PATH

目录