Skip to main content

<Freeze>

Available from v2.2.0.

When using the <Freeze/> component, all of its children will freeze to the frame that you specify as a prop.

If a component is a child of <Freeze/>, calling the useCurrentFrame() hook will always return the frame number you specify, irrespective of any <Sequence>.

<Html5Video />, <Video> and <OffthreadVideo /> elements will be paused and <Html5Audio /> and <Audio> elements will render muted.

Example​

MyComp.tsx
tsx
import {Freeze} from 'remotion';
 
const MyVideo = () => {
  return (
    <Freeze frame={30}>
      <BlueSquare />
    </Freeze>
  );
};

API​

The Freeze component is a high order component and accepts, besides it's children, the following props:

frame​

At which frame it's children should freeze.

activev4.0.127​

Deactivate freezing component by passing false.
You may also pass a callback function and accept the current frame and return a boolean.

From frame 30 on
tsx
import {Freeze} from 'remotion';
 
const MyVideo = () => {
  return (
    <Freeze frame={30} active={(f) => f < 30}>
      <BlueSquare />
    </Freeze>
  );
};

Demo​

0
0:00 / 0:05

See also​