Pacote | flash.filters |
Classe | public final class GlowFilter |
Herança | GlowFilter BitmapFilter Object |
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9 |
distance
e angle
do filtro de sombra definida como 0. É possível aplicar o filtro a qualquer objeto de exibição (isto é, objetos herdados da classe DisplayObject), como os objetos MovieClip, SimpleButton, TextField e Video, como também aos objetos BitmapData.
O uso dos filtros depende do objeto ao qual você vai aplicar o filtro:
- Para aplicar os filtros aos objetos de exibição, use a propriedade
filters
(herdada de DisplayObject). Definir a propriedadefilters
de um objeto não modifica o objeto e você pode remover o filtro limpando a propriedadefilters
. - Para aplicar os filtros aos objetos BitmapData, use o método
BitmapData.applyFilter()
. A ação de chamar oapplyFilter()
em um objeto BitmapData usa o objeto BitmapData de origem e o objeto do filtro e cria uma imagem filtrada como resultado.
Se você aplicar um filtro a um objeto de exibição, a propriedade cacheAsBitmap
do objeto de exibição é definida como true
. Se você limpar todos os filtros, o valor original de cacheAsBitmap
é restaurado.
Esse filtro suporta dimensionamento do Palco. Entretanto, ele não suporta dimensionamento geral, rotação e inclinação. Se o próprio objeto for dimensionado (se scaleX
e scaleY
forem definidas para um valor diferente de 1,0), o filtro não será dimensionado. Ele será dimensionado somente quando o usuário aumentar o zoom no Palco.
Um filtro não é aplicado caso a imagem resultante exceda as dimensões máximas. No AIR 1.5 e no Flash Player 10, o máximo é de 8,191 pixels de largura ou de altura, e o número total de pixels não pode exceder 16,777,215 pixels. (Dessa forma, caso uma imagem tenha 8,191 pixels de largura, ela só pode ter 2.048 pixels de altura.) No Flash Player 9 e anteriores e no AIR 1.1 e anteriores, a limitação é de 2.880 pixels de altura e de 2.880 pixels de largura. Por exemplo, se você aumentar o zoom em um clipe de filme grande com um filtro aplicado, o filtro será desativado se a imagem resultante exceder as dimensões máximas.
Elementos da API relacionados
flash.display.DisplayObject.filters
flash.display.DisplayObject.cacheAsBitmap
flash.display.DisplayObject.scaleX
flash.display.DisplayObject.scaleY
flash.filters.DropShadowFilter.distance
flash.filters.DropShadowFilter.angle
Propriedade | Definido por | ||
---|---|---|---|
alpha : Number
Valor de transparência alfa da cor. | GlowFilter | ||
blurX : Number
Intensidade de desfoque horizontal. | GlowFilter | ||
blurY : Number
Intensidade do desfoque vertical. | GlowFilter | ||
color : uint
Cor do brilho. | 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
Especifica se o brilho é um brilho interno. | GlowFilter | ||
knockout : Boolean
Especifica se o objeto tem um efeito de tachado. | GlowFilter | ||
quality : int
Número de vezes para aplicar o filtro. | GlowFilter | ||
strength : Number
Intensidade da impressão ou dispersão. | GlowFilter |
Método | Definido por | ||
---|---|---|---|
GlowFilter(color:uint = 0xFF0000, alpha:Number = 1.0, blurX:Number = 6.0, blurY:Number = 6.0, strength:Number = 2, quality:int = 1, inner:Boolean = false, knockout:Boolean = false)
Inicializa uma nova ocorrência GlowFilter com os parâmetros especificados. | GlowFilter | ||
[substituir]
Retorna uma cópia deste objeto de filtro. | GlowFilter | ||
Indica se um objeto tem uma propriedade especificada definida. | Object | ||
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro. | Object | ||
Indica se a propriedade especificada existe e é enumerável. | Object | ||
Define a disponibilidade de uma propriedade dinâmica para operações de repetição. | Object | ||
Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade. | Object | ||
Retorna a representação de string do objeto especificado. | Object | ||
Retorna o valor primitivo do objeto especificado. | Object |
alpha | propriedade |
alpha:Number
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9 |
Valor de transparência alfa da cor. Os valores válidos são 0 a 1. Por exemplo, ,25 define um valor de transparência de 25%. O valor padrão é 1.
Implementação
public function get alpha():Number
public function set alpha(value:Number):void
blurX | propriedade |
blurX:Number
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9 |
Intensidade de desfoque horizontal. Os valores válidos são 0 a 255 (ponto flutuante). O valor padrão é 6. Os valores que são uma potência de 2 (como 2, 4, 8, 16 e 32) são otimizados para renderizar mais rapidamente do que outros valores.
Implementação
public function get blurX():Number
public function set blurX(value:Number):void
blurY | propriedade |
blurY:Number
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9 |
Intensidade do desfoque vertical. Os valores válidos são 0 a 255 (ponto flutuante). O valor padrão é 6. Os valores que são uma potência de 2 (como 2, 4, 8, 16 e 32) são otimizados para renderizar mais rapidamente do que outros valores.
Implementação
public function get blurY():Number
public function set blurY(value:Number):void
color | propriedade |
inner | propriedade |
inner:Boolean
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9 |
Especifica se o brilho é um brilho interno. O valor true
indica um brilho interno. O padrão é false
, um brilho externo (um brilho em volta das bordas externas do objeto).
Implementação
public function get inner():Boolean
public function set inner(value:Boolean):void
knockout | propriedade |
knockout:Boolean
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9 |
Especifica se o objeto tem um efeito de tachado. Um valor true
torna o preenchimento do objeto transparente e revela a cor do plano de fundo do documento. O valor padrão é false
(sem efeito de tachado).
Implementação
public function get knockout():Boolean
public function set knockout(value:Boolean):void
quality | propriedade |
quality:int
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9 |
Número de vezes para aplicar o filtro. O valor padrão é BitmapFilterQuality.LOW
, que é equivalente a aplicar o filtro uma vez. O valor BitmapFilterQuality.MEDIUM
aplica o filtro duas vezes; o valor BitmapFilterQuality.HIGH
aplica três vezes. Os filtros com valores menores são renderizados mais rapidamente.
Para a maioria dos aplicativos, um valor de quality
baixo, médio ou alto é suficiente. Embora você possa usar valores numéricos adicionais até 15 para obter efeitos diferentes, os valores maiores são renderizados mais lentamente. Em vez de aumentar o valor de quality
, você pode normalmente obter um efeito similar, com uma renderização mais rápida, simplesmente aumentando os valores das propriedades blurX
e blurY
.
Implementação
public function get quality():int
public function set quality(value:int):void
Elementos da API relacionados
strength | propriedade |
strength:Number
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9 |
Intensidade da impressão ou dispersão. Quanto maior o valor, mais cores são impressas e mais forte será o contraste entre o brilho e o plano de fundo. Os valores válidos são 0 a 255. O padrão é 2.
Implementação
public function get strength():Number
public function set strength(value:Number):void
GlowFilter | () | Construtor |
public function GlowFilter(color:uint = 0xFF0000, alpha:Number = 1.0, blurX:Number = 6.0, blurY:Number = 6.0, strength:Number = 2, quality:int = 1, inner:Boolean = false, knockout:Boolean = false)
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9 |
Inicializa uma nova ocorrência GlowFilter com os parâmetros especificados.
Parâmetroscolor:uint (default = 0xFF0000 ) — A cor do brilho, no formato hexadecimal 0xRRGGBB. O valor padrão é 0xFF0000.
| |
alpha:Number (default = 1.0 ) — Valor de transparência alfa da cor. Os valores válidos são 0 a 1. Por exemplo, ,25 define um valor de transparência de 25%.
| |
blurX:Number (default = 6.0 ) — Intensidade de desfoque horizontal. Os valores válidos são 0 a 255 (ponto flutuante). Os valores que são uma potência de 2 (como 2, 4, 8, 16 e 32) são otimizados para renderizar mais rapidamente do que outros valores.
| |
blurY:Number (default = 6.0 ) — Intensidade do desfoque vertical. Os valores válidos são 0 a 255 (ponto flutuante). Os valores que são uma potência de 2 (como 2, 4, 8, 16 e 32) são otimizados para renderizar mais rapidamente do que outros valores.
| |
strength:Number (default = 2 ) — Intensidade da impressão ou dispersão. Quanto maior o valor, mais cores são impressas e mais forte será o contraste entre o brilho e o plano de fundo. Os valores válidos são 0 a 255.
| |
quality:int (default = 1 ) — Número de vezes para aplicar o filtro. Use as constantes BitmapFilterQuality:
Para obter mais informações, consulte a descrição da propriedade | |
inner:Boolean (default = false ) — Especifica se o brilho é um brilho interno. O valor true especifica um brilho interno. O valor false especifica um brilho externo (um brilho em volta das bordas externas do objeto).
| |
knockout:Boolean (default = false ) — Especifica se o objeto tem um efeito de tachado. O valor true torna o preenchimento do objeto transparente e revela a cor do plano de fundo do documento.
|
Elementos da API relacionados
clone | () | método |
override public function clone():BitmapFilter
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9 |
Retorna uma cópia deste objeto de filtro.
RetornaBitmapFilter — Uma nova ocorrência GlowFilter com todas as propriedades da ocorrência GlowFilter original.
|
- Importe as classes necessárias.
- Declare três propriedades usadas no método
draw
, que usa o método da classe Graphics acessado por meio da propriedadegraphics
do Sprite para desenhar um quadrado laranja. - Crie a função de construtor, que fazem o seguinte:
- Chama a função
draw
para criar um retângulo. - Cria um objeto BitmapFilter
glowFilter
e atribui a ele os valores retornados pela funçãogetBitmapFilter()
. - Atribui a matriz de valores do objeto
glowFilter
à propriedadefilters
do objeto de exibição raiz. Neste caso, todos os objetos de exibição filhos do objeto de exibição raiz herdam as propriedades do filtro de brilho. Assim, o retângulo criado na funçãodraw()
exibe as propriedades de filtro de brilho.
- Chama a função
package { import flash.display.Sprite; import flash.events.Event; import flash.events.MouseEvent; import flash.filters.BitmapFilter; import flash.filters.BitmapFilterQuality; import flash.filters.GlowFilter; public class GlowFilterExample extends Sprite { private var bgColor:uint = 0xFFCC00; private var size:uint = 80; private var offset:uint = 50; public function GlowFilterExample() { //draw the rectangle using the draw() function below draw(); //assign the values from getBitmapFilter function below //to a BitmapFilter object "glowFilter" var glowFilter:BitmapFilter = getBitmapFilter(); //populate the filters property of the root display object with the array of values //from the glowFilter object. filters = [ glowFilter ]; } private function getBitmapFilter():BitmapFilter { var color:Number = 0x33CCFF; var alpha:Number = 0.8; var blurX:Number = 35; var blurY:Number = 35; var strength:Number = 2; var inner:Boolean = false; var knockout:Boolean = false; var quality:Number = BitmapFilterQuality.HIGH; return new GlowFilter(color, alpha, blurX, blurY, strength, quality, inner, knockout); } private function draw():void { graphics.beginFill(bgColor); graphics.drawRect(offset, offset, size, size); graphics.endFill(); } } }
Wed Jun 13 2018, 11:10 AM Z