konstantin-paulus 1bbe992345 Refactor and enhance transform functionality in the asset management system
- Replaced the `useModifiers` hook with `useTransforms` to better reflect the new transform functionality.
- Updated components to utilize the new `useTransforms` hook, including `ActionBar` and `PromptInputActions`, improving the handling of transformations.
- Introduced new `TransformItem` component for managing transform actions in the UI.
- Refactored asset handling logic to accommodate the new transform types and ensure compatibility with existing features.
- Removed deprecated modifier-related code and documentation, streamlining the codebase and enhancing clarity.
- Updated documentation to reflect changes in transform functionality and usage examples.
2026-09-12 16:31:36 +02:00

1.9 KiB

<audio>

An audio clip: no picture, carries volume. When timing is omitted, the node fits its natural duration (see timing.md).

It draws nothing inside a scene, but on the canvas it is still something to point at: the editor shows its waveform in a box, and x/y/width/height are where that box is. Leave them off inside a scene, where they mean nothing.

<audio src="music/bed.mp3" start={2.2} sourceOut={16} volume={-6} />

Props

Prop Type Default Meaning
src string | AssetRef required See media.md.
id, name string see elements.md Address and label.
x, y number 0 Where the waveform box sits on the canvas. No meaning inside a scene.
width, height number 500, 150 Size of that box.
start, end, sourceIn, sourceOut Time see timing.md Temporal placement.
playbackRate number 1 Speed multiplier for the clip's local time.
volume number 0 Decibels: 0 = unity, negative attenuates (-6 ≈ half as loud), -Infinity = silence. Not linear.
muted boolean false Excludes the node's audio from the mix; independent of volume.
syncTo string none id of another element carrying audio; derives start by audio alignment (see audio-sync.md). Mutually exclusive with start.

An audio clip has no picture, so it takes no transform beyond its canvas box and no paints. Its children are <keyframeTrack> (a volume track) and <animation>, of which only "gain" is audible:

<audio src="music/bed.mp3" start={0} end={12} volume={-16}>
  <animation type="gain" duration={1} />
  <animation type="gain" phase="out" duration={2} />
</audio>