Takes an audio source, creates a clip, assigns it the source,
then adds the clip to the given compound and track.
Clips are instances of action, shape, or audio sources that you have created.
They are represented by boxes on tracks in the mixer that you can move,
scale, copy, trim, cycle, bounce, etc. Clips define the range of frames over
which the animation, shape, or audio items in the source are active and play
back. Tracks are the background on which you add and sequence clips in the
animation mixer.
Note: Although you can create clips of audio sources in different formats
(e.g. 22050Hz mono, 44100Hz stereo, etc.), you cannot have a mixture of formats
instantiated. If you try to instantiate a source with a different sample rate
or format than is already instantiated, AddAudioClip will fail.
oReturn = AddAudioClip( Model, Source, [Compound], [Track], [Time], [Name] ); |
Returns the new audio Clip.
Parameter | Type | Description |
---|---|---|
Model | String | The model to add the clip to. |
Source | String | The source to create the clip from. Typically, a "source" is an audio source imported using ImportAudio. |
Compound | String | The compound container (track owner) to add this clip to. (Not currently used) |
Track | String |
The track to add this clip to. Note: If no track is specified, one will be created, and the clip will be put on that new track. |
Time | Double |
Frame at which to add the clip. Default Value: Current frame |
Name | String | Name to use for the new clip. |
' ' This example demonstrates how to create an audio clip. ' ' Create a model to insert the clip into. dim oModel, oAudioSource, oTrack, oClip CreateModel , "Container", , oModel ' Now choose the source audio file to use for the clip, and import it. set oAudioSource = ImportAudio( oModel, ,"Sound") ' Create a track in the mixer, and insert the audio clip within that track. set oTrack = AddTrack( oModel, , 2, "SoundTrack", 0 ) set oClip = AddAudioClip( oModel, oAudioSource, , oTrack, 5, "GoClip" ) |