# @frapx/core 中文文档

规范地址：https://npmcn.com/package/%40frapx/core/

版本：0\.9\.3
npm 元数据更新时间：2026-11-09T01:56:22.644Z
中文译文更新时间：2026-11-15T17:02:25.144Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40frapx/core
原文对照：https://npmcn.com/package/%40frapx/core/?lang=original
项目主页：https://kramhash.github.io/frapx/packages/core/
源码仓库：https://github.com/kramhash/frapx

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

- 包体积（解压后）：226 kB，17 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2026-07-12T07:38:19.237Z
- 最新版本发布：2026-11-09T01:56:22.238Z
- 近 30 天下载量：2111（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：12（近 12 个月 12 个）

## 中文简介

用于 frapx 包的共享 WebGL 运行时主机 .

## 安装

```sh
npm install @frapx/core
```

也可以使用：`pnpm add @frapx/core`、`yarn add @frapx/core`、`bun add @frapx/core`

## README

# @ frapx/ 核心

共享 WebGL 运行时主机 `@frapx` 软件包.

这个软件包是使用寿命周期的引擎(canvas设置,上下文管理和恢复,动画回路和时钟,a11y门,帧捕获),由您共享 `@frapx/fx-canvas`, (中文(简体) ), `@frapx/fx-passes` 财务报告和审定财务报表 `@frapx/fx-particles`它是一个低等构件,它的API可能在小版本之间变化,而 `@frapx/core` 现为 `0.x`。 。 。 .

如果您正在构建一个 WebGL 体验, 您很可能想要 [`@frapx/fx-canvas`](https://www.npmjs.com/package/@frapx/fx-canvas) (或另一个) `fx-*` 包)取而代之.

## 出口

用来建造新的 `fx-*` 在同一主机上的运行时间 :

-   `createRuntimeHost(options)` ——主持人:画布设置, `realtime` 编号 : `manual` 固定时钟 `resolution`,屏外/隐藏/减动门,上下文丢失并恢复,以及 `captureFrame()`。运行时插件通过 `createContext`, (中文(简体) ), `onInit`, (中文(简体) ), `onDraw`, (中文(简体) ), `onCaptureDraw`, (中文(简体) ), `captureSource`, (中文(简体) ), `onResize` 和上下文钩.
-   方案和制服—— `createProgram`, (中文(简体) ), `createFullscreenProgram`, (中文(简体) ), `createFullscreenBuffer`, (中文(简体) ), `collectUniformLocations`, (中文(简体) ), `applyUniform(s)`, (中文(简体) ), `normalizeUniform`, (中文(简体) ), `createUniformCache`, (中文(简体) ), `toUniformName` 编号 : `fromUniformName`。 。 。 .
-   纹理和目标—— `loadTexture`, (中文(简体) ), `createTextureSet`, (中文(简体) ), `createRenderTarget`, (中文(简体) ), `createPingPong`, (中文(简体) ), `supportsRenderTargetFormat`, (中文(简体) ), `resolveRenderTargetFormat`, (中文(简体) ), `createBlitter`。 。 。 .
-   时间表—— `createUniformBindings`, (中文(简体) ), `keyframes`。 。 。 .
-   帮助者—— `waitForGpu`, (中文(简体) ), `glsl`, (中文(简体) ), `glslUtils`, (中文(简体) ), `hexToRgb` 编号 : `hexToRgba`, (中文(简体) ), `parseShaderLog`, (中文(简体) ), `isWebGL2Context`, (中文(简体) ), `isGLSL300`, (中文(简体) ), `setupCanvas`, (中文(简体) ), `resolveDpr`。 。 。 .
-   错误—— `ShaderError`, (中文(简体) ), `ShaderCompileError`, (中文(简体) ), `UnsupportedError`, (中文(简体) ), `TargetNotFoundError`, (中文(简体) ), `TextureLoadError`, (中文(简体) ), `DestroyedError`。 。 。 .

## 许可证

麻省理工学院2026kramhash. 见 [自由主义](https://npmcn.com/package/%40frapx/core/LICENSE)。 。 。 .

## 常见问题

### @frapx/core 是什么？

用于 frapx 包的共享 WebGL 运行时主机 \.

### 如何安装 @frapx/core？

在项目目录运行 npm install @frapx/core，或使用 pnpm add / yarn add / bun add。

### @frapx/core 支持 TypeScript 吗？

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

### @frapx/core 支持 ESM 还是 CommonJS？

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

### @frapx/core 可以商用吗？

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

### @frapx/core 的下载量有多少？

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

### @frapx/core 还在维护吗？

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