# @flare-engine/math 中文文档

规范地址：https://npmcn.com/package/%40flare-engine/math/

版本：0\.4\.12
npm 元数据更新时间：2026-11-12T19:45:55.368Z
中文译文更新时间：2026-11-14T21:26:34.598Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40flare-engine/math
原文对照：https://npmcn.com/package/%40flare-engine/math/?lang=original
项目主页：https://github.com/grzott/flare-engine#readme
源码仓库：https://github.com/grzott/flare-engine

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

- 包体积（解压后）：341 kB，12 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=20
- 运行依赖：0 个
- 首次发布：2026-06-09T16:19:43.531Z
- 最新版本发布：2026-11-12T19:45:54.932Z
- 近 30 天下载量：5015（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：17（近 12 个月 17 个）

## 中文简介

Vec2, Rect, 变形, 颜色, 放松, 交叉测试

## 安装

```sh
npm install @flare-engine/math
```

也可以使用：`pnpm add @flare-engine/math`、`yarn add @flare-engine/math`、`bun add @flare-engine/math`

## README

# @flare-engine/ math (英语)

火焰引擎的2D数学原始- `Vec2`, (中文(简体) ), `Rect`, (中文(简体) ), `Circle`, (中文(简体) ), `Transform2D`, (中文(简体) ), `Mat3`, (中文(简体) ), `Color` (单位:千美元) `argbToFloat4Into` 包装 `0xAARRGGBB` ),35个放松功能,种子RNG,相交测试,角度/策略帮助者(`angleDelta`, (中文(简体) ), `rotateTowards`, (中文(简体) ), `Vec2.turnVelocityTowardInto`, (中文(简体) ), `Vec2.scaleToLengthInto`, (中文(简体) ), `Vec2.perp`, (中文(简体) ), `Vec2.crossSV`),加权随机抽取(`weightedIndex`, (中文(简体) ), `weightedIndexBy`, (中文(简体) ), `weightedPick`(b) 确定散列功用`hashU32`, (中文(简体) ), `seededIndex`)和计时窗口奖励数学(`cappedBonus`, (中文(简体) ), `advanceWindowedStreak`, (中文(简体) ), `windowExpired`, (中文(简体) ), `remainingInWindow`) (中文(简体) ). 具有静态方法命名空间的平面对象类型; 零空格形式为 `out` 在游戏循环中避免GC压力的参数.

## 安装

```sh
bun add @flare-engine/math
```

## 使用量

```ts
import { vec2, Vec2, Rect, easeOutQuad, SeededRNG } from '@flare-engine/math';

const a = vec2(0, 0);
const b = vec2(10, 0);
const out = vec2(0, 0);
Vec2.lerp(a, b, 0.5, out);

const rng = new SeededRNG(42);
const t = easeOutQuad(rng.float(0, 1));
```

## 曲线

四方式/立方体贝塞尔和Catmull-Rom取样,每个取样都有分配表和一个 `…Into` 双向 每帧使用,外加大约弧长:

```ts
import { bezier3Into, catmullRom, bezier3Length, vec2 } from '@flare-engine/math';

// Sampling a path each frame — reuse one buffer, allocate nothing.
const point = vec2(0, 0);
bezier3Into(0, 0, 20, 60, 80, 60, 100, 0, 0.35, point);

// Catmull-Rom passes *through* p1 and p2, so a path hits its waypoints exactly.
const onPath = catmullRom(0, 0, 10, 5, 20, 5, 30, 0, 0.5);

// Arc length is a chord approximation, so always a slight underestimate.
const length = bezier3Length(0, 0, 20, 60, 80, 60, 100, 0, 32);
```

控制点是松散的数字而不是 `Vec2` 对象,因此坐标已按 `Float32Array` 可以在不先建造临时工的情况下取样. `t` 被夹住 `[0, 1]` 相当 比推断.

## 段相交点

`intersection.ts` 答题 _是否为_ 形状相交; 这些答案 _地点_ 两段交叉:

```ts
import { segmentIntersection, segmentsIntersect, vec2, segmentIntersectionInto } from '@flare-engine/math';

segmentIntersection(5, 0, 5, 10, 0, 5, 10, 5); // → { x: 5, y: 5 }

// Zero-alloc form; `out` is left untouched when the result is null.
const hit = vec2(0, 0);
segmentIntersectionInto(0, 0, 10, 10, 0, 10, 10, 0, hit);
```

**折叠重叠返回 `null`。 。 。 .** 卧倒在地上的两个部分确实相互交接 有许多要点——因此没有一点可以报告。 询问 `segmentsIntersect` 当 是/无答案是你想要的;它返回 `true` 为了那个案子.

## 决定保存和重放

`SeededRNG` 将整个状态暴露为一英寸32,因此运行可以存储并准确恢复:

```ts
import { SeededRNG } from '@flare-engine/math';

const rng = new SeededRNG(1234);
const savedState = rng.getState(); // JSON-safe — store it beside the save

const restored = new SeededRNG(0);
restored.setState(savedState); // next() now continues the original sequence
```

见 [API 规格](https://github.com/grzott/flare-engine/blob/main/docs/design/api-specs.md#flare-enginemath--5kb-gzip)。 。 。 .

## 许可证

阿帕奇 - 2.0

## 常见问题

### @flare-engine/math 是什么？

Vec2, Rect, 变形, 颜色, 放松, 交叉测试

### 如何安装 @flare-engine/math？

在项目目录运行 npm install @flare-engine/math，或使用 pnpm add / yarn add / bun add。

### @flare-engine/math 支持 TypeScript 吗？

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

### @flare-engine/math 支持 ESM 还是 CommonJS？

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

### @flare-engine/math 需要什么版本的 Node\.js？

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

### @flare-engine/math 可以商用吗？

@flare-engine/math 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @flare-engine/math 的下载量有多少？

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

### @flare-engine/math 还在维护吗？

最新版本 0\.4\.12 发布于 2026/11/13（3 天前）；至今共发布 17 个版本，其中过去 12 个月发布了 17 个；首次发布于 2026/06/10。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。