Steinberg WaveLab 7 Operation Manual Italian Version

							4.9 Creazione di script 77
selectionSize() : restituisce il numero di campioni selezionati.
select(presetName) : carica il preset intervallo audio e ne applica l'impostazione al
Montaggio Audio attivo.
select(start, size) : seleziona vari campioni, a partire da una posizione specifica.
setFocusedTrack(index) : imposta la traccia attiva.
addMarker(type, name, comment) : aggiunge un marker nella posizione del cursore. I
valori possibili per typesono:
ˆ generic
ˆ temporary
ˆ cdTrackStart
ˆ cdTrackEnd
ˆ cdTrackFrontier
ˆ cdTrackIndex
ˆ loopStart
ˆ loopEnd
ˆ muteStart
ˆ muteEnd
ˆ playbackStarter
ˆ regionStart
ˆ regionEnd
ˆ errorStart
ˆ errorEnd
ˆ correctionStart
ˆ correctionEnd
Esempio:
activeWave.addMarker(generic, "SomeName", "SomeComment");
findNextMarkerPosition(posStartSearch, type) : ricerca il successivo marker ditypea
partire da una determinata posizione. Restituisce la posizione del marker, se individuata,
oppure -1.
insertMonoTrack(where) : aggiunge una traccia audio mono in corrispondenza dell'indice
'where'
insertStereoTrack(where) : aggiunge una traccia audio stereo in corrispondenza
dell'indice 'where'
insertClip(iTrack, timePosition, fileName, autoShift) : crea una clip da 'fileName', la
inserisce nella traccia 'iTrack' sulla linea temporale alla posizione 'timePosition', ed even-
tualmente sposta altre clip per creare lo spazio necessario, in base al parametro 'autoShift'
autoShift può avere uno dei seguenti valori:
WaveLab 7 
						

							78 WaveLab Concetti
ˆ autoShiftNo
ˆ autoShiftTrack
ˆ autoShiftGlobal
Questa funzione restituisce l'ID della prima clip creata, oppure 0.
clipWithName(name) : restituisce l'ID della prima clip con il nome 'name', oppure 0.
clipWithFile(name) : restituisce l'ID della prima clip che fa riferimento a 'fileName', oppure
0.
firstClip() : restituisce l'ID della prima clip del montaggio, oppure 0 se il montaggio è vuoto.
nextClip(clipId) : restituisce l'ID della clip salvata dopo 'clipId', oppure 0. Le clip non sono
ordinate in un ordine particolare. Utilizzando firstClip e nextClip è possibile accedere a tutte
le clip del montaggio.
clipName(clipId) : restituisce il nome della clip identificata da 'clipId'
clipPosition(clipId) : restituisce la posizione nella linea temporale della clip identificata da
'clipId'
clipSize(clipId) : restituisce la dimensione della clip identificata da 'clipId'
setClipName(clipId, name) : rinomina la clip identificata da 'clipId'
setTrackName(index, name) : rinomina la traccia identificata da 'index'
moveClip(clipId, newPos) : sposta nella linea temporale la clip identificata da 'clipId'
resizeClip(clipId, qlonglong newSize) : ridimensiona la clip identificata da 'clipId'. La
dimensione sarà limitata dal file audio cui fa riferimento la clip.
setClipDefaultFadeIn(clipId) : imposta la forma e il tempo di default del fade-in per la clip
identificata da 'clipId'
setClipDefaultFadeOut(clipId) : imposta la forma e il tempo di default del fade-out per la
clip identificata da 'clipId'
undo() : annulla l'ultimo comando.
Argomenti correlati
Riferimenti ECMAScript
4.9.2 Riferimenti ECMAScript
Il linguaggio di script di WaveLab si basa sul linguaggio di script ECMAScript, come definito
nello
standard ECMA-262 Anche i linguaggi JScript di Microsoft, JavaScript di Netscape e
Actionscript di Adobe si basano sullo standard ECMAScript. Se non si conosce il linguaggio
ECMAScript, in Internet è possibile trovare numerose informazioni e materiali di riferimento.
Questa pagina di riferimento contiene un elenco di tutti gli oggetti, le funzioni e le proprietà
di ECMAScript supportati dal sistema di scripting di WaveLab. Sono disponibili in ogni
contesto di scripting ma non sono specifici di WaveLab. Durante la configurazione dello
script per l'area di lavoro File audio, (tramite
Finestra di scripting (area di lavoro File Audio) )
sono disponibili altre funzioni specifiche che consentono di eseguire comandi di modifica.
WaveLab 7 
						

							4.9 Creazione di script 79
Per un elenco di comandi e funzioni di scripting specifici di WaveLab, vedere Linguaggio di
scripting WaveLab
.
Suggerimento: di seguito sono riportati alcuni esempi di scripting di base in modo da
poter vedere la sintassi di scripting in contesto. Questi script funzionano se vengono copiati,
incollati ed eseguiti in una finestra di script.
Sottoinsieme ECMAScript supportato
L'oggetto globale
Valori
ˆ NaN
ˆ Infinity
ˆ undefined
ˆ Math
Funzioni
ˆ eval(x)
ˆ parseInt(string, radix)
ˆ parseFloat(string)
ˆ isNaN(number)
ˆ isFinite(number)
ˆ decodeURI(encodedURI)
ˆ decodeURIComponent(encodedURIComponent)
ˆ encodeURI(uri)
ˆ encodeURIComponent(uriComponent)
Oggetti
ˆ Oggetto
ˆ Funzione
ˆ Matrice
ˆ Stringa
ˆ Booleano
ˆ Numero
ˆ Data
WaveLab 7 
						

							80 WaveLab Concetti
ˆ Espressione regolare
ˆ Errore
Esempi:
//Test if a value is not a number
var isNumber = isNaN("this is a string");
//Print the result in the log window
logWindow.printInfo(isNumber); //Traces "true" because it is a String
//Convert a string to a number
var numStr = "2,345";
var num = parseFloat(numStr);
//Print the result in the log window
logWindow.printInfo(num);
//Encode a string into an internet valid ASCII String
var str = "a sentence with spaces";
var encodedStr = encodeURI(str);
logWindow.printInfo(encodedStr);
Oggetto funzione
Prototipi
ˆ toString()
ˆ toLocaleString()
ˆ valueOf()
ˆ hasOwnProperty(V)
ˆ isPrototypeOf(V)
ˆ propertyIsEnumerable(V)
Funzioni
ˆ toString()
ˆ apply(thisArg, argArray)
ˆ call(thisArg [, arg1 [, arg2, ...]])
Esempio:
//Create a new custom marker Object
function customMarker(name, comment, timeSecs)
{
this.name=name;
this.comment=comment;
this.timeSecs=timeSecs;
}
//Create a new instance of the custom marker
var myMarker=new customMarker("A custom marker", "My custom marker comments",5);
WaveLab 7 
						

							4.9 Creazione di script 81
//Use prototype function to add a new property to it
customMarker.prototype.samples = null;
myMarker.samples = activeWave.sampleRate() * myMarker.timeSecs;
//Trace the results in the log window
logWindow.printInfo(myMarker.name);
logWindow.printInfo(myMarker.samples);
Oggetti matrice
Funzioni
ˆ toString()
ˆ toLocaleString()
ˆ concat([item1 [, item2 [, ...]]])
ˆ join(separator)
ˆ pop()
ˆ push([item1 [, item2 [, ...]]])
ˆ reverse()
ˆ shift()
ˆ slice(start, end)
ˆ sort(comparefn)
ˆ splice(start, deleteCount[, item1 [, item2 [, ...]]])
ˆ unshift([item1 [, item2 [, ...]]])
Esempio:
//Create an empty array
var a = new Array();
//Add some items to it
a.push("first array item");
a.push("next array item", "last array item");
//Print them out in the Log window
logWindow.printInfo(a.toString());
//Call the Array's reverse function
a.reverse();
//View the results in the Log window
logWindow.printInfo(a.toString());
Oggetti stringa
Funzioni
ˆ toString()
ˆ valueOf()
ˆ charAt(pos)
WaveLab 7 
						

							82 WaveLab Concetti
ˆ charCodeAt(pos)
ˆ concat([string1 [, string2 [, ...]]])
ˆ indexOf(searchString ,position)
ˆ lastIndexOf(searchString, position)
ˆ localeCompare(that)
ˆ match(regexp)
ˆ replace(searchValue, replaceValue)
ˆ search(regexp)
ˆ slice(start, end)
ˆ split(separator, limit)
ˆ substring(start, end)
ˆ toLowerCase()
ˆ toLocaleLowerCase()
ˆ toUpperCase()
ˆ toLocaleUpperCase()
Esempio:
//Create a string variable
var str = new String("WaveLab is a powerful editing tool");
//Make it all upper case
var capsStr = str.toUpperCase();
//View the results in the Log window
logWindow.printInfo(capsStr);
Oggetti matrice
Funzioni
ˆ toString()
ˆ valueOf()
Esempio:
//Test if an equation is true or false
var isTrue = (1 + 1 == 3);
//Convert the Boolean to a String and trace in the Log window
logWindow.printInfo(isTrue.toString());
WaveLab 7 
						

							4.9 Creazione di script 83
Oggetti numero
Funzioni
ˆ toString(radix)
ˆ toLocaleString()
ˆ toFixed(fractionDigits)
ˆ toExponential(fractionDigits)
ˆ toPrecision(precision)
Esempio:
//Convert a number into exponential notation
var num = new Number(13,3714);
//Show the result in the Log window
logWindow.printInfo(num.toExponential());
Oggetti matematici
Valori
ˆ E
ˆ LN10
ˆ LN2
ˆ LOG2E
ˆ LOG10E
ˆ PI
ˆ SQRT1 2
ˆ SQRT2
Funzioni
ˆ abs(x)
ˆ acos(x)
ˆ asin(x)
ˆ atan(x)
ˆ atan2(y, x)
ˆ ceil(x)
ˆ cos(x)
ˆ exp(x)
WaveLab 7 
						

							84 WaveLab Concetti
ˆ floor(x)
ˆ log(x)
ˆ max([value1 [, value2 [, ...]]])
ˆ min([value1 [, value2 [, ...]]])
ˆ pow(x, y)
ˆ random()
ˆ round(x)
ˆ sin(x)
ˆ sqrt(x)
ˆ tan(x)
Esempi:
//Get a random number from 0 to 1
var r = Math.random();
//Print it out in the log window
logWindow.printInfo(r);
//Trace out Pi in the log window
logWindow.printInfo(Math.PI);
Oggetti data
Funzioni
ˆ toString()
ˆ toDateString()
ˆ toTimeString()
ˆ toLocaleString()
ˆ toLocaleDateString()
ˆ toLocaleTimeString()
ˆ valueOf()
ˆ getTime()
ˆ getFullYear()
ˆ getUTCFullYear()
ˆ getMonth()
ˆ getUTCMonth()
ˆ getDate()
ˆ getUTCDate()
WaveLab 7 
						

							4.9 Creazione di script 85
ˆ getDay()
ˆ getUTCDay()
ˆ getHours()
ˆ getUTCHours()
ˆ getMinutes()
ˆ getUTCMinutes()
ˆ getSeconds()
ˆ getUTCSeconds()
ˆ getMilliseconds()
ˆ getUTCMilliseconds()
ˆ getTimeZoneOffset()
ˆ setTime(time)
ˆ setMilliseconds(ms)
ˆ setUTCMilliseconds(ms)
ˆ setSeconds(sec [, ms])
ˆ setUTCSeconds(sec [, ms])
ˆ setMinutes(min [, sec [, ms]])
ˆ setUTCMinutes(min [, sec [, ms]])
ˆ setHours(hour [, min [, sec [, ms]]])
ˆ setUTCHours(hour [, min [, sec [, ms]]])
ˆ setDate(date)
ˆ setUTCDate(date)
ˆ setMonth(month [, date])
ˆ setUTCMonth(month [, date])
ˆ setFullYear(year [, month [, date]])
ˆ setUTCFullYear(year [, month [, date]])
ˆ toUTCString()
Esempio:
//Create a new date object
var d = new Date();
//Print it out in the log window
logWindow.printInfo(d);
//Get just the hours
logWindow.printInfo(d.getHours());
WaveLab 7 
						

							86 WaveLab Concetti
Oggetti espressioni regolari
Funzioni
ˆ exec(string)
ˆ test(string)
ˆ toString()
Esempio:
//Create a new regular expression defining a 5 digit number
var reg = new RegExp(/^\d{5}$/);
//Test a string with it to see if it contains a 5 digit number
var isFiveDigit = reg.test("12345");
//Trace the result to the log window
logWindow.printInfo(isFiveDigit);
Oggetti errore
Valori
ˆ name
ˆ message
Funzioni
ˆ toString()
Tipi di errori nativi disponibili
ˆ EvalError
ˆ RangeError
ˆ ReferenceError
ˆ SyntaxError
ˆ TypeError
ˆ URIError
Argomenti correlati
Linguaggio di scripting WaveLab
Finestra di scripting (area di lavoro File Audio)
Finestra di scripting (area di lavoro Montaggio Audio)
WaveLab 7