mcut
@mcut/timeline

captureZoomPreset

Generated TypeScript API reference for the public mcut SDK.

mcut SDK


mcut SDK / timeline/src / captureZoomPreset

Function: captureZoomPreset()

function captureZoomPreset(
   element,
   name,
   fromLocalMs?,
   toLocalMs?):
  | {
  durationMs: number;
  name: string;
  tracks: Partial<Record<"position.x" | "position.y" | "scale.x" | "scale.y", object[]>>;
}
  | null;

Defined in: packages/timeline/src/zoom-presets.ts:155

Capture the keyframes between two element-local times as a reusable zoom preset ("save what I just hand-animated"). Values normalize relative to each track's first keyframe; returns null when the range has no zoomable keyframes.

Parameters

element

TimelineElement

name

string

fromLocalMs?

number

toLocalMs?

number

Returns

Type Literal

{
  durationMs: number;
  name: string;
  tracks: Partial<Record<"position.x" | "position.y" | "scale.x" | "scale.y", object[]>>;
}

durationMs

durationMs: number;

Default length; override at apply time.

name

name: string;

tracks

tracks: Partial<Record<"position.x" | "position.y" | "scale.x" | "scale.y", object[]>>;

null

On this page