Skip to main content

<实验性.Clipper>

EXPERIMENTAL

此包目前是一项技术验证。

API 可能会在任何版本中更改。升级时,请监视此文档页面以查看重大更改。

这是一个特殊的组件,将导致 Remotion 仅部分捕获视频帧。其余区域将保持黑色(如果渲染图像格式为 jpeg)或透明(如果渲染图像格式为 png)。

如果您使用 renderStill() 渲染 PDF 或 WebP,则无法使用此组件。

示例

只会渲染组件的左半部分:

EmptyFrame.tsx
tsx
import { AbsoluteFill, Experimental, useVideoConfig } from "remotion";
 
export const MyComp: 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.tsx
tsx
import { AbsoluteFill, Experimental, useVideoConfig } from "remotion";
 
export const MyComp: 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

属性 xywidthheight 定义应捕获的像素矩形。所有属性都是必需的,并需要一个整数。

规则

即使在 <Clipper> 组件之外,偶数元素也将被裁剪。

如果 imageFormatjpeg,剩余帧将变为黑色;如果 imageFormatpng,剩余帧将变为透明。

每帧只能呈现一个 <Experimental.Null><Experimental.Clipper> 组件。呈现多个将导致错误。

另请参阅