用途:在 framefields(npm 包)项目中应用、配置和调制 WebGPU 后处理着色器,覆盖电影级调色、色调映射、程序化 VFX 与端上视觉(对象跟踪、分割、姿态、抠像)。需先完成 framefields 基础搭建;效果为强类型 Effect 子类,uniform 可由静态值、时间关键帧、响应式 Signal 或音频提取管线驱动。
主要能力:效果有四种挂载方式——图层级管线(Layer.withEffect)、整合成主乳剂(comp.apply)、空间与跟踪区域(comp.section / Layer.section)、媒体处理链(Media.apply,可 renderFrame 导出)。效果分四类:调色与色调(Curves、ColorBalance、Levels、SelectiveColor、GradientMap、ShadowsHighlights、ApplyLUT、Modulate);光学与电影质感(FilmGrain、Vignette、Blur 多模式、UnsharpMask、HighPass、HalftoneScreen、TileOffset、MotionBlur、TemporalDeflicker);3D 空间光照与材质(Relight3D、SSAO、PBRGlass、DepthOfField);遮罩抠像与边缘(ColorKey、Crop)。端上视觉支持 enableDetection、enableSegmentation、enablePose、enableMatte,模型首次使用时懒加载并缓存到 $FRAMEFIELDS_MODELS_DIR(默认 ~/.cache/framefields/models),variant 有 "t"/"s"/"m",默认 "s"。
使用方式:从 framefields 导入效果并挂载,例如图层加效果;整合成用 comp.apply 统一调色;局部用 comp.section;媒体链用 Media.apply 后 renderFrame。视觉用 comp.withVision 或 Layer.withVision 获取响应式信号(vision.objects、vision.masks、vision.poseLandmarks 等),可构建 Subject Sandwich、智能重构图、主体描边、跟踪区域模糊、analyzeVisionSequence 分析等。uniform 可传 sineSignal、computed 等响应式信号。
限制:视觉存在一帧延迟,首帧无结果;静态图需连续渲染至少两帧并保留最后一帧;mask/matte/crop 默认取最大人物,无人时取最可信实例;Selfie 抠像仅适合近景,远景易漏检;抽象画面建议提高 confidence;离线或 CI 需用 runner.preload 预下载或配置 FRAMEFIELDS_MODELS_BASE_URL。
暂未提供:价格与收费信息、具体平台限制、完整效果清单(资料指向 references/effects-catalog.md,未在本文给出)。