fisheye-motion

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Fisheye Motion（鱼眼畸变 + 摩尔纹 + 暗角）

Fisheye Motion (Fisheye Distortion + Moiré + Vignette)

把一张图片（或视频）做成「用手机拍屏幕」的质感：以聚焦点为中心的桶形鱼眼畸变、跟随画面弯曲的扫描线与固定屏幕扫描线干涉出的摩尔纹、四周暗角；并可输出「推镜聚焦到目标区域 + 黄色标注块从左滑入」的 Remotion 视频。

Turn an image (or video) into the feel of “photographing a screen with a phone”: barrel fisheye distortion centered on the focus point, scanlines that follow the curvature of the image interfering with fixed screen scanlines to create moiré, and vignetting around the edges. It can also output a Remotion video featuring a “push-in focus onto a target area + yellow annotation block sliding in from the left.”

工作流程

Workflow

本 skill 不内置代码，所有实现都在独立仓库里。第一步永远是 clone 项目：

bash

git clone https://github.com/vibe-motion/fisheye-motion.git
cd fisheye-motion

仓库结构：

根目录：Vite + React 交互测试应用（拖图、点击/拖动移动聚焦、导出 PNG）
```
src/lib/FisheyeRenderer.js
```
：与框架无关的 WebGL 渲染器（核心，全部效果的 shader 在这里）
```
src/lib/FisheyeView.jsx
```
：React 组件封装
```
vibe-motion-app/
```
：Remotion 项目，输出聚焦推镜 + 标注滑入的视频

然后根据用户需求走两条路之一。

This skill does not include code; all implementations reside in a standalone repository. The first step is always to clone the project:

bash

git clone https://github.com/vibe-motion/fisheye-motion.git
cd fisheye-motion

Repository structure:

Root directory: Vite + React interactive test app (drag an image, click/drag to reposition the focus, export PNG)
```
src/lib/FisheyeRenderer.js
```
: framework-agnostic WebGL renderer (the core; all effect shaders are here)
```
src/lib/FisheyeView.jsx
```
: React component wrapper
```
vibe-motion-app/
```
: Remotion project that outputs focus push-in + annotation slide-in videos

Then follow one of two paths depending on the requirements.

路线 A：静态效果 / 交互预览（Vite 应用）

Path A: Static Effects / Interactive Preview (Vite App)

bash

npm install
npm run dev

默认加载
```
public/test.jpg
```
；把用户的图放进
```
public/
```
或直接拖入页面。
点击/拖动画面改变聚焦（畸变中心）；「导出 PNG」保存当前效果帧。
要在自己的 React 项目里复用，直接拷
```
src/lib/
```
两个文件，用法见仓库 README。

bash

npm install
npm run dev

Loads
```
public/test.jpg
```
by default; place the user's image in
```
public/
```
or drag it directly onto the page.
Click/drag the image to change the focus (distortion center); “Export PNG” saves the current effect frame.
To reuse it in your own React project, copy the two files in
```
src/lib/
```
directly; see the repository README for usage.

路线 B：视频输出（Remotion 项目）

Path B: Video Output (Remotion Project)

bash

cd vibe-motion-app
pnpm install          # postinstall 自动准备 headless 浏览器
pnpm run dev          # Remotion Studio 预览

把用户的源图放到
```
vibe-motion-app/public/
```
下。
改
```
motion/config.js
```
：
- ```
imageSrc
```
  ：public 下的文件名
- ```
videoWidth
```
  /
```
videoHeight
```
  ：按源图等比取偶数尺寸
- ```
focusFrom
```
  →
```
focusTo
```
  ：聚焦推镜起止点（0..1 源图坐标，y 向下）
- ```
rect
```
  ：标注块位置
```
{ x, y, w, h }
```
  （0..1 源图坐标）、颜色、混合模式
- 时间轴：
```
focusStartSec/focusEndSec
```
  （推镜段）、
```
maskStartSec/maskEndSec
```
  （标注滑入段）、
```
durationSeconds
```
渲染：

bash

undefined

bash

cd vibe-motion-app
pnpm install          # postinstall 自动准备 headless 浏览器
pnpm run dev          # Remotion Studio 预览

Place the user's source image under
```
vibe-motion-app/public/
```
.
Modify
```
motion/config.js
```
:
- ```
imageSrc
```
  : filename under
```
public
```
- ```
videoWidth
```
  /
```
videoHeight
```
  : even dimensions proportional to the source image's aspect ratio
- ```
focusFrom
```
  →
```
focusTo
```
  : starting and ending points of the focus push-in (0..1 source-image coordinates, with y pointing downward)
- ```
rect
```
  : annotation block position
```
{ x, y, w, h }
```
  (0..1 source-image coordinates), color, and blend mode
- Timeline:
```
focusStartSec/focusEndSec
```
  (push-in segment),
```
maskStartSec/maskEndSec
```
  (annotation slide-in segment), and
```
durationSeconds
```
Render:

bash

undefined

透明 ProRes 4444 mov（默认）

pnpm run remotion:render

H.264 mp4

REMOTION_OUTPUT=out/fisheye.mp4 REMOTION_CODEC=h264 REMOTION_PIXEL_FORMAT=yuv420p pnpm run remotion:render


4. 需要 GIF 预览时用 ffmpeg 转：

```bash
ffmpeg -i out/fisheye.mp4 -vf "fps=15,scale=540:-1:flags=lanczos,palettegen" /tmp/p.png
ffmpeg -i out/fisheye.mp4 -i /tmp/p.png -lavfi "fps=15,scale=540:-1:flags=lanczos[x];[x][1:v]paletteuse=dither=bayer:bayer_scale=4" out/fisheye.gif

REMOTION_OUTPUT=out/fisheye.mp4 REMOTION_CODEC=h264 REMOTION_PIXEL_FORMAT=yuv420p pnpm run remotion:render


4. When a GIF preview is needed, convert it with ffmpeg:

```bash
ffmpeg -i out/fisheye.mp4 -vf "fps=15,scale=540:-1:flags=lanczos,palettegen" /tmp/p.png
ffmpeg -i out/fisheye.mp4 -i /tmp/p.png -lavfi "fps=15,scale=540:-1:flags=lanczos[x];[x][1:v]paletteuse=dither=bayer:bayer_scale=4" out/fisheye.gif

定位目标区域（rect / focusTo）

Locating the Target Area (rect / focusTo)

用户通常会说「聚焦到 XX 文字/按钮上」。定位方法：

用多模态视觉读源图，估计目标区域的 0..1 归一化坐标（y 向下）。
```
focusTo
```
取该区域中心；
```
rect
```
框住目标，稍留 padding。
渲染一帧检查（Studio 里拖时间轴，或
```
REMOTION_OUTPUT=out/check.png
```
配合单帧渲染），不准就微调坐标重来。畸变会弯曲画面，最终以渲染结果为准。

Users will typically say “focus on the XX text/button.” To locate it:

Use multimodal vision to inspect the source image and estimate the target area's normalized coordinates (0..1, with y pointing downward).
Set
```
focusTo
```
to the center of that area; use
```
rect
```
to enclose the target, leaving a little padding.
Render a frame for inspection (drag the timeline in Studio, or use
```
REMOTION_OUTPUT=out/check.png
```
with single-frame rendering). If it is inaccurate, adjust the coordinates and try again. Distortion bends the image, so the final rendered result is authoritative.

参数速查

Parameter Quick Reference

参数	默认	说明
`strength`	1.6	畸变强度，0 = 无畸变， `p' = p·(1 + strength·r²) / zoom`
`zoom`	2	中心缩放（配合聚焦推镜）
`moire`	`{ intensity: 0.28, scale: 900, angle: 0 }`	摩尔纹强度/频率/角度
`vignette`	`{ amount: 0.85, radius: 0.72, softness: 0.45 }`	暗角
`rect.blend`	`screen`	深色底图白字用 `screen` ；浅色底图深字用 `multiply` （荧光笔效果）

Parameter	Default	Description
`strength`	1.6	Distortion strength; 0 = no distortion, `p' = p·(1 + strength·r²) / zoom`
`zoom`	2	Center zoom (used with the focus push-in)
`moire`	`{ intensity: 0.28, scale: 900, angle: 0 }`	Moiré intensity/frequency/angle
`vignette`	`{ amount: 0.85, radius: 0.72, softness: 0.45 }`	Vignette
`rect.blend`	`screen`	Use `screen` for white text on a dark background; use `multiply` for dark text on a light background (highlighter effect)

注意事项

Notes

Remotion 并行/乱序渲染帧，动画量必须每帧独立计算——已由
```
motion/timeline.js
```
保证，改动画逻辑时保持这一约束，不要引入跨帧状态。
场景用 WebGL shader，headless 渲染需要
```
--gl angle
```
，渲染脚本已默认设置。
视觉效果非必要不跑自动化验证，渲染后目测（或发关键帧给用户确认）。

Remotion renders frames in parallel and out of order, so animation values must be calculated independently for every frame. This is already guaranteed by
```
motion/timeline.js
```
; preserve this constraint when changing the animation logic and do not introduce cross-frame state.
Scenes use a WebGL shader, and headless rendering requires
```
--gl angle
```
. The rendering script sets this by default.
For visual effects, avoid running automated validation unless necessary. Visually inspect the result after rendering, or send keyframes to the user for confirmation.

效果示例

Example

聚焦推镜到「浙大」二字并滑入黄色标注（

assets/fisheye-demo.gif

）：

Focus push-in onto the “Zhejiang University” text and slide in a yellow annotation (

assets/fisheye-demo.gif