Skip to main content

Sound

Experimental Feature

This is an experimental feature. To enable, check Enable Experimental Features in Preferences. Experimental features are only available as part of a Professional licence.

Intro

Use audio to drive deformation or values.

UI

Common Attributes +

File - Drag in an audio file from the Asset Window

Equalizer - Preview your sound file and isolate Frequency Bands. Use your cursor to remove/ add bands to be omitted/ included. The buttons to the right will select or deselect all bands.

Frequency Bands - Set the number of bands to sample.

Volume Clipping - Values that fall below this threshold will be ignored (represented by a red line in the equalizer).

Value Offset - Add/ remove a value to the input.

Frame Offset - Offset audio playback in the timeline.

Sub Steps - Can be used to 'smooth' the sound signal. With a value of 0 Cavalry samples the audio file at each frame number. By adding sub steps Cavalry will sample more often. e.g. a value of 1 will sample at frames 0.5, 1 and 1.5 and create an average of those values.

Smoothing Frames - Can be used to 'smooth' the sound signal. This will increase the number of frames to create a sample. e.g. a value of 2 will sample the current frame and the one before and average out those values.

Maximum dB - (Output) The maximum dB value found within the asset connected to the File attribute.

File Length - (Output) The length of the asset connected to the File attribute (in frames).

tip

The Sound Behaviour outputs in dB (decibels) so this can differ depending on the audio asset.

info

Dragging an audio file directly from the Assets Window into the Scene Window or Viewport will create a Sound Behaviour and connect the audio file.

caution

When using Sub Steps and Smoothing Frames expect a performance hit of (smoothingFrames+1)subSteps(smoothingFrames+1)*subSteps

e.g. Smoothing Frames = 2 and Sub Steps = 4 will create a (2 + 1) * 4 = 12x time penalty on the node.

danger
  • In order to hear audio in playback you'll need to enable Audio Playback in the settings at the bottom of the Viewport.
  • It is not currently possible to export audio.
  • Embedded audio (e.g. in a .mov) is not currently supported. Please see Assets Window for supported audio formats.