colors (GradientBevelFilter.colors property)

An array of RGB hexadecimal color values to use in the gradient. For example, red is 0xFF0000, blue is 0x0000FF, and so on.

The colors property cannot be changed by directly modifying its values. Instead, you must get a reference to colors, make the change to the reference, and then set colors to the reference.

The colors, alphas, and ratios properties are all related. The first element in the colors array corresponds to the first element in the alphas array and in the ratios array, and so on.

Example

The following example demonstrates how to set the colors property on an existing entity.

import flash.filters.GradientBevelFilter;

var mc:MovieClip = setUpFilter("colorsExample");
mc.onPress = function() {
    var arr:Array = this.filters;
    var colors:Array = [0x000000, 0xCCCCCC, 0xFFFFFF];
    arr[0].colors = colors;
    this.filters = arr;
}
mc.onRelease = function() {
    var arr:Array = this.filters;
    var colors:Array = [0xFFFFFF, 0xCCCCCC, 0x000000];
    arr[0].colors = colors;
    this.filters = arr;
}

function setUpFilter(name:String):MovieClip {
    var art:MovieClip = this.createEmptyMovieClip(name, this.getNextHighestDepth());
    var w:Number = 150;
    var h:Number = 150;
    art.beginFill(0xCCCCCC);
    art.lineTo(w, 0);
    art.lineTo(w, h);
    art.lineTo(0, h);
    art.lineTo(0, 0);

    var colors:Array = [0xFFFFFF, 0xCCCCCC, 0x000000];
    var alphas:Array = [1, 0, 1];
    var ratios:Array = [0, 128, 255];
    var filter:GradientBevelFilter = new GradientBevelFilter(5, 225, colors, alphas, ratios, 5, 5, 5, 2, "inner", false);

    art.filters = new Array(filter);
    return art;
}

colors (GradientBevelFilter.colors property)

Example

See also