Edit command

replaceClipMedia

Points a clip at another file, adding it to the bin first if it is not there. The clip keeps its length, looks and name, and its in-point unless sourceStart moves it: an enhanced copy stands in frame for frame, a reversed span starts at its own zero. The bin keeps the original.

Fields

  • clipIdstringrequired

    The clip to re-point.

  • itemNewMediarequired

    The probed copy, as described by the host.

  • enhancedbooloptional

    The copy is the clip's Enhance: the clip keeps the media it showed before as the original, so Enhance can be switched off (see setClipEnhanced). Any other copy - a reversed one - ends the clip's Enhance, which was of the media now gone.

  • offsetnumberoptional · default 0

    With enhanced, the seconds into the original the copy starts at (see Enhanced); sourceStart is then the clip's in-point in the copy.

  • sourceStartnumberoptional

    A new in-point in the copy, in seconds, floored at 0. Absent keeps the clip's.