GlowFilter

Pacote	spark.filters
Classe	public class GlowFilter
Herança	GlowFilter BaseDimensionFilter BaseFilter EventDispatcher Object
Implementações	IBitmapFilter

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flex 4

Versões de runtime:

Flash Player 10, AIR 1.5

The GlowFilter class lets you apply a glow effect to display objects. You have several options for the style of the glow, including inner or outer glow and knockout mode. The glow filter is similar to the drop shadow filter with the distance and angle properties of the drop shadow filter set to 0. You can apply the filter to any display object (that is, 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 (inherited from DisplayObject). 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 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.

Sintaxe MXML expanded

Ocultar sintaxe MXML

The <s:GlowFilter> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <s:GlowFilter
    Properties
    alpha="1"
    color="0xFF0000"
    inner="false"
  />

Veja os exemplos

Mais exemplos

Filters

Elementos da API relacionados

flash.filters.GlowFilter
flash.display.BitmapData.applyFilter()
flash.display.DisplayObject.filters
flash.display.DisplayObject.cacheAsBitmap
flash.display.DisplayObject.scaleX
flash.display.DisplayObject.scaleY
flash.filters.DropShadowFilter.distance
flash.filters.DropShadowFilter.angle

Propriedades públicas

Ocultar propriedades públicas herdadas

Mostrar propriedades públicas herdadas

	Propriedade		Definido por
		alpha : Number The alpha transparency value for the color.	GlowFilter
		blurX : Number The amount of horizontal blur.	BaseDimensionFilter
		blurY : Number The amount of vertical blur.	BaseDimensionFilter
		color : uint The color of the glow.	GlowFilter
		constructor : Object Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto.	Object
		inner : Boolean Specifies whether the glow is an inner glow.	GlowFilter
		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

Métodos públicos

Ocultar métodos públicos herdados

Mostrar métodos públicos herdados

	Método		Definido por
		GlowFilter(color:uint = 0xFF0000, alpha:Number = 1.0, blurX:Number = 4.0, blurY:Number = 4.0, strength:Number = 1, quality:int = 1, inner:Boolean = false, knockout:Boolean = false) Constructor.	GlowFilter
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registra um objeto de ouvinte de evento em um objeto EventDispatcher, de forma que o ouvinte receba a notificação de um evento.	EventDispatcher
		clone():BitmapFilter Returns a copy of this filter object.	GlowFilter
		dispatchEvent(event:Event):Boolean Envia um evento para o fluxo de eventos.	EventDispatcher
		hasEventListener(type:String):Boolean Verifica se o objeto EventDispatcher tem ouvintes registrados para um tipo específico de evento.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indica se um objeto tem uma propriedade especificada definida.	Object
		isPrototypeOf(theClass:Object):Boolean Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro.	Object
		notifyFilterChanged():void Propagates a change event when the filter has changed.	BaseFilter
		propertyIsEnumerable(name:String):Boolean Indica se a propriedade especificada existe e é enumerável.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Remove um ouvinte do objeto EventDispatcher.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Define a disponibilidade de uma propriedade dinâmica para operações de repetição.	Object
		toLocaleString():String Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade.	Object
		toString():String Retorna a representação de string do objeto especificado.	Object
		valueOf():Object Retorna o valor primitivo do objeto especificado.	Object
		willTrigger(type:String):Boolean Verifica se um ouvinte de evento está registrado nesse objeto EventDispatcher ou em qualquer um de seus ancestrais para o tipo de evento especificado.	EventDispatcher

Eventos

Clique para obter mais informações sobre eventos

Ocultar eventos herdados

Mostrar eventos herdados

	Evento		Resumo	Definido por
		activate	[transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR ganha o foco do sistema operacional e está se tornando inativo.	EventDispatcher
		deactivate	[transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR perde o foco do sistema operacional e está se tornando inativo.	EventDispatcher

Constantes públicas

Ocultar constantes públicas herdadas

Mostrar constantes públicas herdadas

	Constante		Definido por

Detalhes da propriedade

alpha

propriedade

alpha:Number

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flex 4

Versões de runtime:

Flash Player 10, AIR 1.5

The alpha transparency value for the color. Valid values are 0 to 1. For example, .25 sets a transparency value of 25%.

O valor padrão é 1.

Implementação
public function get alpha():Number
public function set alpha(value:Number):void

color

propriedade

color:uint

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flex 4

Versões de runtime:

Flash Player 10, AIR 1.5

The color of the glow. Valid values are in the hexadecimal format 0xRRGGBB.

O valor padrão é 0xFF0000.

Implementação
public function get color():uint
public function set color(value:uint):void

inner

propriedade

inner:Boolean

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flex 4

Versões de runtime:

Flash Player 10, AIR 1.5

Specifies whether the glow is an inner glow. The value true indicates an inner glow. The default is false, meaning an outer glow (a glow around the outer edges of the object).

O valor padrão é false.

Implementação
public function get inner():Boolean
public function set inner(value:Boolean):void

Detalhes do construtor

()

Construtor

public function GlowFilter(color:uint = 0xFF0000, alpha:Number = 1.0, blurX:Number = 4.0, blurY:Number = 4.0, strength:Number = 1, quality:int = 1, inner:Boolean = false, knockout:Boolean = false)

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flex 4

Versões de runtime:

Flash Player 10, AIR 1.5

Constructor.

Parâmetros

	`color:uint` (default = `0xFF0000`) — The color of the glow, in the hexadecimal format 0xRRGGBB. The default value is 0xFF0000.

	`alpha:Number` (default = `1.0`) — The alpha transparency value for the color. Valid values are 0 to 1. For example, .25 sets a transparency value of 25%.

	`blurX:Number` (default = `4.0`) — The amount of horizontal blur. Valid values are 0 to 255 (floating point). 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 (floating point). 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.

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

	`inner:Boolean` (default = `false`) — Specifies whether the glow is an inner glow. The value `true` specifies an inner glow. The value `false` specifies an outer glow (a glow around the outer edges of the object).

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

Elementos da API relacionados

BitmapFilterQuality

Detalhes do método

clone

()

método

public function clone():BitmapFilter

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flex 4

Versões de runtime:

Flash Player 10, AIR 1.5

Returns a copy of this filter object.

Retorna

BitmapFilter — A new GlowFilter instance with all the properties of the original GlowFilter instance.

Exemplos Como usar este exemplo

GlowFilterExample.mxml

<?xml version="1.0"?>
<!-- filters/examples/GlowFilterExample .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 myGlowFilter:GlowFilter;  
     private var color:Number = 0xFF33FF;
  
     public function createFilters():void {        
        myGlowFilter = new GlowFilter(color, .8, 6, 6, .65, BitmapFilterQuality.MEDIUM, 
            false, false);
        b1.filters = [myGlowFilter];
     }
  
  ]]></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:GlowFilter 
                    color="0xFF33FF" 
                    alpha=".8" 
                    blurX="6" 
                    blurY="6" 
                    strength=".65" 
                    quality="{BitmapFilterQuality.MEDIUM}"
                    inner="false" 
                    knockout="false"/>
            </s:filters>
        </s:Button>
        
    </s:VGroup>        
</s:Application>

Aspectos jurídicos | Política de privacidade on-line

GlowFilter - AS3 Flex

Classes x

alpha

color

inner

GlowFilter

clone