@embedpdf/plugin-measurement

中文文档
3.2.0发布于 2026/11/12Apache-2.0TypeScriptESM + CJS近 30 天下载 1万

EmbedPDF的页面校正和距离测量工作流程.

中文使用文档

@embedpdf/plugin-度量衡

文档扫描页校正,测量作者,测量读取. 同时安装 annotationPlugin() 财务报告和审定财务报表 interactionPlugin()数字 :

import { measurementPlugin, MeasurementToken } from '@embedpdf/plugin-measurement';

const plugins = [
  /* interaction, annotation, ... */
  measurementPlugin({ defaultScale: 'metric' }),
];

const measurements = viewer.get(MeasurementToken);
await measurements.calibrate({ page, from, to, distance: { value: 5, unit: 'm' } });

calibrate 点是页面空间, 如 CalibrationRequest 校正 工具生成; 插件将它们转换为 PDF 用户空间, 以及行长 通过引擎的浮标32坐标规则进行圆形. UserUnit 参加 在比例预设中; 从已知长度校正已表示全长 转换.

注释插件提供 distance, (中文(简体) ), perimeter, (中文(简体) ), area,以及 calibrate 工具。 测量会捕捉最后一个包含其 第一点。外国或无效的中选取景端阻止创建 默认缩放只在所有的取景口外使用。 直到页面的浏览器读取 完成时, 无法创建测量 . createMeasurement({ kind, page, points }) 从 代码,解析 { annotation },并拒绝 not-ready 在页面之前 缩放是已知的。 页面是各地的参考或索引. startCalibration() 手持校正工具,并投掷 permission-denied 无 doc.annotate.modify;它的两点到达时是 onCalibrationRequested (和 getCalibrationRequest()等待真实 长度,和 dismissCalibration() 放弃请求.

setScale, (中文(简体) ), setPreset, (中文(简体) ), setUnit, (中文(简体) ), setAreaUnit, (中文(简体) ), setPrecision,以及 clearScale 取一页目标——一页、一行页面,或 'all' - 和 { recalculate?: boolean }。 。 。 . calibrate 除非 applyTo 命名一个更广泛的目标。 重新计算默认为真. 每个注释都存储着 自己的缩放快照。 设置 recalculate: false 更改后续测量 在保留现有价值的同时.

每个比例表变化决定为每页列出一份更新、跳过和 失败的注释 ; listLastReports() 保留最后一集,并 onScaleChanged 每页起火。 读取失败的全页注释显示为 errorA级 单页视图端口写入失败在注释写入前拒绝; 多页 操作(若干页或 'all'每页返回 scaleError 成果和成果 完成剩余页。 当引擎时, PDF 中页标持续 提供 page.measure;没有它,它们会持续到届会 (单位:千美元)getPageScale(page).persistent === false) (中文(简体) ).

canCalibrate() 镜像 doc.annotate.modify· ; canMeasure(page) 组合 注释创建权限和视图准备。 记录权限和 PDF 旗口重新计算和标题拖曳 。 测量内容为: 生成且不能作为注释文本编辑 . getReadout(ref) 格式 a 计量说明; measureDistance 财务报告和审定财务报表 measureArea 转换页面空间 在页面的分数表中不创建任何东西.

设置, defaultScale 财务报告和审定财务报表 presets,在应用程序运行时更改 : updateSettings(), (中文(简体) ), resetSettings() 财务报告和审定财务报表 onSettingsChanged,每个 文档.

反应消费者导入 measurementPlugin, (中文(简体) ), useMeasurement (能力), useMeasurementState (单位:千美元)busy, (中文(简体) ), calibrationRequest, (中文(简体) ), lastReports, (中文(简体) ), useMeasurementSettings, (中文(简体) ), usePageScale, (中文(简体) ), useMeasurementReadout 财务报告和审定财务报表 useMeasurementEvent 从 @embedpdf/react/measurement。完整查看器包含一个计量工具栏 (距离、周边、面积、校准),平面边栏和已知长度 校正对话框 .

远程字幕使用标准的PDF行轴抵消. 他们的现场布局 helvetica 预付款估计数;承诺说明为本地PDF 现相.

版本与发布记录

@embedpdf/plugin-measurement 共发布 13 个版本,首次发布于 2026/09/20;过去 12 个月发布了 13 个版本。

版本发布日期距今
3.2.0latest2026/11/121 天前
3.1.02026/11/094 天前
3.0.02026/11/076 天前
3.0.0-next.23next2026/11/076 天前
3.0.0-next.222026/11/049 天前
3.0.0-next.212026/11/0310 天前

关于 @embedpdf/plugin-measurement 的常见问题

@embedpdf/plugin-measurement 是什么?

EmbedPDF的页面校正和距离测量工作流程.

如何安装 @embedpdf/plugin-measurement?

在项目目录运行 npm install @embedpdf/plugin-measurement,或使用 pnpm add / yarn add / bun add。

@embedpdf/plugin-measurement 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@embedpdf/plugin-measurement 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@embedpdf/plugin-measurement 可以商用吗?

@embedpdf/plugin-measurement 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@embedpdf/plugin-measurement 的下载量有多少?

根据 npm 官方下载统计,@embedpdf/plugin-measurement 在 2026/10/14 – 2026/11/12 这 30 天内被下载 10,146 次,日均约 338 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@embedpdf/plugin-measurement 还在维护吗?

最新版本 3.2.0 发布于 2026/11/12(1 天前);至今共发布 13 个版本,其中过去 12 个月发布了 13 个;首次发布于 2026/09/20。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。