mcut SDK

mcut SDK / timeline/src / getTrack

Function: getTrack()

function getTrack(project, trackId):
  | {
  elements: TimelineElement[];
  hidden: boolean;
  id: `t-${string}`;
  locked: boolean;
  magnetic: boolean;
  muted: boolean;
  name: string;
}
  | undefined;

Defined in: packages/timeline/src/selectors.ts:11

Parameters

project

assets

Record<string, { durationMs?: number; hash?: string; height?: number; id: `a-${string}`; kind: "video" | "audio" | "image"; mimeType?: string; name?: string; nativePreview?: boolean; src: string; width?: number; }> = ...

fps

number = ...

height

number = ...

id

string = ...

layouts

object[] = ...

Multicam layout templates this project references. See layouts.ts.

markers

object[] = ...

Timeline markers, sorted by timeMs (the commands keep them sorted).

name

string = ...

presets

object[] = ...

Named inspector value bundles (style presets). See presets.ts.

tracks

object[] = ...

Render order: index 0 is painted first (bottom); last is topmost.

version

1 = ...

Project format version (see migrations.ts). parseProject migrates older documents before validating; the default covers in-memory creation.

width

number = ...

trackId

`t-${string}`

Returns

Type Literal

{
  elements: TimelineElement[];
  hidden: boolean;
  id: `t-${string}`;
  locked: boolean;
  magnetic: boolean;
  muted: boolean;
  name: string;
}

elements

elements: TimelineElement[];

Sorted by startMs; never overlapping in time.

hidden

hidden: boolean;

Visuals from this track are not rendered.

id

id: `t-${string}` = trackIdSchema;

locked

locked: boolean;

UI hint: track rejects edits. The engine does not enforce this.

magnetic

magnetic: boolean;

When enabled, edits compact this track so clips keep no gaps between them.

muted

muted: boolean;

Audio from this track is silenced.

name

name: string;

undefined