<实验性.Clipper>
EXPERIMENTAL
此包目前是一项技术验证。
API 可能会在任何版本中更改。升级时,请监视此文档页面以查看重大更改。
这是一个特殊的组件,将导致 Remotion 仅部分捕获视频帧。其余区域将保持黑色(如果渲染图像格式为 jpeg
)或透明(如果渲染图像格式为 png
)。
如果您使用 renderStill()
渲染 PDF 或 WebP,则无法使用此组件。
示例
只会渲染组件的左半部分:
EmptyFrame.tsxtsx
import {AbsoluteFill ,Experimental ,useVideoConfig } from "remotion";export constMyComp :React .FC = () => {const {width ,height } =useVideoConfig ();return (<AbsoluteFill ><Experimental .Clipper x ={0}y ={0}width ={width / 2}height ={height } /><AbsoluteFill style ={{backgroundColor : "red" }}></AbsoluteFill ></AbsoluteFill >);};
EmptyFrame.tsxtsx
import {AbsoluteFill ,Experimental ,useVideoConfig } from "remotion";export constMyComp :React .FC = () => {const {width ,height } =useVideoConfig ();return (<AbsoluteFill ><Experimental .Clipper x ={0}y ={0}width ={width / 2}height ={height } /><AbsoluteFill style ={{backgroundColor : "red" }}></AbsoluteFill ></AbsoluteFill >);};
API
属性 x
、y
、width
和 height
定义应捕获的像素矩形。所有属性都是必需的,并需要一个整数。
规则
1 即使在 <Clipper>
组件之外,偶数元素也将被裁剪。
2 如果 imageFormat
是 jpeg
,剩余帧将变为黑色;如果 imageFormat
是 png
,剩余帧将变为透明。
3 每帧只能呈现一个 <Experimental.Null>
或 <Experimental.Clipper>
组件。呈现多个将导致错误。