# OPExport

**Repository Path**: flaot/OPExport

## Basic Information

- **Project Name**: OPExport
- **Description**: 为OP(operator & open)是一个开源插件(类似大漠插件)生成通过LoadLibrary调用的桥接代码
- **Primary Language**: C#
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-02
- **Last Updated**: 2026-03-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

Overview
===========
OPExport([OP](https://github.com/WallBreaker2/op) & Export)是一个OP的自定义模版代码生成.

## 功能特色
- 源代码使用c#编写可跨平台
- 根据libop.h及自定义模版生成代码
- 生成通过LoadLibrary调用DLL的代码(内置模版)
- 代码上附加[函数说明](https://github.com/WallBreaker2/op/wiki)可由IDE提示
- 高可扩展性，添加教程查看末尾

## 交流
* QQ group:743710486
* [Discussion](https://github.com/WallBreaker2/op/discussions)

## 编译
### 依赖
* [CommandLine.Net](https://github.com/AlexGhiondea/CommandLine)
* [Scriban](https://github.com/scriban/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`结尾文件为模版文件，[模版文件语法文档](https://scriban.github.io/docs/)

### 内置对象(libOP)
定义如下
```C#
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;  // 参数注释
}
```

### 内置方法
```ini  
# 根据'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导出函数定义
```C  
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` 获取原始定义
```C  
// 给指定的字库中添加一条字库信息  
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();  
```