# @embedpdf/plugin-measurement 中文文档

规范地址：https://npmcn.com/package/%40embedpdf/plugin-measurement/

版本：3\.2\.0
npm 元数据更新时间：2026-11-11T23:24:53.666Z
中文译文更新时间：2026-11-13T15:13:02.366Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40embedpdf/plugin-measurement
原文对照：https://npmcn.com/package/%40embedpdf/plugin-measurement/?lang=original
项目主页：https://github.com/embedpdf/embed-pdf-viewer#readme
源码仓库：https://github.com/embedpdf/embed-pdf-viewer

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：225 kB，19 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：5 个
- 首次发布：2026-09-20T09:38:47.655Z
- 最新版本发布：2026-11-11T23:24:53.467Z
- 近 30 天下载量：10146（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：13（近 12 个月 13 个）

## 中文简介

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

## 安装

```sh
npm install @embedpdf/plugin-measurement
```

也可以使用：`pnpm add @embedpdf/plugin-measurement`、`yarn add @embedpdf/plugin-measurement`、`bun add @embedpdf/plugin-measurement`

## README

# @embedpdf/plugin-度量衡

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

```ts
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` 每页起火。 读取失败的全页注释显示为 `error`A级 单页视图端口写入失败在注释写入前拒绝; 多页 操作(若干页或 `'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 是什么？

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 和提交记录判断。