Guide de reference du langage ActionScript 2.0 - PowWeb

paletteMap (méthode BitmapData.paletteMap)
public paletteMap(sourceBitmap:BitmapData, sourceRect:Rectangle,
destPoint:Point, [redArray:Array], [greenArray:Array], [blueArray:Array],
[alphaArray:Array]) : Void
Remappe les valeurs des canaux de couleur dans une image recevant jusqu'à quatre tableaux
de données de palette de couleurs, un pour chaque canal.
Flash Player utilise la formule suivante pour générer l'image résultante.
Une fois le calcul des valeurs rouge, vert, bleu et alpha effectué, celles-ci sont additionnées en
effectuant une opération arithmétique standard s'articulant autour d'un entier 32 bits. Les
valeurs de couleur rouge, vert, bleu et alpha de chaque pixel sont extraites dans une valeur
comprise entre 0 et 255 distincte. Ces valeurs sont utilisées pour rechercher les nouvelles
valeurs de couleur dans le tableau approprié : redArray, greenArray, blueArray et
alphaArray. Chacun de ces quatre tableaux doit contenir 256 valeurs. Une fois les quatre
nouvelles valeurs de canaux récupérées, elles sont combinées dans une valeur ARVB standard
appliquée au pixel.
Les effets multi-canaux sont pris en charge par cette méthode. Chaque tableau d'entrée peut
contenir des valeurs entières 32 bits ; aucun décalage ne se produit lorsque les valeurs sont
additionnées. Cette routine ne prend pas en charge le verrouillage canal par canal.
Si aucun tableau n'est spécifié pour un canal, le canal de couleur est simplement copié de
l'image source vers l'image de destination.
Vous pouvez utiliser cette méthode pour de nombreux effets, tel que le mappage de palette
général (qui consiste à sélectionner un canal pour le convertir en image couleur de valeur
false). Vous pouvez également utiliser cette méthode pour de nombreux algorithmes de
manipulation de couleurs avancés, tels que gamma, courbes, niveaux et quantification.
Disponibilité : ActionScript 1.0 ; Flash Player 8
Paramètres
sourceBitmap:flash.display.BitmapData - L'image bitmap d'entrée à utiliser. L'image
source peut être un objet BitmapData différent ou peut faire référence à l'objet BitmapData
actuel.
sourceRect:flash.geom.Rectangle - Un rectangle qui définit la zone de l'image source à
utiliser en tant qu'entrée.
destPoint:flash.geom.Point - Le point sur l'image de destination (l'objet BitmapData
actuel) correspondant au coin supérieur gauche du rectangle source.
redArray:Array [facultatif] - Si redArray n'est pas null, red = redArray[source red
value] else red = source rect value.
328 Chapitre 2: Classes ActionScript