mirror of
https://github.com/2234839/web-font.git
synced 2026-09-15 21:51:35 +08:00
d793e22d92
loca 偏移是大端，原 DataView.getUint16/32 逐次调用含边界检查开销。改用 Uint16/32Array 直接 view 共享 buffer + 内联字节翻转，微基准实测： - format0（Uint16）：157→84μs（-46%） - format1（Uint32）：152→93μs（-39%） （思源 30907 条 loca） 返回 Uint32Array 替代普通 Array，glyf.js 仅按下标 loca[index] 只读访问， 与 TypedArray 兼容（已确认 loca 仅被 glyf.js:22 读取、ttfreader.js:216 置 null）。 对齐保护：Uint16Array 需 2 字节对齐、Uint32Array 需 4 字节对齐，loca offset 来自表目录不保证对齐。检测 srcByteOff 对齐情况，未对齐回退 DataView 路径。 验证：基准测试 29 用例 SSIM 全部无回归；4 用例（思源千字文/标点/FiraCode/ttf） sha256 输出字节逐字节等价。 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
fonteditor-core
FontEditor core functions
Feature
Read and write sfnt font like ttf, woff, woff2, eot, svg, otf.
- sfnt parse
- read, write, transform fonts
- ttf (read and write)
- woff (read and write)
- woff2 (read and write)
- eot (read and write)
- svg (read and write)
- otf (only read and convert to ttf)
- ttf glyph adjust
- svg to glyph
- ESM compatibility for modern bundlers (Webpack, Rollup, Vite, Next.js, etc.)
- TypeScript support with type definitions
Usage
// read font file
import {createFont} from 'fonteditor-core';
import fs from 'fs';
const buffer = fs.readFileSync('font.ttf');
// read font data, support format:
// - for ttf, otf, woff, woff2, support ArrayBuffer, Buffer
// - for svg, support string or Document(parsed svg)
const font = createFont(buffer, {
// support ttf, woff, woff2, eot, otf, svg
type: 'ttf',
// only read `a`, `b` glyphs
subset: [65, 66],
// read font hinting tables, default false
hinting: true,
// read font kerning tables, default false
kerning: true,
// transform ttf compound glyph to simple
compound2simple: true,
// inflate function for woff
inflate: undefined,
// for svg path
combinePath: false,
});
const fontObject = font.get();
console.log(Object.keys(fontObject));
/* => [ 'version',
'numTables',
'searchRenge',
'entrySelector',
'rengeShift',
'head',
'maxp',
'glyf',
'cmap',
'name',
'hhea',
'post',
'OS/2',
'fpgm',
'cvt',
'prep'
]
*/
// write font file
const buffer = font.write({
// support ttf, woff, woff2, eot, svg
type: 'woff',
// save font hinting tables, default false
hinting: false,
// save font kerning tables, default false
kerning: false,
// write glyf data when simple glyph has no contours, default false
writeZeroContoursGlyfData: false,
// deflate function for woff, eg. pako.deflate
deflate: undefined,
// for user to overwrite head.xMin, head.xMax, head.yMin, head.yMax, hhea etc.
support: {head: {}, hhea: {}}
});
fs.writeFileSync('font.woff', buffer);
// to base64 str
font.toBase64({
// support ttf, woff, woff2, eot, svg
type: 'ttf'
});
// optimize glyphs
font.optimize()
// compound2simple
font.compound2simple()
// sort glyphs
font.sort()
// find glyphs
const result = font.find({
unicode: [65]
});
const result = font.find({
filter: function (glyf) {
return glyf.name === 'icon'
}
});
// merge another font object
font.merge(font1, {
scale: 1
});
Modern ES Module Usage
This library supports both CommonJS and ES Modules. For detailed information on using with modern bundlers, please see ESM_USAGE.md.
// ESM import
import fonteditorCore, { createFont, woff2 } from 'fonteditor-core';
createFont(buffer, options);
woff2
Notice: woff2 use wasm build of google woff2, before read and write woff2, we should first call woff2.init().
import {createFont, woff2} from 'fonteditor-core';
// in nodejs
woff2.init().then(() => {
// read woff2
const font = createFont(buffer, {
type: 'woff2'
});
// write woff2
const buffer = font.write({type: 'woff2'});
});
// in browser
woff2.init('/assets/woff2.wasm').then(() => {
// read woff2
const font = createFont();
// write woff2
const arrayBuffer = font.write({type: 'woff2'});
});
Demo
npm run dev
build
npm run build
test
npm run test
support
Node.js:>= 12.0
Browser: Chrome, Safari
Related
License
MIT © Fonteditor