Guide de reference du langage ActionScript 2.0 - PowWeb

filters (propriété MovieClip.filters)
public filters : Array
Un tableau indexé contenant tous les objets filtre associés au clip. Le package flash.filters
contient plusieurs classes qui définissent des filtres spécifiques.
Ces filtres peuvent s'appliquer dans l'outil de programmation de Flash pendant la phase de
conception ou d'exécution du code ActionScript. Pour appliquer un filtre avec ActionScript,
vous devez créer une copie temporaire de l'intégralité du tableau MovieClip.filters,
modifier le tableau temporaire, puis reporter les valeurs de ce tableau temporaire dans le
tableau MovieClip.filters. Vous ne pouvez pas ajouter directement un nouvel objet filtre
au tableau MovieClip.filters. Le code suivant n'a aucun effet sur le clip cible, appelé
myMC :
myMC.filters[0].push(myDropShadow);
Pour ajouter un filtre avec ActionScript, vous devez suivre les étapes ci-dessous (dans cet
exemple le clip est appelé myMC) :
■ Créez un objet filtre avec la fonction constructeur de la classe de filtre retenue.
■ Affectez la valeur du tableau myMC.filters à un tableau temporaire, tel qu'un tableau
appelé myFilters.
■ Ajoutez le nouvel objet filtre au tableau temporaire, myFilters.
■ Affectez la valeur du tableau temporaire au tableau myMC.filters.
Si le tableau filters est vide, il n'est pas nécessaire d'utiliser un tableau temporaire. Par
contre, vous pouvez affecter directement un littéral de tableau contenant un ou plusieurs des
objets filtre que vous avez créés.
Pour modifier un objet filtre existant, que ce dernier ait été créé pendant la phase de
conception ou d'exécution, vous devez appliquer la technique de modification d'une copie du
tableau filters :
■ Affectez la valeur du tableau myMC.filters à un tableau temporaire, tel qu'un tableau
appelé myFilters.
■ Modifiez la propriété avec le tableau temporaire, myFilters. Par exemple, si vous
souhaitez définir la propriété quality du premier filtre du tableau, utilisez le code suivant :
myList[0].quality = 1;
■ Affectez la valeur du tableau temporaire au tableau myMC.filters.
Pour supprimer les filtres pour un clip, définissez filters sur un tableau vide ([]).
892 Chapitre 2: Classes ActionScript