Archi脚本插件中PDF导出文本裁剪问题的解决方案-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_07167/article/details/148417384

Archi脚本插件中PDF导出文本裁剪问题的解决方案

archi-scripting-plugin jArchi - Scripting for Archi: ArchiMate Modelling Tool 项目地址: https://gitcode.com/gh_mirrors/ar/archi-scripting-plugin

问题背景

在使用Archi脚本插件(jArchi)进行批量PDF导出时，用户可能会遇到文本显示不完整的问题，特别是某些文本的最后一个字符被部分裁剪。这种现象在特定字体下尤为明显，影响了模型视图的完整性和专业性。

技术原理分析

这个问题源于PDF渲染引擎对某些字体的处理方式。当使用特定字体时，PDF渲染器可能会错误计算文本边界框，导致文本被意外裁剪。这种现象在技术文档中被称为"文本裁剪"或"文本偏移"问题。

解决方案演进

临时解决方案

在jArchi 1.7版本之前，用户可以尝试以下临时解决方案：

更换视图使用的字体
调整文本内容长度
手动调整元素大小

永久解决方案

jArchi 1.7版本引入了更灵活的导出选项系统，允许开发者通过参数配置解决这一问题。新的API设计采用了选项映射(Map of options)的方式，提供了更细粒度的控制能力。

新版API详解

jArchi 1.7为SVG和PDF导出提供了增强的API接口：

SVG导出相关函数

$.model.renderViewAsSVGString(view, options)
$.model.renderViewToSVG(view, filePath, options)

PDF导出相关函数

$.model.renderViewToPDF(view, filePath, options)

选项参数详解

开发者可以通过options对象配置以下参数：

通用选项(适用于SVG和PDF)

textAsShapes: 布尔值，默认为true，决定是否将文本转换为形状
embedFonts: 布尔值，默认为false，控制是否嵌入字体
textOffsetWorkaround: 布尔值，默认为false，启用文本偏移修复

SVG专用选项

setViewBox: 布尔值，默认为true，控制是否设置SVG的viewBox属性
viewBoxBounds: 字符串，默认为null，可手动指定viewBox边界

实际应用示例

// SVG导出配置示例
var svgOptions = {
    setViewBox: true,
    viewBoxBounds: "0 0 1000 200",
    textAsShapes: false,
    embedFonts: true,
    textOffsetWorkaround: true
};

// 使用配置导出SVG
var svgString = $.model.renderViewAsSVGString(view, svgOptions);
$.model.renderViewToSVG(view, "pathTo/test.svg", svgOptions);

// PDF导出配置示例
var pdfOptions = {
    textAsShapes: false,
    embedFonts: true,
    textOffsetWorkaround: true
};

// 使用配置导出PDF
$.model.renderViewToPDF(view, "pathTo/test.pdf", pdfOptions);