Guide de reference du langage ActionScript 2.0 - PowWeb

DisplacementMapFilter
(flash.filters.DisplacementMapFilter)
Object
|
+-flash.filters.BitmapFilter
|
+-flash.filters.DisplacementMapFilter
public class DisplacementMapFilter
extends BitmapFilter
La classe DisplacementMapFilter utilise les valeurs de pixels de l'objet BitmapData spécifié
(intitulé image de mappage du déplacement) pour déplacer un objet situé sur la scène, telle
qu'une occurrence MovieClip. Vous pouvez utiliser ce filtre pour obtenir un effet voilé ou de
tacheté sur une occurrence BitmapData ou MovieClip.
L'utilisation de filtres dépend de l'objet auquel vous appliquez le filtre.
Pour appliquer des filtres aux clips lors de l'exécution, utilisez la propriété filters. Lorsque
vous définissez la propriété filters d'un objet, celui-ci n'est pas modifié. En outre, vous
pouvez l'annuler en supprimant la propriété filters.
Pour appliquer des filtres aux occurrences BitmapData, utilisez la méthode
BitmapData.applyFilter(). L'appel applyFilter() sur un objet BitmapData modifie ce
dernier et ne peut pas être annulé.
Vous pouvez également appliquer des effets de filtre aux images et aux données vidéo pendant
la programmation. Pour plus d'informations, consultez la documentation relative à la
programmation.
Si vous appliquez un filtre à un clip ou à un bouton, la propriété cacheAsBitmap du clip ou
du bouton est définie sur true. Si vous supprimez tous les filtres, la valeur d'origine de
cacheAsBitmap est restaurée.
Le filtre utilise la formule suivante :
dstPixel[x, y] = srcPixel[x + ((componentX(x, y) - 128) * scaleX) / 256, y +
((componentY(x, y) - 128) * scaleY) / 256]
où componentX(x, y) attribue la valeur de couleur componentX de la propriété mapBitmap à
(x - mapPoint.x ,y - mapPoint.y).
L'image de mappage utilisée par le filtre est redimensionnée afin de correspondre au
redimensionnement de la scène. Elle n'est en aucun cas redimensionnée lorsque l'objet l'est.
524 Chapitre 2: Classes ActionScript