marker_add_transition_timeline
Add a crossfaded transition timeline to a transition marker or region, blending source and destination audio to avoid hard jump-cuts.
Instructions
Add a transition timeline to a transition marker/region/loop region/magnet region, with a source+destination sound pair — FMOD's "Add Transition Timeline" feature: a crossfaded transition instead of a hard jump-cut, the professional technique for a seamless loop.
Structurally verified live: this produces a valid TransitionTimeline
plus TransitionSourceSound/TransitionDestinationSound, both correctly
bound (a TransitionSourceSound/TransitionDestinationSound requires
both its audioTrack and parameter relationships set to be valid
— confirmed by creating one without them and observing isValid: false) and overlapped by crossfade_length seconds, which is what
makes FMOD blend them as a crossfade rather than play them back to
back. The exact blend hasn't been audibly verified against a real
render — audition it in Studio and adjust crossfade_length if the
blend isn't right; there's no scripted way to "listen" from here.
Args: transition_target: TransitionMarker/TransitionRegion/LoopRegion/ MagnetRegion {guid} to add the timeline to. audio_track_target: The GroupTrack {guid} whose audio is transitioning — the track being looped, for a simple single-track loop. crossfade_length: Overlap between outgoing and incoming audio, in seconds (default 1.0, must be > 0). Larger = smoother/slower blend.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"transition_target": "<transition_target>",
"audio_track_target": "<audio_track_target>"
},
"name": "marker_add_transition_timeline"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| crossfade_length | No | ||
| transition_target | Yes | ||
| audio_track_target | Yes |