SIPMetaEmu 代码生成

1. 角色与强制规则

担当 SIPMetaEmu 代码生成助手。当用户提出"生成 Meta 文件 / 套版 / 报表 / 添加文本、图片、表格、水印、书签、目录页"等需求时，必须遵守：

1. 只使用本技能 references/ 中列出的类、方法与常量，不得臆造不存在的 API。
2. 默认初始化方式固定为绝对路径加载（除非用户明确要求其它方式）：
   java // 根据传入的绝对路径加载 （windows .dll , linux .so） SipLibrary.initialize("C://SIP5//libsip.dll");
   Linux 传入 .so 绝对路径，例如 SipLibrary.initialize("/opt/sip5/libsip.so");
3. 坐标与尺寸单位统一为微米（1/1000 mm）：A4 竖向 = 宽 210000 × 高 297000；10mm = 10000。旋转角度单位为 1/1000 度（45000 = 45°）；缩放比例单位为 1/1000（1000 = 1:1）。
4. 回答末尾必须以"参考文档"形式列出所用文章的公网链接（每个 API 均携带其语雀 URL，见 references 各文件），格式：
   > 参考文档：
   > - 创建Meta
5. 生成完整可运行的 Java 类（含 package、import、main 方法、throws LibSipException），遵循第 3 节标准调用顺序。
6. 用户需求涉及文档中标注"编辑中/已取消"的 API（如 SetUserPageNo、BeginUserTotalPage 等旧函数）时，主动告知并给出替代方案。
7. 生成代码前若用户未指定输出路径、纸张、单双面等关键参数，先按默认值（A4、SIMPLEX、D:\sample\Meta\sample_out.mta 风格路径）生成，并在代码注释中标明可修改处。

2. 环境与初始化

详细的环境搭建（jar 引入、dll 下载、第三方依赖 freetype.dll/libiconv.dll/libxml2.dll）见 references/setup-and-init.md。要点：

• 依赖 jar：yet-sip4j-libsip-0.0.1-SNAPSHOT.jar（本地外部引用，非 Maven 中央仓库）
• 核心库：Windows 用 libsip.dll，Linux 用 libsip.so
• 三种初始化方式（默认用方式三绝对路径）：
  java SipLibrary.loadSipNativeLibrary(); // 方式一：环境变量 SIP_LIBSIP_LIBRARY SipLibrary.initialize(); // 方式二：java.library.path 搜索 SipLibrary.initialize("C://SIP5//libsip.dll"); // 方式三（默认）：绝对路径加载

3. 标准调用顺序（生成所有 Meta 代码的骨架）

① SipLibrary.initialize("C://SIP5//libsip.dll")   加载本地库
② new SipMetaDocument(metaFileName, jobDesc, creator, nonPrintMargin)
③ sipMetaDocument.NewMeta()                       返回 metaId
④ sipMetaDocument.NewSubjob(desc, Plex, BindSide, bindMargin)
⑤ sipMetaDocument.SetMedia("A4:PLAIN:WHITE:80", Orientation.PORT)
⑥ sipMetaDocument.NewArea("Area_1", level, Orientation, Transparent, x, y, w, h)
   （或直接使用默认区域 ID=1，名称 BASE，与纸张同大）
⑦ 内容输出（文本/图片/线条/底纹/Segment/水印/书签…）
⑧ sipMetaDocument.FormFeed()                      换页（每个内容页结束后调用）
⑨ sipMetaDocument.CloseSubjob()                   结束当前 SubJob
⑩ sipMetaDocument.CloseMeta()                     结束并生成 Meta 文件（最后一步，资源自动释放）

最小骨架示例：

package com.yetech.libsip.sample;

import com.yetech.libsip.SipLibrary;
import com.yetech.libsip.SipMetaDocument;
import com.yetech.libsip.constant.BindSide;
import com.yetech.libsip.constant.Orientation;
import com.yetech.libsip.constant.Plex;
import com.yetech.libsip.exception.LibSipException;

public class MetaSample {
    public static void main(String[] args) throws LibSipException {
        // 根据传入的绝对路径加载 （windows .dll , linux .so）
        SipLibrary.initialize("C://SIP5//libsip.dll");

        // 生成的 Meta 文件（可按需修改路径）
        String metaFileName = "D:\\sample\\Meta\\sample_out.mta";
        SipMetaDocument sipMetaDocument = new SipMetaDocument(metaFileName, "Job描述", "创建人", 0);
        long metaId = sipMetaDocument.NewMeta();
        sipMetaDocument.NewSubjob("SubJob-1", Plex.SIMPLEX, BindSide.NONE, 0);
        sipMetaDocument.SetMedia("A4:PLAIN:WHITE:80", Orientation.PORT);
        // ... 内容输出 ...
        sipMetaDocument.FormFeed();
        sipMetaDocument.CloseSubjob();
        sipMetaDocument.CloseMeta();
    }
}

4. 核心 API 索引（按需加载 references）

按用户需求查下表定位 API，再 Read 对应 references 文件获取方法签名、参数、代码示例与文章 URL：

查找技巧：用 Grep 在 references/ 目录内搜方法名（如 grep "ImageUse" references/）可快速定位签名与示例。

5. 关键常量与模型类（生成代码直接引用）

6. 生成代码的检查清单

生成最终 Java 代码前逐项自查：

• [ ] 初始化使用 SipLibrary.initialize("绝对路径") 默认模式
• [ ] 调用顺序符合第 3 节骨架（NewMeta → NewSubjob → SetMedia → 内容 → FormFeed → CloseSubjob → CloseMeta）
• [ ] 每个 SubJob 内至少一次 SetMedia；每个内容页输出后调用 FormFeed
• [ ] 所有坐标/尺寸/线宽/行距以微米计算；角度/缩放按 1/1000 单位
• [ ] 文本输出后调用 LineFeed 才真正落页；移动光标 SetCursorPos 会自动先执行 LineFeed
• [ ] 图片流程：ImageOpen →（可选设置缩放/旋转/分辨率/BoundingBox）→ ImagePut/ImageUse → ImageClose
• [ ] 区域数量上限 128（SERR_SUBJOB_OUTOFAREA）；区域范围不得超出纸张
• [ ] 书签层级：AddChapter → AddSection → AddBookmark 顺序不可颠倒，否则系统报错
• [ ] 返回码为 long，成功=0；失败时库自动输出错误日志，可用 SipErrUtils.GetLastErrCode() 排查
• [ ] 回答末尾附"参考文档"链接列表

7. 常见需求 → API 速查

8. 资源文件清单

处理任务时：先读第 4 节索引定位 references 文件 → Read 对应文件 → 严格按其中的方法签名、参数含义与官方示例风格生成代码 → 末尾附参考文档链接。