setTransform (Sound.setTransform-Methode)

public setTransform(transformObject:Object) : Void

Legt die Soundtransformations- bzw. Balanceinformationen für ein Sound-Objekt fest.

Im Parameter soundTransformObject geben Sie ein Objekt an, das Sie mit der Konstruktormethode der generischen Object-Klasse erstellen. Dabei verwenden Sie Parameter, die die Verteilung des Sounds auf den rechten und linken Kanal (Lautsprecher) angeben.

Sounddateien belegen viel Speicherplatz auf der Festplatte und im Arbeitsspeicher. Da Stereosounds doppelt so viel Speicher benötigen wie Monosounds, empfiehlt sich im Allgemeinen die Verwendung von 6-Bit-Monosounds mit 22 kHz. Mit setTransform() können Sie Monosounds in Stereo und Stereosounds in Mono wiedergeben und interessante Effekte hinzufügen.

Hinweis: In Flash Lite 2.0 wird diese Methode nur für nativen Flash-Sound unterstützt. Hostgerätspezifische Soundformate werden nicht unterstützt.

ll - Ein Prozentwert, der angibt, welcher Anteil des linken Eingangssignals über den linken Lautsprecher wiedergegeben wird (von 0 bis 100).

lr - Ein Prozentwert, der angibt, welcher Anteil des rechten Eingangssignals über den linken Lautsprecher wiedergegeben wird (von 0 bis 100).

rr - Ein Prozentwert, der angibt, welcher Anteil des rechten Eingangssignals über den rechten Lautsprecher wiedergegeben wird (von 0 bis 100).

rl - Ein Prozentwert, der angibt, welcher Anteil des linken Eingangssignals über den rechten Lautsprecher wiedergegeben wird (von 0 bis 100).

Das Gesamtergebnis der Parametereinstellungen wird durch folgende Formel ausgedrückt:

leftOutput = left_input ~ ll + right_input ~ lr
rightOutput = right_input ~ rr + left_input ~ rl

Die Werte für left_input und right_input richten sich nach der Art des Sounds (stereo oder mono) in der SWF-Datei.

Bei Stereosounds wird der Soundeingang gleichmäßig auf den linken und den rechten Lautsprecher verteilt. Es gelten die folgenden Standardeinstellungen für die Transformation:

ll = 100
lr = 0
rr = 100
rl = 0

Bei Monosounds werden alle Eingangssignale auf dem linken Lautsprecher wiedergegeben. Es gelten die folgenden Standardeinstellungen für die Transformation:

ll = 100
lr = 100
rr = 0
rl = 0

Parameter

transformObject:Object - Ein Objekt, das mithilfe des Konstruktors für die generische Object-Klasse erstellt wurde.

Beispiel

Die Einstellung im folgenden Beispiel kann nur mit setTransform() realisiert werden und nicht mit setVolume() und setPan(), selbst wenn sie kombiniert werden.

Mit dem folgenden Code wird ein neues soundTransformObject-Objekt erstellt und dessen Eigenschaften so definiert, dass Sound aus beiden Kanälen nur auf dem linken Kanal wiedergegeben wird.

var mySoundTransformObject:Object = new Object();
mySoundTransformObject.ll = 100;
mySoundTransformObject.lr = 100;
mySoundTransformObject.rr = 0;
mySoundTransformObject.rl = 0;

Um soundTransformObject auf ein Sound-Objekt anzuwenden, müssen Sie es mit setTransform() an das Sound-Objekt übergeben:

my_sound.setTransform(mySoundTransformObject);

Im folgenden Beispiel wird ein Stereosound in Mono wiedergegeben. Das Objekt soundTransformObjectMono verfügt über folgende Parameter:

var mySoundTransformObjectMono:Object = new Object();
mySoundTransformObjectMono.ll = 50;
mySoundTransformObjectMono.lr = 50;
mySoundTransformObjectMono.rr = 50;
mySoundTransformObjectMono.rl = 50;
my_sound.setTransform(mySoundTransformObjectMono);

Im folgenden Beispiel wird der linke Kanal mit halber Kapazität wiedergegeben und der Rest des linken Kanals zum rechten Kanal hinzugefügt. Das Objekt soundTransformObjectHalf verfügt über folgende Parameter:

var mySoundTransformObjectHalf:Object = new Object();
mySoundTransformObjectHalf.ll = 50;
mySoundTransformObjectHalf.lr = 0;
mySoundTransformObjectHalf.rr = 100;
mySoundTransformObjectHalf.rl = 50;
my_sound.setTransform(mySoundTransformObjectHalf);

var mySoundTransformObjectHalf:Object = {ll:50, lr:0, rr:100, rl:50};

setTransform (Sound.setTransform-Methode)

Parameter

Beispiel

Siehe auch