Pacote | flash.filters |
Classe | public final class DropShadowFilter |
Herança | DropShadowFilter BitmapFilter Object |
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9 |
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, o valor da propriedade cacheAsBitmap
do objeto de exibição é definido 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
Propriedade | Definido por | ||
---|---|---|---|
alpha : Number
Valor de transparência alfa da cor de sombra. | DropShadowFilter | ||
angle : Number
Ângulo da sombra. | DropShadowFilter | ||
blurX : Number
Intensidade de desfoque horizontal. | DropShadowFilter | ||
blurY : Number
Intensidade do desfoque vertical. | DropShadowFilter | ||
color : uint
Cor da sombra. | DropShadowFilter | ||
constructor : Object
Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto. | Object | ||
distance : Number
Distância de deslocamento da sombra, em pixels. | DropShadowFilter | ||
hideObject : Boolean
Indica se o objeto está ou não oculto. | DropShadowFilter | ||
inner : Boolean
Indica se a sombra é ou não uma sombra interna. | DropShadowFilter | ||
knockout : Boolean
Aplica um efeito um tachado (true), que torna efetivamente transparente o preenchimento do objeto e revela a cor de plano de fundo do documento. | DropShadowFilter | ||
quality : int
Número de vezes para aplicar o filtro. | DropShadowFilter | ||
strength : Number
Intensidade da impressão ou dispersão. | DropShadowFilter |
Método | Definido por | ||
---|---|---|---|
DropShadowFilter(distance:Number = 4.0, angle:Number = 45, color:uint = 0, alpha:Number = 1.0, blurX:Number = 4.0, blurY:Number = 4.0, strength:Number = 1.0, quality:int = 1, inner:Boolean = false, knockout:Boolean = false, hideObject:Boolean = false)
Cria uma nova ocorrência DropShadowFilter com os parâmetros especificados. | DropShadowFilter | ||
[substituir]
Retorna uma cópia deste objeto de filtro. | DropShadowFilter | ||
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 de sombra. Os valores válidos são 0,0 a 1,0. Por exemplo, ,25 define um valor de transparência de 25%. O valor padrão é 1,0.
Implementação
public function get alpha():Number
public function set alpha(value:Number):void
angle | propriedade |
blurX | propriedade |
blurY | propriedade |
color | propriedade |
distance | propriedade |
hideObject | propriedade |
hideObject:Boolean
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9 |
Indica se o objeto está ou não oculto. O valor true
indica que o próprio objeto não está desenhado; somente a sombra é visível. O padrão é false
(o objeto é mostrado).
Implementação
public function get hideObject():Boolean
public function set hideObject(value:Boolean):void
inner | propriedade |
inner:Boolean
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9 |
Indica se a sombra é ou não uma sombra interna. O valor true
indica uma sombra interna. O padrão é false
, uma sombra externa (uma sombra 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 |
Aplica um efeito de tachado (true
), que torna efetivamente transparente o preenchimento do objeto e revela a cor de plano de fundo do documento. O padrão é false
(sem 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 qualidade 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 a sombra e o plano de fundo. Os valores válidos são 0 a 255,0. O padrão é 1,0.
Implementação
public function get strength():Number
public function set strength(value:Number):void
DropShadowFilter | () | Construtor |
public function DropShadowFilter(distance:Number = 4.0, angle:Number = 45, color:uint = 0, alpha:Number = 1.0, blurX:Number = 4.0, blurY:Number = 4.0, strength:Number = 1.0, quality:int = 1, inner:Boolean = false, knockout:Boolean = false, hideObject:Boolean = false)
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9 |
Cria uma nova ocorrência DropShadowFilter com os parâmetros especificados.
Parâmetrosdistance:Number (default = 4.0 ) — Distância de deslocamento da sombra, em pixels.
| |
angle:Number (default = 45 ) — Ângulo da sombra, 0 a 360 graus (ponto flutuante).
| |
color:uint (default = 0 ) — Cor da sombra, no formato hexadecimal 0xRRGGBB. O valor padrão é 0x000000.
| |
alpha:Number (default = 1.0 ) — Valor de transparência alfa da cor de sombra. Os valores válidos são 0,0 a 1,0. Por exemplo, ,25 define um valor de transparência de 25%.
| |
blurX:Number (default = 4.0 ) — Intensidade de desfoque horizontal. Os valores válidos são 0 a 255,0 (ponto flutuante).
| |
blurY:Number (default = 4.0 ) — Intensidade de desfoque vertical. Os valores válidos são 0 a 255,0 (ponto flutuante).
| |
strength:Number (default = 1.0 ) — Intensidade da impressão ou dispersão. Quanto maior o valor, mais cores são impressas e mais forte será o contraste entre a sombra e o plano de fundo. Os valores válidos são 0 a 255,0.
| |
quality:int (default = 1 ) — Número de vezes para aplicar o filtro. Use as constantes BitmapFilterQuality:
Para obter mais informações sobre esses valores, consulte a descrição da propriedade | |
inner:Boolean (default = false ) — Indica se a sombra é ou não uma sombra interna. Um valor true especifica uma sombra interna. Um valor de false especifica uma sombra externa (uma sombra em volta das bordas externas do objeto).
| |
knockout:Boolean (default = false ) — Aplica um efeito de tachado (true ), que torna efetivamente transparente o preenchimento do objeto e revela a cor de plano de fundo do documento.
| |
hideObject:Boolean (default = false ) — Indica se o objeto está ou não oculto. Um valor true indica que o próprio objeto não está desenhado; somente a sombra é visível.
|
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 DropShadowFilter com todas as propriedades da ocorrência DropShadowFilter original.
|
- Declare três propriedades que são usadas para desenhar o quadrado no qual o filtro é aplicado.
- Crie a função de construtor. O construtor chama o método
draw()
, que usa os métodos da classe Graphics acessado por meio da propriedadegraphics
do Sprite para desenhar um quadrado laranja. - No construtor, declare uma variável
filter
como um objeto BitmapFilter e atribua-a ao valor de retorno de uma chamada paragetBitmapFilter()
. O métodogetBitmapFilter()
define o filtro de sombra usado. - Crie um novo objeto Array
myFilters
e adicionefilter
à matriz. Atribua a matrizmyFilters
à propriedadefilters
do objeto DropShadowFilterExample. Isso aplica todos os filtros encontrados emmyFilters
, o que, nesse caso, é somentefilter
.
package { import flash.display.Sprite; import flash.events.Event; import flash.events.MouseEvent; import flash.filters.BitmapFilter; import flash.filters.BitmapFilterQuality; import flash.filters.DropShadowFilter; public class DropShadowFilterExample extends Sprite { private var bgColor:uint = 0xFFCC00; private var size:uint = 80; private var offset:uint = 50; public function DropShadowFilterExample() { draw(); var filter:BitmapFilter = getBitmapFilter(); var myFilters:Array = new Array(); myFilters.push(filter); filters = myFilters; } private function getBitmapFilter():BitmapFilter { var color:Number = 0x000000; var angle:Number = 45; var alpha:Number = 0.8; var blurX:Number = 8; var blurY:Number = 8; var distance:Number = 15; var strength:Number = 0.65; var inner:Boolean = false; var knockout:Boolean = false; var quality:Number = BitmapFilterQuality.HIGH; return new DropShadowFilter(distance, angle, 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