S > Sound.setTransform

Sound.setTransform

Disponibilité

Flash Player 5.

Usage

monSon.setTransform(objetDeTransformationDeSon) 

Paramètres

objetDeTransformationDeSon Un objet créé avec le constructeur de l'objet générique Object.

Renvoie

Rien.

Description

Méthode ; définit les informations de transformation (balance) du son pour un objet Sound.

Le paramètre objetDeTransformationDeSon est un objet que vous créez avec la méthode constructeur de l'objet générique Object avec des paramètres spécifiant comment le son est réparti dans les canaux gauche et droit (haut-parleurs).

Les sons utilisent un espace disque et une mémoire considérables. Les sons stéréo utilisant deux fois plus de données que les sons mono, il est généralement conseillé d'utiliser des sons mono de 6 bits et 22 kHz. Vous pouvez utiliser la méthode setTransform pour lire des sons mono en stéréo, des sons stéréo en mono, et pour ajouter des effets sonores intéressants.

Les paramètres de objetDeTransformationDeSon sont les suivants :

11 Une valeur de pourcentage spécifiant la quantité de l'entrée gauche à lire dans le haut-parleur gauche (0-100).

1r Une valeur de pourcentage spécifiant la quantité de l'entrée droite à lire dans le haut-parleur gauche (0-100).

rr Une valeur de pourcentage spécifiant la quantité de l'entrée droite à lire dans le haut-parleur droit (0-100).

rl Une valeur de pourcentage spécifiant la quantité de l'entrée gauche à lire dans le haut-parleur droit (0-100).

Le résultat net de ces paramètres est représenté par la formule suivante :

sortieGauche = entrée_gauche * ll + entrée_droite * lr
sortieDroite = entrée_droite * rr + entrée_gauche * rl

Les valeurs de entrée_gauche ou entrée_droite sont déterminées par le type de son (mono ou stéréo) de votre animation.

Les sons stéréo divisent l'entrée de son de manière égale entre les haut-parleurs droit et gauche et ont les paramètres de transformation par défaut suivants :

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

Les sons mono sont lus dans le haut-parleur gauche et ont les paramètres de transformation par défaut suivants :

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

Exemple

L'exemple suivant illustre un résultat pouvant être obtenu avec la méthode setTransform, mais pas avec les méthodes setVolume ou setPan, même combinées.

Le code suivant crée un objet monObjetDeTransformationDeSon et définit ses propriétés de manière à ce que le son des deux canaux soit lu uniquement dans le canal gauche.

monObjetDeTransformationDeSon = new Object;
monObjetDeTransformationDeSon.ll = 100;
monObjetDeTransformationDeSon.lr = 100;
monObjetDeTransformationDeSon.rr = 0;
monObjetDeTransformationDeSon.rl = 0;

Pour appliquer l'objet monObjetDeTransformationDeSon à un objet Sound, vous devez alors transmettre l'objet à l'objet Sound avec la méthode setTransform, comme suit :

monSon.setTransform(monObjetDeTransformationDeSon);

L'exemple suivant lit un son stéréo en mono, le monObjetDeTransformationDeSonMono ayant les paramètres suivants :

monObjetDeTransformationDeSonMono = new Object;
monObjetDeTransformationDeSonMono.ll = 50;
monObjetDeTransformationDeSonMono.lr = 50;
monObjetDeTransformationDeSonMono.rr = 50;
monObjetDeTransformationDeSonMono.rl = 50;
monSon.setTransform(monObjetDeTransformationDeSonMono);

Cet exemple lit le canal gauche à la moitié de sa capacité et ajoute le reste du canal gauche dans le canal droit ; monObjetDeTransformationDeSonMoitié a les paramètres suivants.

monObjetDeTransformationDeSonMoitié = new Object;
monObjetDeTransformationDeSonMoitié.ll = 50;
monObjetDeTransformationDeSonMoitié.lr = 0;
monObjetDeTransformationDeSonMoitié.rr = 100;
monObjetDeTransformationDeSonMoitié.rl = 50;
setTransform(monObjetDeTransformationDeSonMoitié);

Voir aussi

Constructeur pour l'objet Object