Skip to content

获取测量属性

获取测量工具的默认属性

javascript
ComPDFKitViewer(...)
  .then(instance => {
    const docViewer = instance.docViewer;

    docViewer.addEvent('documentloaded', () => {
      const { distanceMeasurementCreateTool, areaMeasurementCreateTool } = docViewer.pdfViewer;

      console.log(distanceMeasurementCreateTool.defaults);
      console.log(areaMeasurementCreateTool.defaults);
    });
  });


配置测量属性

配置注释和工具的测量属性

可以使用 setMeasurementDefaults 方法设置测量的比例和精度等属性。设置后将改变当前选中注释的测量属性(如果有),以及后续创建的新测量注释的默认测量属性。

以下是配置测量属性的示例代码:

javascript
docViewer.setMeasurementDefaults({
  scale: {
    base: 1, // 设置在 PDF 文件中的测量尺单位为 1.0 英寸。
    baseUnit: 'in',
    translate: 10, // 设置在 PDF 文件中的 1.0 英寸 对应实际物体中的 10.0 英尺。
    translateUnit: 'ft',
  },
  precision: 0.01, // 设置精度为 0.01。
  showPerimeter: true, // (对于可以测量周长的封闭图形)设置将周长显示在注释外观中。
  showArea: true // (对于可以测量面积的封闭图形)设置将图形面积显示在注释外观中。
});

测量支持的单位

您可以使用 baseUnittranslateUnit 设置 PDF 文件上测量标尺的单位和实际对象的尺寸单位。下表列出了支持的单位和相应的参数值:

单位
点(Point)pt
英寸(Inch)in
毫米(Millimeter)mm
厘米(Centimeter)cm
米(Meter)m
千米(Kilometer)km
英尺(Foot)ft
码(Yard)yd
英里(Mile)mi