g_Audio_Wave

Reference
Index

    Brings audio data into DarkTree.

How does it work?

    The Audio Wave component allows you to synchronize an animated DarkTree to an audio source.

    This component is just like any of the Generator components, except the data for the generator comes from an audio file that is loaded into the component.  It has all of the standard generator parameters, in addition to some specific parameters for filtering the audio data.

    The Frame Rate and Number of Frames parameters don't actually modify the texture at all. They are a simple calculator built into the component to help you synchronize an animated texture to an audio file. Simply enter the desired playback rate for the animated texture into the Frame Rate parameter, and the Number of Frames parameter will update to show you how many frames to render out for the animation.

    The Raw Data parameter chooses between raw waveform data and volume data.

    Raw waveform data starts at 50% and alternates between high and low values.  This is similar to computer displays of recorded sound. When in this mode, the frequency is in tenths of a second. That is, when the frequency is set to 1.0, you will see 1/10th of a second of sound in the preview.

    Volume data starts at 0% when it is quiet and gets larger as the sound gets louder.  It is a relatively slow changing signal, so the frequency is in seconds.

    The Filter Strength parameter sets how much to filter the data.  Depending on how you are going to use the audio data, you might need to filter it heavily to avoid aliasing problems.

    Use the Right Channel and Mix Channels parameters to select how to process a stereo audio file.  You can mix both channels together into one, or choose just the left or right channels.  If the file isn't a stereo file, these parameters will be ghosted.

Standard Generator Parameters

 

Amplitude

Describes the function height above and below the horizontal axis. The default value is 50.0%. Increase the function height up to 100.0% or it flatten out at 0.0%.

 

Shift

Repositions the function vertically, above or below its default position on the horizontal axis. At 100.0% the function is entirely above this axis; at 0.0% it's entirely below. The default is 50.0%.

 

 

 

 

Frequency

Compresses the function horizontally when the value is greater than the default of 1.0. Or stretches the function horizontally when the value is less than 1.0.

 

Phase Amount

Phase repositions the function along the horizontal axis. Phase Amount gives a percent value for the phase range set by Phase Min and Phase Max.

 

 

 

 

Phase Min

Sets one end of the phase range.

 

 

 

 

Phase Max

Sets the other end of the phase range.

 

Lower Clamp

Controls the minimum function value. The default is 0.0%.

 

Upper Clamp

Controls the maximum function value. The default is 100.0%.

 

 

 

 

Invert

When enabled, flips the function about the horizontal axis.

 

 

 

 

Reverse

When enabled, reverses the function. For symmetrical functions, you may not see the difference.

 

Input

Function re-mapping input. Link this to an linear time component to shift the function into the time domain.

Percent Component Parameters

 

 

 

 

Filename

This is the name of the audio file to use.

 

 

 

 

Frame Rate

Set the desired playback rate for the animated DarkTree here.

 

 

 

 

Number of Frames

This is the number of frames to render out to synchronize the DarkTree animation to the audio file.

 

 

 

 

Repeat Flag

When checked, the audio data will repeat.

 

 

 

 

Seconds

Length, in seconds, of the audio file loaded.

 

 

 

 

Raw Data

Select between the raw data and volume data.

 

 

Filter Strength

How much filtering to apply to the waveform.

 

 

 

 

Right Channel

Select between right and left channels of a stereo data file.

 

 

 

 

Mix Channels

Mix both right and left channels of a stereo file into one channel.

Darkling Simulations
Copyright 1996-2003