# @gl-transitions/remotion 中文文档

规范地址：https://npmcn.com/package/%40gl-transitions/remotion/

版本：2\.0\.0
npm 元数据更新时间：2026-11-05T11:13:58.247Z
中文译文更新时间：2026-11-16T15:25:39.840Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40gl-transitions/remotion
原文对照：https://npmcn.com/package/%40gl-transitions/remotion/?lang=original
项目主页：https://gl-transitions.com/
源码仓库：https://github.com/gl-transitions/gl-transitions

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

- 包体积（解压后）：87.7 kB，13 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：remotion \>=4\.0\.500，gl-transitions ^3\.0\.0，@remotion/transitions \>=4\.0\.500
- 首次发布：2026-10-18T15:48:34.969Z
- 最新版本发布：2026-11-05T11:13:57.869Z
- 近 30 天下载量：3831（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：4（近 12 个月 4 个）

## 中文简介

使用任何 gl- 过渡作为回旋演示文稿

## 安装

```sh
npm install @gl-transitions/remotion
```

也可以使用：`pnpm add @gl-transitions/remotion`、`yarn add @gl-transitions/remotion`、`bun add @gl-transitions/remotion`

## README

# @gl-过渡/复苏

全部都给我 [gl- 过渡](https://gl-transitions.com/) 内 [暂停](https://www.remotion.dev/)数字 : `glTransition()` 做一个演示,介绍其中之一 `<TransitionSeries>`在任何两个场景之间.

它从中绘制每个转换的 GLSL 源 `gl-transitions` 包含 WebGL 2 的软件包,由 GL 过渡规格描述。 通过更新实现新过渡 `gl-transitions`。 。 。 .

## 安装

```sh
npm install gl-transitions @gl-transitions/remotion @remotion/transitions
```

需要4.0.500 或以后再动。 场景是用感动的 [HTML 扫描](https://www.remotion.dev/docs/html-in-canvas)数字 :

-   **渲染** (单位:千美元)`npx remotion render`,服务器侧APIs,Lambda)在框外工作: Remotion的浏览器已启用. 对于没有 GPU 的 WebGL, 渲染为 `--gl=swangle` 以一物配一物, `--gl=angle`。 。 。 .
-   **工作室** chrome 149 或以后与 `chrome://flags/#canvas-draw-element` 启用 。 预览可以在过渡开始时闪出,如Remotion自己的HTML-in-canvas演示文稿;所提供视频不受影响.

## 使用量

```tsx
import { linearTiming, TransitionSeries } from "@remotion/transitions";
import { glTransition } from "@gl-transitions/remotion";

export const MyVideo = () => (
  <TransitionSeries>
    <TransitionSeries.Sequence durationInFrames={60}>
      <SceneA />
    </TransitionSeries.Sequence>
    <TransitionSeries.Transition
      presentation={glTransition({ name: "CrossWarp" })}
      timing={linearTiming({ durationInFrames: 30 })}
    />
    <TransitionSeries.Sequence durationInFrames={60}>
      <SceneB />
    </TransitionSeries.Sequence>
  </TransitionSeries>
);
```

画面可以是任何标记:图像,视频,文本,其他成分.

### 选项

| 选项 | 类型 | 页:1 |
| --- | --- | --- |
| `name` | 字符串 | 从 [gl- transiters.com (英语)](https://gl-transitions.com/); 自动完成 |
| `params` | 对象 | 转换的参数, 每个转换的输入; 留下的参数保留默认值 |
| `textures` | 对象 | 需要额外的图像, 按名称, 作为 URL : `luma` "卢马威", `displacementMap` 用于"迁移地图". 铸造等待他们装载 |

```tsx
glTransition({ name: "Cube", params: { persp: 0.7, unzoom: 0.3 } });
glTransition({ name: "LumaWipe", textures: { luma: staticFile("spiral.png") } });
```

当一个过渡绘制出透明的像素时(当它画出没有图像时,如在立方体周围) `Cube` 或旁边 `LeftRight`图像, Remotion 的输出显示一个被捕获的场景或者黑色在那里,而不是下面的地层 `<TransitionSeries>`。 。 。 .

## 发展

在那个 [gl- 过渡存储器](https://github.com/gl-transitions/gl-transitions), (中文(简体) ), `examples/remotion` 是使用此软件包的还原项目 : `pnpm run studio` 打开它 `scripts/check.mjs` 使用 Remotion 的渲染器进行每次转换, 并将其与其 GLSL 的参考渲染相比较, 就像 Remotion 的工作流程对每个牵引请求一样.

## 常见问题

### @gl-transitions/remotion 是什么？

使用任何 gl- 过渡作为回旋演示文稿

### 如何安装 @gl-transitions/remotion？

在项目目录运行 npm install @gl-transitions/remotion，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：remotion（\>=4\.0\.500）、gl-transitions（^3\.0\.0）、@remotion/transitions（\>=4\.0\.500）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @gl-transitions/remotion 支持 TypeScript 吗？

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

### @gl-transitions/remotion 支持 ESM 还是 CommonJS？

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

### @gl-transitions/remotion 可以商用吗？

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

### @gl-transitions/remotion 的下载量有多少？

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

### @gl-transitions/remotion 还在维护吗？

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

