editor/docs/reference/jsx/transitions.md
konstantin-paulus 7372c40429 Update documentation references and refactor knowledge handling
- Changed references from `knowledge` to `docs` in README and various files to reflect the new documentation structure.
- Updated `.gitignore` to exclude the `docs` directory instead of `knowledge`.
- Refactored `forge.config.ts` and `main.ts` to utilize the new `docs` directory for staging resources.
- Introduced `stage-docs.mjs` script to manage the staging of documentation files.
- Added new documentation files under `docs/`, including `INSTRUCTIONS.md`, brand guidelines, and design specifications.
- Removed outdated `knowledge` related tests and files to streamline the codebase.
2026-09-11 20:33:57 +02:00

38 lines
1.6 KiB
Markdown

# Transitions
`transition` declares a transition **into the next clip**, set on the **outgoing** clip and rendered centered on the cut. It is valid only on direct children of [`<sequence>`](./sequences.md).
```tsx
<sequence>
<video src="/Movies/intro.mp4" width={1920} height={1080} start={0} end={12} transition={{ type: "fadeToBlack", duration: "20f" }} />
<video src="/Movies/main.mp4" width={1920} height={1080} start={12} end={24} transition={{}} /> {/* dissolve, 1s */}
<video src="/Movies/outro.mp4" width={1920} height={1080} start={24} end={30} />
</sequence>
```
```ts
type TransitionSpec = {
type?: TransitionType; // default "dissolve"
duration?: Time; // length, centered on the cut; default 1 second
};
```
## Types
The editor's transition inspector options:
| `type` | Effect |
| ------ | ------ |
| `"dissolve"` (default) | Crossfade between the two clips. |
| `"slideFromRight"` | The next clip slides in from the right. |
| `"slideFromLeft"` | The next clip slides in from the left. |
| `"fadeToBlack"` | Fade out to black, then in to the next clip. |
| `"fadeToWhite"` | Fade out to white, then in to the next clip. |
## Semantics
- `duration` takes any [time format](./timing.md#time-formats) and is centered on the cut: half plays before it, half after.
- A **partial value merges** into the clip's existing transition: `transition={{ duration: 2 }}` keeps the current type; `transition={{}}` applies the defaults.
- **`null` removes** the clip's transition.
- A transition is not an element of its own: it is a prop of the outgoing clip, so it moves, trims and copies with it.