Steinberg WaveLab Elements 7 Manual descargar pdf (Pagina 80)

66 WaveLab Concepts

Audio File Scripting Commands

Objects

activeWave

Object representing the active Audio File.

Many functions make use of presets as an argument. For example, the normalize() function

accepts a preset as an argument:

activeWave.normalize("myPreset");

The advantage is that you don't need to specify many parameters in your scripts, instead you

can use the corresponding dialog to deﬁne the settings of a particular function, and then

save them as a preset ﬁle. Since each type of preset is unique, you don't need to specify a

full path name to the preset. Only specifying the preset name is enough, there is no need for

its extension. Since presets can also be stored in a sub-folder, you can use a relative path

name if necessary.

So if for example, you wanted to normalize a ﬁle using a preset you had deﬁned in the Nor-

malize level dialog (and saved in a sub-folder as a preset), it would look like this:

activeWave.normalize("mySubFolder/myPreset");

All audio processing functions operate on the selected audio range. If there is no selection

the whole ﬁle range will be processed (if that editing option is selected in Audio File editing

preferences). If the cursor or selection is in one channel only, only that channel is processed.

In other words, it operates exactly the same as if you were applying a process from within a

dialog.

All positions and sizes are measured in sample units. If you wish to specify a time range in

another unit you will need to convert it from samples.

var twoSeconds = 2 * activeWave.sampleRate();

Functions

size() - Returns the number of samples in the Audio File.

sampleRate() - Returns the sample rate of the Audio File.

numChannels() - Returns the number of channels of the Audio File.

cursorPosition() - Returns the current cursor position (in samples).

setCursorPosition(pos) - Sets the current cursor position at a certain sample location.

selectionStart() - Returns the index of the ﬁrst selected sample, or -1 if there is no selection.

selectionSize() - Returns the number of selected samples.

select(presetName) - Loads the audio range preset and applies its setting to the active

Audio File.

select(start, size) - Selects a number of samples, starting from a given position.

setCursorChannel(channel) - Sets the cursor position to a new channel, Use leftCh,

rightCh or allCh as arguments.

WaveLab 7

1 2 ... 75 76 77 78 79 80 81 82 83 84 85 ... 427 428

Sin comentarios

Steinberg WaveLab Elements 7 Manual Pagina 80