@remotion/webcodecs: new rotateAndResizeVideoFrame() API

[Copilot]

This PR promotes the rotateAndResizeVideoFrame() function from WebCodecsInternals to a proper documented public API of @remotion/webcodecs. The function now provides a clean interface for rotating and resizing video frames with improved usability.

Changes Made

API Changes

• Exported as public API: rotateAndResizeVideoFrame is now directly exported from @remotion/webcodecs
• Optional parameter: needsToBeMultipleOfTwo is now optional with a default value of false
• Backward compatibility: Function remains available in WebCodecsInternals to avoid breaking existing code

Documentation

• Created comprehensive documentation page with examples and API reference
• Added to the webcodecs TableOfContents and sidebar navigation
• Generated documentation image using the render-cards script

Testing

• Added unit tests covering function signature, parameter validation, and error handling
• Tests verify the optional parameter behavior and function exports
• All existing tests continue to pass

Usage Examples

import {rotateAndResizeVideoFrame} from '@remotion/webcodecs';

// Rotate a video frame by 90 degrees
const rotatedFrame = rotateAndResizeVideoFrame({
  frame,
  rotation: 90,
  resizeOperation: null,
});

// Resize by width with codec-compatible dimensions
const resizedFrame = rotateAndResizeVideoFrame({
  frame,
  rotation: 0,
  resizeOperation: { mode: 'width', width: 640 },
  needsToBeMultipleOfTwo: true, // Optional, defaults to false
});

API Reference

• frame: VideoFrame object to transform
• rotation: Rotation angle in degrees (multiples of 90)
• resizeOperation: Resize operation or null
• needsToBeMultipleOfTwo?: Optional boolean for dimension constraints (default: false)

The function supports all existing functionality while providing a more user-friendly interface with sensible defaults.

Fixes #5413.

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
bugs	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Jun 18, 2025 4:12pm
remotion	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Jun 18, 2025 4:12pm

[JonnyBurger]

Clarify this in the docs:

It only returns a new VideoFrame if a transform has happened, otherwise it returns the original frame. Remember the user has to manually perform memory cleanup,

so the user may have to perform a check like

if (frames !== rotatedFrame) {
oldFrame.close()
}

[Copilot]

Clarify this in the docs:

It only returns a new VideoFrame if a transform has happened, otherwise it returns the original frame. Remember the user has to manually perform memory cleanup,
...

I've updated the documentation to clarify when the function returns the original frame vs a new frame, and added a dedicated Memory Management section with the exact cleanup pattern you suggested. The docs now clearly explain that users should check if (transformedFrame !== originalFrame) before closing the original frame. (f1d68ad)