@capsizecss/unpack

中文文档
4.0.1发布于 2026/06/12MITTypeScriptES Module构建来源已验证近 30 天下载 3660.7万

从字体中解包缩放字体参数

中文使用文档
文档目录9 节
  1. 使用量
  2. fromBuffer
  3. fromBlob
  4. fromUrl
  5. fromFile
  6. 选项
  7. 字体参数
  8. 谢谢
  9. 许可证
Capsize

@ capsizecs/ unpack

从字体文件中直接解开缩放的字体标尺.

npm install @capsizecss/unpack

使用量

fromBuffer

使用缓冲器返回已解决 字体参数。 。 。 .

import { fromBuffer } from '@capsizecss/unpack';

const metrics = await fromBuffer(buffer);

fromBlob

取一个文件块并返回已解决 字体参数。 。 。 .

import { fromBlob } from '@capsizecss/unpack';

const metrics = await fromBlob(file);

fromUrl

使用url 字符串返回已解决 字体参数。 。 。 .

import { fromUrl } from '@capsizecss/unpack';

const metrics = await fromUrl(url);

fromFile

取出文件路径字符串并返回已解决 字体参数。 。 。 .

import { fromFile } from '@capsizecss/unpack/fs';

const metrics = await fromFile(filePath);

选项

上述所有API都接受带有以下选项的可选第二个参数:

postscriptName

Capsize 可以通过提供 TTC 从 TrueType Collection (TTC) 文件提取单字体的公尺 postscriptName。 。 。 .

import { fromFile } from '@capsizecss/unpack';

const metrics = await fromFile('AvenirNext.ttc', {
  postscriptName: 'AvenirNext-Bold',
});

字体参数

返回的字体参数对象包含以下属性:

财产类型说明
家庭Name字符串字体创建者的字体姓氏
完整Name字符串字体创建者的字体全名
邮戳Name字符串该字体由字体创建者编写的唯一 PostScript 名称
类别字符串字体的样式:serif,sans-serif,单相间,显示,或笔迹.
宽度编号大写字母高于基线的高度
上调编号高度高于基线
血统编号基准以下降水者的下降
行图编号包含行间间间距的数量
单位编号字体内部坐标网格的大小
十进制编号基准以上小写字母的正文高度
xWidthAvg 图像编号选定 Unicode 子集字体中字符格法的平均宽度。 计算 基于书面文本中的字符频率倒回建筑里 xAvgCharWidth 从OS/2表.
子集{
[子集]: { xWidthAvg: number }
{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢
浏览 xWidthAvg 按子集(见 支持的子集(中文(简体) )

谢谢

许可证

麻省理工学院.

版本与发布记录

@capsizecss/unpack 共发布 38 个版本,首次发布于 2021/09/24;过去 12 个月发布了 3 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
4.0.1latest2026/06/124 个月前
4.0.02025/12/1910 个月前
3.0.12025/11/1211 个月前
0.0.0-test-202510062350162025/10/071.1 年前
3.0.02025/07/011.4 年前
2.4.02025/03/311.6 年前

其他发布通道:createfontstack → 0.0.0-createfontstack-20221110224822,x-avg-char-width → 0.0.0-x-avg-char-width-20221118004523,x-width-avg → 0.0.0-x-width-avg-20230123213508,add-language-support → 0.0.0-add-language-support-20231121023926,add-language-support-v2 → 0.0.0-add-language-support-v2-20231129052138,crackle → 0.0.0-crackle-20240208083429。

关于 @capsizecss/unpack 的常见问题

@capsizecss/unpack 是什么?

从字体中解包缩放字体参数

如何安装 @capsizecss/unpack?

在项目目录运行 npm install @capsizecss/unpack,或使用 pnpm add / yarn add / bun add。

@capsizecss/unpack 支持 TypeScript 吗?

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

@capsizecss/unpack 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@capsizecss/unpack 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=18。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@capsizecss/unpack 可以商用吗?

@capsizecss/unpack 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@capsizecss/unpack 的下载量有多少?

根据 npm 官方下载统计,@capsizecss/unpack 在 2026/10/09 – 2026/11/07 这 30 天内被下载 36,607,347 次,日均约 1,220,245 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@capsizecss/unpack 还在维护吗?

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