<实验性.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

属性 x、y、width 和 height 定义应捕获的像素矩形。所有属性都是必需的，并需要一个整数。

规则

1

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

2

如果 imageFormat 是 jpeg，剩余帧将变为黑色；如果 imageFormat 是 png，剩余帧将变为透明。

3

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

另请参阅

• <Experimental.Null>