GradientGlowFilter

Paket	spark.filters
Sınıf	public class GradientGlowFilter
Miras Alma	GradientGlowFilter GradientFilter BaseDimensionFilter BaseFilter EventDispatcher Object
Uygular	IBitmapFilter

Dil Sürümü:

ActionScript 3.0

Ürün Sürümü:

Flex 4

Çalışma Zamanı Sürümleri:

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 Sözdizimi expanded

MXML Sözdizimini Gizle

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

  <s:GradientGlowFilter/>

Varsayılan MXML Özelliğientries

Örnekleri görüntüle

İlgili API Öğeleri

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

Genel Özellikler

Miras Alınan Genel Özellikleri Gizle

Miras Alınan Genel Özellikleri Göster

	Özellik		Tanımlayan:
		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 Belirli bir nesne örneği için sınıf nesnesine veya yapıcı işlevine bir başvuru.	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

Genel Yöntemler

Miras Alınan Genel Yöntemleri Gizle

Miras Alınan Genel Yöntemleri Göster

	Yöntem		Tanımlayan:
		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 EventDispatcher nesnesi olan bir olay dinleyici nesnesini, dinleyicinin bir olayın bildirimini alması için kaydeder.	EventDispatcher
		clone():BitmapFilter Returns a copy of this filter object.	GradientGlowFilter
		dispatchEvent(event:Event):Boolean Olay akışına bir olay gönderir.	EventDispatcher
		hasEventListener(type:String):Boolean EventDispatcher nesnesinin belirli bir olay türü için kayıtlı dinleyicisi olup olmadığını kontrol eder.	EventDispatcher
		hasOwnProperty(name:String):Boolean Bir nesnenin belirli bir özelliğinin tanımlı olup olmadığını gösterir.	Object
		isPrototypeOf(theClass:Object):Boolean Object sınıfının bir örneğinin parametre olarak belirtilen nesnenin prototip zincirinde olup olmadığını gösterir.	Object
		notifyFilterChanged():void Propagates a change event when the filter has changed.	BaseFilter
		propertyIsEnumerable(name:String):Boolean Belirtilen özelliğin bulunup bulunmadığını ve numaralandırılabilir olup olmadığını gösterir.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void EventDispatcher nesnesinden bir dinleyiciyi kaldırır.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Dinamik bir özelliğin döngü işlemlerinde kullanılabilirliğini ayarlar.	Object
		toLocaleString():String Bu nesnenin, yerel ayara özel kurallara göre biçimlendirilmiş dize temsilini döndürür.	Object
		toString():String Belirtilen nesnenin dize olarak temsil edilen halini döndürür.	Object
		valueOf():Object Belirtilen nesnenin temel değerini döndürür.	Object
		willTrigger(type:String):Boolean Bir olay dinleyicisinin bu EventDispatcher nesnesiyle mi, yoksa onun belirtilen olay türüne yönelik üst öğelerinden biriyle mi kayıtlı olduğunu kontrol eder.	EventDispatcher

Olaylar

Olaylarla ilgili daha fazla bilgi için tıklatın

Miras Alınan Olayları Gizle

Miras Alınan Olayları Göster

	Olay		Özet	Tanımlayan:
		activate	[broadcast olayı] Flash Player veya AIR uygulaması işletim sistemi odağına gelip etkin olduğunda gönderilir.	EventDispatcher
		deactivate	[broadcast olayı] Çalışan Flash Player veya AIR uygulaması sistem odağını kaybettiğinde ve etkin olmayan duruma geldiğinde gönderilir.	EventDispatcher

Genel Sabitler

Miras Alınan Genel Sabitleri Gizle

Miras Alınan Genel Sabitleri Göster

	Sabit		Tanımlayan:

Yapıcı Ayrıntı

()

Yapıcı

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)

Dil Sürümü:

ActionScript 3.0

Ürün Sürümü:

Flex 4

Çalışma Zamanı Sürümleri:

Flash Player 10, AIR 1.5

Constructor.

Parametreler

	`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).

Yöntem Ayrıntısı

clone

()

yöntem

public function clone():BitmapFilter

Dil Sürümü:

ActionScript 3.0

Ürün Sürümü:

Flex 4

Çalışma Zamanı Sürümleri:

Flash Player 10, AIR 1.5

Returns a copy of this filter object.

Döndürür

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

Örnekler Bu örnek nasıl kullanılır?

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>

Yasal Uyarılar | Çevrimiçi Gizlilik İlkesi

GradientGlowFilter - AS3 Flex

Sınıflar x

GradientGlowFilter

clone