MACROMEDIA FLASH 8-ACTIONSCRIPT 2.0 LANGUAGE, Reference

Page: 524 / 1378

524 ActionScript classes
mode (DisplacementMapFilter.mode property)
public mode : String
The mode for the filter. Possible values are the following:
■
"wrap"
— Wraps the displacement value to the other side of the source image. This is the
default value.
■
"clamp"
— Clamps the displacement value to the edge of the source image.
■
"ignore"
— If the displacement value is out of range, ignores the displacement and uses
the source pixel.
■
"color"
— If the displacement value is outside the image, substitutes a pixel value
composed of the
alpha
and
color
properties of the filter.
Availability: ActionScript 1.0; Flash Player 8
Example
The following example modifies
scaleY
to create a displacement value that is out of range
and then changes the
mode
property on the existing MovieClip
filteredMc
to
ignore
when
a user clicks it.
import flash.filters.DisplacementMapFilter;
import flash.display.BitmapData;
import flash.geom.Point;
import flash.geom.Matrix;
import flash.geom.ColorTransform;
var filteredMc:MovieClip = createDisplacementMapRectangle();
filteredMc.onPress = function() {
var filter:DisplacementMapFilter = this.filters[0];
filter.scaleY = 25;
filter.mode = "ignore";
this.filters = new Array(filter);
}
function createDisplacementMapRectangle():MovieClip {
var mapBitmap:BitmapData = createGradientBitmap(300, 80, 0xFF000000,
"radial");
var filter:DisplacementMapFilter = new DisplacementMapFilter(mapBitmap,
new Point(-30, -30), 1, 1, 10, 10, "wrap", 0x000000, 0x000000);
var txtBlock:MovieClip = createTextBlock();
txtBlock._x = 30;
txtBlock._y = 30;
txtBlock.filters = new Array(filter);