关于pdf.js中文本坐标尺寸的使用

一个电子教材项目中有这样一个需求：

用户向网站上传一个PDF书籍后，网站可以对PDF书籍进行解析，并支持用户对PDF书籍的每一页做一些操作，比如：为英语课本的单词和句子添加音频热区。因为热区数量很多，所以，希望网站 “在初始化课本页面的时候，自动初始化热区，然后用户再在此基础上调整”，这样可以大大减少工作量。

我使用pdf.js来实现该功能，该库可以获取到pdf中的文本及位置、宽高，但这些位置尺寸使用起来有几处值得注意的细节（稍不注意，可能会被卡很久）。

一、pdf.js提供的文本信息

如图所示，这是一个PDF页面中获取到的文本信息。这里要用到的字段有：height(高)、width(宽)、transform(这是组matrix矩阵数据，其中最末两位分别是水平方向和垂直方向的位置信息)。

二、transform数据对应的坐标系

1）初始坐标数据

通常，我们定位一个元素时，会设置它的left和top，left的数值从左向右递增，top的数值自上而下递增；而transform中的垂直方向数值是从下往上递增的。（下图是坐标系不同导致的错误结果，这个结果是多种原因造成的，后续我们逐一修正）

2）矫正坐标数据(垂直方向翻转)

基于上一步，首先，先来矫正坐标系。我们将垂直方向的数值进行矫正：

新值 = pdf页面高度 - 旧值。

再次渲染后，会发现垂直方向的坐标系已经对了。但仍有两个问题：一个是横纵方向的定位都存在偏差，另一个是热区的宽高比实际文本所占空间大。这主要是因为“绘制pdf的canvas画布的width、height”和“canvas画布在页面布局中被定义的样式style中的width、height”不一致，二者存在比例换算。

三、数据换算

1）矫正比例换算

基于上一步，结合canvas的内外尺寸来矫正热区的宽高和定位：

left = textinfo.transform[4] / canvas.width * canvas.style.width;

top = textinfo.transform[5] / canvas.height * canvas.style.height;

width = textinfo.width / canvas.width * canvas.style.width;

height = textinfo.height / canvas.height * canvas.style.height;

再次渲染后，会发现水平方向的尺寸、定位已经对了。但垂直方向上的定位仍然存在少许偏差。这个问题很细节，我困扰了好几个小时才发觉：我们已经知道初始时的垂直坐标是自下而上的，那么在垂直翻转时，应该把文本所占的高度也减掉才对。

2）再次矫正垂直方向数值

新值 = (pdf页面高度 - 旧值 - 文本自身高度) / canvas.height * canvas.style.height。

修改后再次渲染，可以发现效果已经符合预期了。

四、相关代码片段展示

initHotspots() {
    let pdfDoc = this.loadingTaskDict[this.pageActiveIndex] || this.loadingTask;
    if (!pdfDoc) return;
    pdfDoc.promise.then((pdf) => {
        let pageIndex = this.loadingTaskDict[this.pageActiveIndex] ? 1 : this.pageActiveIndex;
        pdf.getPage(pageIndex).then((page) => {
            let view = page.view || [];
            let pdfPageWidth = view[2] - view[0]; // pdf页面宽度(canvas.width)
            let pdfPageHeight = view[3] - view[1]; // pdf页面高度(canvas.height)
            page.getTextContent().then((textInfo) => {
                textInfo = textInfo || {};
                let textItems = textInfo.items || [];
                // bookPageDom是网页中pdf页面的包裹元素(bookPageInfo.width相当于canvas.style.width)
                let bookPageDom = document.querySelector('.book-page');
                let bookPageInfo = bookPageDom ? bookPageDom.getBoundingClientRect() : null;
                textItems.forEach((v) => {
                    if (/[a-zA-Z]+/i.test(v.str) && v.str.length > 7 && bookPageInfo) {
                        let x = (v.transform[4] / pdfPageWidth) * 100 + '%';
                        let y = ((pdfPageHeight - (v.transform[5] + v.height)) / pdfPageHeight) * 100 + '%';
                        this.addHotpot({
                            top: y,
                            'y%': y,
                            left: x,
                            'x%': x,
                            width: (v.width / pdfPageWidth) * bookPageInfo.width,
                            height: (v.height / pdfPageHeight) * bookPageInfo.height,
                            original: v.str,
                            styles: { left: x, top: y }
                        });
                    }
                });
            });
        });
    });
},