Open source CapCut alternative.
TypeScript
import { createRasterCanvas, type RasterSurface } from "./raster";
import { CLIP_MIN_SECONDS, type MediaAsset, type StoredAsset } from "./types";
// A block is a shot with nothing in it yet: a source that holds a slot on the
// timeline and draws itself as the colour that shot sits on. It owns no file,
// so blocking out a cut writes nothing to storage and decodes nothing; the
// picture is painted once, at whatever size asks for it, and cached by the
// reader that asked. A clip playing a block cuts, trims, moves and takes a
// transition like any other clip, and the day the footage arrives it replaces
// the block in place.
//
// Nothing is written in the frame. The label says what the person brings and
// belongs to them — it rides the timeline chip and the editor state — so a
// blocked-out cut previews and exports as the look it is standing in for,
// never as a caption describing itself.
export const BLOCK_COLOR = "#161A22";
/** The most shots one blockout call lays down: two full detect_cuts passes,
* so a template's whole shot list goes down as one undo step. */
export const BLOCKOUT_MAX = 160;
/** The shortest block: the shortest clip every renderer plays, one frame. */
export const BLOCK_MIN_SECONDS = CLIP_MIN_SECONDS;
/** The longest block. */
export const BLOCK_MAX_SECONDS = 600;
/** The source a shot stands on until its footage exists. It takes the
* project's own frame, so a block fills the picture the way the footage that
* replaces it will. */
export function blockAsset(
shot: { seconds: number; label?: string; color?: string },
i: number,
frame: { w: number; h: number }
): MediaAsset {
const label = shot.label?.trim() || `Shot ${i + 1}`;
return {
id: `block-${Date.now().toString(36)}-${i}-${Math.random().toString(36).slice(2, 6)}`,
// No file: nothing is stored, so nothing is named on disk either.
fileName: "",
name: label,
type: "image",
duration: shot.seconds,
width: frame.w,
height: frame.h,
url: "",
block: { label, ...(shot.color ? { color: shot.color } : {}) },
// Cut made this, so it belongs where it was made and not in the Media
// panel with the person's own imports.
origin: "block",
};
}
/** Paint a block at this size. Both frame readers — the preview's and the
* export's — call this in place of fetching and decoding a still. */
export function drawBlock(
asset: Pick<StoredAsset, "block">,
width: number,
height: number
): RasterSurface {
const w = Math.max(16, Math.round(width));
const h = Math.max(16, Math.round(height));
const canvas = createRasterCanvas(w, h);
const ctx = canvas.getContext("2d") as CanvasRenderingContext2D | null;
if (!ctx) return canvas;
ctx.fillStyle = asset.block?.color || BLOCK_COLOR;
ctx.fillRect(0, 0, w, h);
return canvas;
}