Overview

OPExport(OP & Export)是一个OP的自定义模版代码生成.

功能特色

• 源代码使用c#编写可跨平台
• 根据libop.h及自定义模版生成代码
• 生成通过LoadLibrary调用DLL的代码(内置模版)
• 代码上附加函数说明可由IDE提示
• 高可扩展性，添加教程查看末尾

交流

• QQ group:743710486
• Discussion

编译

依赖

• CommandLine.Net
• Scriban

编译环境

• 操作系统: Visual Studio 2026
• 目标框架：.NET 10.0

快速开始

OpExport.exe {OPProject} -t Template/CSharp.sbncs -out C#/OpSoft.cs -doc true
- OPProject OP项目根目录
- t 模版文件
- out 输出文件
- doc 是否添加wiki上的注释

模版编写说明

以.sbncs结尾文件为模版文件，模版文件语法文档

内置对象(libOP)

定义如下

public class LibOP
{
    // 导出函数(OP_XXX)
    public List<Method> functions;
}
public class Method
{
    public string name;        //函数名称
    public string annotation;  //注释
    public string rtype;       //返回类型
    public string rannotation; //返回类型注释
    public List<Arg> args;     //参数类型及参数名称
    public string example;    //使用示范
}
public class Arg
{
    public string name;        //参数名称
    public string type;        //参数类型
    public int rtype;          //传递引用类型 0-None 1-In 2-Out 3-InOut 4-Ret
    public string annotation;  // 参数注释
}

内置方法

# 根据'dll导出函数名称'获取'原始函数'定义
_func_methodByFunction [funcName:str]
    ret [methodObj:method]

# 在参数列表中移除下标为index的
_func_argsRemoveAt [args:List<Arg>] [index:int]
    ret [void]

# 设置输出文件后缀名
_func_setOutFileExtension [extension:str]
    ret [void]

输出示例

libOP.functions 获取dll导出函数定义

libop* OP_CreateOP();  
void OP_ReleaseOP(libop* _op);  
// 给指定的字库中添加一条字库信息  
long OP_AddDict(libop* _op, long idx, const wchar_t* dict_info);  
// A星算法  
int OP_AStarFindPath(libop* _op, long mapWidth, long mapHeight, const wchar_t* disable_points, long beginX, long beginY, long endX, long endY, wchar_t* _pStr, int _nSize);  
void OP_GetScreenFrameInfo(libop* _op, long* frame_id, long* time);  

_func_methodByFunction 获取原始定义

// 给指定的字库中添加一条字库信息  
void AddDict(long idx, const wchar_t* dict_info, long* ret);  
long SetOcrEngine(const wchar_t* path_of_engine, const wchar_t* dll_name, const wchar_t* argv);  
// 1.版本号Version  
std::wstring Ver();