GradientGlowFilter

Pakket	spark.filters
Klasse	public class GradientGlowFilter
Overerving	GradientGlowFilter GradientFilter BaseDimensionFilter BaseFilter EventDispatcher Object
Implementatie	IBitmapFilter

Taalversie:

ActionScript 3.0

Productversie:

Flex 4

Runtimeversies:

Flash Player 10, AIR 1.5

The GradientGlowFilter class lets you apply a gradient glow effect to display objects. A gradient glow is a realistic-looking glow with a color gradient that you can control. You can apply a gradient glow around the inner or outer edge of an object or on top of an object. You can apply the filter to any display object (objects that inherit from the DisplayObject class), such as MovieClip, SimpleButton, TextField, and Video objects, as well as to BitmapData objects.

The use of filters depends on the object to which you apply the filter:

To apply filters to display objects, use the filters property. Setting the filters property of an object does not modify the object, and you can remove the filter by clearing the filters property.
To apply filters to BitmapData objects, use the BitmapData.applyFilter() method. Calling applyFilter() on a BitmapData object takes the source BitmapData object and the filter object and generates a filtered image as a result.

If you apply a filter to a display object, the cacheAsBitmap property of the display object is set to true. If you clear all filters, the original value of cacheAsBitmap is restored.

This filter supports Stage scaling. However, it does not support general scaling, rotation, and skewing; if the object itself is scaled (if scaleX and scaleY are set to a value other than 1.0), the filter effect is not scaled. It is scaled only when the user zooms in on the Stage.

A filter is not applied if the resulting image exceeds the maximum dimensions. In AIR 1.5 and Flash Player 10, the maximum is 8,191 pixels in width or height, and the total number of pixels cannot exceed 16,777,215 pixels. (So, if an image is 8,191 pixels wide, it can only be 2,048 pixels high.) For example, if you zoom in on a large movie clip with a filter applied, the filter is turned off if the resulting image exceeds the maximum dimensions.

MXML-syntaxis expanded

MXML-syntaxis verbergen

The <s:GradientGlowFilter> tag inherits all of the tag attributes of its superclass and adds no tag attributes:

  <s:GradientGlowFilter/>

Standaard-MXML-eigenschapentries

Bekijk de voorbeelden

Meer voorbeelden

Filters

Verwante API-elementen

spark.filters.GlowFilter
flash.filters.GradientGlowFilter
flash.display.BitmapData.applyFilter()
flash.display.DisplayObject.cacheAsBitmap
flash.display.DisplayObject.filters

Openbare eigenschappen

Overerfde openbare eigenschappen verbergen

Overerfde openbare eigenschappen weergeven

	Eigenschap		Gedefinieerd door
		angle : Number The angle, in degrees.	GradientFilter
		blurX : Number The amount of horizontal blur.	BaseDimensionFilter
		blurY : Number The amount of vertical blur.	BaseDimensionFilter
		constructor : Object Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie.	Object
		distance : Number The offset distance of the glow.	GradientFilter
		entries : Array An Array of GradientEntry objects defining the fill patterns for the gradient fill.	GradientFilter
		knockout : Boolean Specifies whether the object has a knockout effect.	BaseDimensionFilter
		quality : int The number of times to apply the filter.	BaseDimensionFilter
		strength : Number The strength of the imprint or spread.	BaseDimensionFilter
		type : String The placement of the filter effect.	GradientFilter

Openbare methoden

Overerfde openbare methoden verbergen

Overerfde openbare methoden weergeven

	Methode		Gedefinieerd door
		GradientGlowFilter(distance:Number = 4.0, angle:Number = 45, colors:Array = null, alphas:Array = null, ratios:Array = null, blurX:Number = 4.0, blurY:Number = 4.0, strength:Number = 1, quality:int = 1, type:String = "outer", knockout:Boolean = false) Constructor.	GradientGlowFilter
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registreert een gebeurtenislistenerobject bij een object EventDispatcher, zodat de listener een melding van een gebeurtenis ontvangt.	EventDispatcher
		clone():BitmapFilter Returns a copy of this filter object.	GradientGlowFilter
		dispatchEvent(event:Event):Boolean Verzendt een gebeurtenis naar de gebeurtenisstroom.	EventDispatcher
		hasEventListener(type:String):Boolean Controleert of het object EventDispatcher listeners heeft geregistreerd voor een specifiek type gebeurtenis.	EventDispatcher
		hasOwnProperty(name:String):Boolean Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd.	Object
		isPrototypeOf(theClass:Object):Boolean Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven.	Object
		notifyFilterChanged():void Propagates a change event when the filter has changed.	BaseFilter
		propertyIsEnumerable(name:String):Boolean Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Verwijdert een listener uit het object EventDispatcher.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in.	Object
		toLocaleString():String Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies.	Object
		toString():String Retourneert een tekenreeksrepresentatie van het opgegeven object.	Object
		valueOf():Object Retourneert de primitieve waarde van het opgegeven object.	Object
		willTrigger(type:String):Boolean Controleert of een gebeurtenislistener is geregistreerd bij dit object EventDispatcher of een van de voorouders voor het opgegeven type gebeurtenis.	EventDispatcher

Gebeurtenissen

Klik voor meer informatie over gebeurtenissen.

Overerfde gebeurtenissen verbergen

Overerfde gebeurtenissen weergeven

	Gebeurtenis		Overzicht	Gedefinieerd door
		activate	[uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de besturingssysteemfocus krijgt en actief wordt.	EventDispatcher
		deactivate	[uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de systeemfocus verliest en inactief wordt.	EventDispatcher

Openbare constanten

Overerfde openbare constanten verbergen

Overerfde openbare constanten weergeven

	Constante		Gedefinieerd door

Constructordetails

()

Constructor

public function GradientGlowFilter(distance:Number = 4.0, angle:Number = 45, colors:Array = null, alphas:Array = null, ratios:Array = null, blurX:Number = 4.0, blurY:Number = 4.0, strength:Number = 1, quality:int = 1, type:String = "outer", knockout:Boolean = false)

Taalversie:

ActionScript 3.0

Productversie:

Flex 4

Runtimeversies:

Flash Player 10, AIR 1.5

Constructor.

Parameters

	`distance:Number` (default = `4.0`) — The offset distance of the glow.

	`angle:Number` (default = `45`) — The angle, in degrees. Valid values are 0 to 360.

	`colors:Array` (default = `null`) — An array of colors that defines a gradient. For example, red is 0xFF0000, blue is 0x0000FF, and so on.

	`alphas:Array` (default = `null`) — An array of alpha transparency values for the corresponding colors in the `colors` array. Valid values for each element in the array are 0 to 1. For example, a value of .25 sets the alpha transparency value to 25%.

	`ratios:Array` (default = `null`) — An array of color distribution ratios. Valid values are 0 to 255. This value defines the percentage of the width where the color is sampled at 100 percent.

	`blurX:Number` (default = `4.0`) — The amount of horizontal blur. Valid values are 0 to 255. A blur of 1 or less means that the original image is copied as is. Values that are a power of 2 (such as 2, 4, 8, 16 and 32) are optimized to render more quickly than other values.

	`blurY:Number` (default = `4.0`) — The amount of vertical blur. Valid values are 0 to 255. A blur of 1 or less means that the original image is copied as is. Values that are a power of 2 (such as 2, 4, 8, 16 and 32) are optimized to render more quickly than other values.

	`strength:Number` (default = `1`) — The strength of the imprint or spread. The higher the value, the more color is imprinted and the stronger the contrast between the glow and the background. Valid values are 0 to 255. The larger the value, the stronger the imprint. A value of 0 means the filter is not applied.

	`quality:int` (default = `1`) — The number of times to apply the filter. Use the flash.filters.BitmapFilterQuality constants: `BitmapFilterQuality.LOW` `BitmapFilterQuality.MEDIUM` `BitmapFilterQuality.HIGH` For more information, see the description of the `quality` property.

	`type:String` (default = "`outer`") — The placement of the filter effect. Possible values are the flash.filters.BitmapFilterType constants: `BitmapFilterType.OUTER` — Glow on the outer edge of the object; the default. `BitmapFilterType.INNER` — Glow on the inner edge of the object `BitmapFilterType.FULL` — Glow on top of the object

	`knockout:Boolean` (default = `false`) — Specifies whether the object has a knockout effect. A knockout effect makes the object's fill transparent and reveals the background color of the document. The value `true` specifies a knockout effect; the default is `false` (no knockout effect).

Methodedetails

clone

()

methode

public function clone():BitmapFilter

Taalversie:

ActionScript 3.0

Productversie:

Flex 4

Runtimeversies:

Flash Player 10, AIR 1.5

Returns a copy of this filter object.

Geretourneerde waarde

BitmapFilter — A new GradientGlowFilter instance with all the same properties as the original GradientGlowFilter instance.

Voorbeelden Hoe dit voorbeeld te gebruiken

GradientGlowFilterExample.mxml

<?xml version="1.0"?>
<!-- filters/examples/GradientGlowFilterExample .mxml -->
<s:Application 
    xmlns:fx="http://ns.adobe.com/mxml/2009" 
    xmlns:mx="library://ns.adobe.com/flex/mx" 
    xmlns:s="library://ns.adobe.com/flex/spark" 
    creationComplete="createFilters()">
    
  <fx:Script><![CDATA[ 
     import spark.filters.*;
     import flash.filters.BitmapFilterQuality;
     import flash.filters.BitmapFilterType;
  
     private var myGradientGlowFilter:GradientGlowFilter;  
     private var colors:Array = [0xFFFFFF, 0xFF0000, 0xFFFF00, 0x00CCFF];
     private var alphas:Array = [0, 1, 1, 1];  
     private var ratios:Array = [0, 63, 126, 255];
             
     public function createFilters():void {        
        myGradientGlowFilter = new GradientGlowFilter(0, 45, colors, alphas,
            ratios, 50, 50, 2.5, BitmapFilterQuality.HIGH, BitmapFilterType.OUTER, false);
        b1.filters = [myGradientGlowFilter];
     }
  
  ]]></fx:Script>

    <s:VGroup>
        <!-- This button has a filter applied in ActionScript. -->
        <s:Button id="b1" label="Click me"/>

        <!-- This button has a filter applied in MXML. -->
        <s:Button id="b2" label="Click me">
            <s:filters>
                <s:GradientGlowFilter 
                    distance="10"
                    angle="45"
                    blurX="50" 
                    blurY="50" 
                    strength="2.5" 
                    quality="{BitmapFilterQuality.HIGH}"
                    type="{BitmapFilterType.OUTER}" 
                    knockout="false">
                        <s:entries>
                            <s:GradientEntry alpha="0" color="0xFFFFFF" ratio="0"/>
                            <s:GradientEntry alpha="1" color="0xFF0000" ratio="63"/>
                            <s:GradientEntry alpha="1" color="0xFFFF00" ratio="126"/>
                            <s:GradientEntry alpha="1" color="0x00CCFF" ratio="255"/>
                        </s:entries>
                 </s:GradientGlowFilter>
            </s:filters>
        </s:Button>
    </s:VGroup>        
</s:Application>

Juridische kennisgeving | Online privacybeleid

GradientGlowFilter - AS3 Flex

Klassen x

GradientGlowFilter

clone