Pacote | flash.filters |
Classe | public final class BevelFilter |
Herança | BevelFilter BitmapFilter Object |
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9 |
Para criar um novo filtro, use o construtor new BevelFilter()
. O uso dos filtros depende do objeto ao qual você vai aplicar o filtro:
- Para aplicar filtros em clipes de filme, campos de texto, botões e vídeo, use a propriedade
filters
(herdada do 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 é definido como true
. Se você remover 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 as propriedades scaleX
e scaleY
forem definidas para 100%), 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.cacheAsBitmap
flash.display.BitmapData.applyFilter()
Propriedade | Definido por | ||
---|---|---|---|
angle : Number
Ângulo do bisel. | BevelFilter | ||
blurX : Number
Intensidade do desfoque horizontal, em pixels. | BevelFilter | ||
blurY : Number
Intensidade do desfoque vertical, em pixels. | BevelFilter | ||
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 do bisel. | BevelFilter | ||
highlightAlpha : Number
Valor de transparência alfa da cor de realce. | BevelFilter | ||
highlightColor : uint
Cor de realce do bisel. | BevelFilter | ||
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. | BevelFilter | ||
quality : int
Número de vezes para aplicar o filtro. | BevelFilter | ||
shadowAlpha : Number
Valor de transparência alfa da cor de sombra. | BevelFilter | ||
shadowColor : uint
Cor de sombra do bisel. | BevelFilter | ||
strength : Number
Intensidade da impressão ou dispersão. | BevelFilter | ||
type : String
Disposição do bisel no objeto. | BevelFilter |
Método | Definido por | ||
---|---|---|---|
BevelFilter(distance:Number = 4.0, angle:Number = 45, highlightColor:uint = 0xFFFFFF, highlightAlpha:Number = 1.0, shadowColor:uint = 0x000000, shadowAlpha:Number = 1.0, blurX:Number = 4.0, blurY:Number = 4.0, strength:Number = 1, quality:int = 1, type:String = "inner", knockout:Boolean = false)
Inicializa uma nova ocorrência BevelFilter com os parâmetros especificados. | BevelFilter | ||
[substituir]
Retorna uma cópia deste objeto de filtro. | BevelFilter | ||
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 |
angle | propriedade |
angle:Number
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9 |
Ângulo do bisel. Os valores válidos são 0 a 360º. O valor padrão é 45°.
O valor do ângulo representa o ângulo da origem da luz teórica que cai sobre o objeto e determina o posicionamento do efeito referente ao objeto. Se a propriedade distance
estiver definida como 0, o efeito não é deslocado a partir do objeto e, portanto, a propriedade angle
não tem efeito.
Implementação
public function get angle():Number
public function set angle(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 do desfoque horizontal, em pixels. Os valores válidos são de 0 a 255 (ponto flutuante). O valor padrão é 4. 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, em pixels. Os valores válidos são de 0 a 255 (ponto flutuante). O valor padrão é 4. 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
distance | propriedade |
highlightAlpha | propriedade |
highlightAlpha: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 realce. O valor é especificado como um valor normalizado de 0 a 1. Por exemplo, ,25 define um valor de transparência de 25%. O valor padrão é 1.
Implementação
public function get highlightAlpha():Number
public function set highlightAlpha(value:Number):void
highlightColor | propriedade |
highlightColor:uint
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9 |
Cor de realce do bisel. Os valores válidos estão no formato hexadecimal, 0xRRGGBB. O padrão é 0xFFFFFF.
Implementação
public function get highlightColor():uint
public function set highlightColor(value:uint):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 valor 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 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
.
Você pode usar as seguintes constantes BitmapFilterQuality
para especificar os valores da propriedade quality
:
BitmapFilterQuality.LOW
BitmapFilterQuality.MEDIUM
BitmapFilterQuality.HIGH
Implementação
public function get quality():int
public function set quality(value:int):void
shadowAlpha | propriedade |
shadowAlpha: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. Esse valor é especificado como um valor normalizado de 0 a 1. Por exemplo, ,25 define um valor de transparência de 25%. O padrão é 1.
Implementação
public function get shadowAlpha():Number
public function set shadowAlpha(value:Number):void
shadowColor | propriedade |
shadowColor:uint
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9 |
Cor de sombra do bisel. Os valores válidos estão no formato hexadecimal, 0xRRGGBB. O padrão é 0x000000.
Implementação
public function get shadowColor():uint
public function set shadowColor(value:uint):void
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. Os valores válidos são 0 a 255. Quanto maior o valor, mais cores são impressas e mais forte será o contraste entre o bisel e o plano de fundo. O valor padrão é 1.
Implementação
public function get strength():Number
public function set strength(value:Number):void
type | propriedade |
type:String
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9 |
Disposição do bisel no objeto. Os biséis interno e externo ficam dispostos na borda interna ou externa; um bisel inteiro fica disposto no objeto inteiro. Os valores válidos são as constantes BitmapFilterType
:
BitmapFilterType.INNER
BitmapFilterType.OUTER
BitmapFilterType.FULL
Implementação
public function get type():String
public function set type(value:String):void
Lança
TypeError — A string fica nula quando está sendo definida
|
BevelFilter | () | Construtor |
public function BevelFilter(distance:Number = 4.0, angle:Number = 45, highlightColor:uint = 0xFFFFFF, highlightAlpha:Number = 1.0, shadowColor:uint = 0x000000, shadowAlpha:Number = 1.0, blurX:Number = 4.0, blurY:Number = 4.0, strength:Number = 1, quality:int = 1, type:String = "inner", 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 BevelFilter com os parâmetros especificados.
Parâmetrosdistance:Number (default = 4.0 ) — Distância de deslocamento do bisel, em pixels (ponto flutuante).
| |
angle:Number (default = 45 ) — Ângulo do bisel, de 0 a 360 graus.
| |
highlightColor:uint (default = 0xFFFFFF ) — Cor de realce do bisel, 0xRRGGBB.
| |
highlightAlpha:Number (default = 1.0 ) — Valor de transparência alfa da cor de realce. Os valores válidos são 0,0 a 1,0. Por exemplo, ,25 define um valor de transparência de 25%.
| |
shadowColor:uint (default = 0x000000 ) — Cor de sombra do bisel, 0xRRGGBB.
| |
shadowAlpha: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 do desfoque horizontal em pixels. Os valores válidos são 0 a 255,0 (ponto flutuante).
| |
blurY:Number (default = 4.0 ) — Intensidade do desfoque vertical em pixels. Os valores válidos são 0 a 255,0 (ponto flutuante).
| |
strength:Number (default = 1 ) — Intensidade da impressão ou dispersão. Quanto maior o valor, mais cores são impressas e mais forte será o contraste entre o bisel e o plano de fundo. Os valores válidos são 0 a 255,0.
| |
quality:int (default = 1 ) — Qualidade do bisel. Os valores válidos são 0 a 15, mas para a maioria dos aplicativos, é possível usar as constantes BitmapFilterQuality :
Filtros com valores menores renderizam mais rapidamente. É possível usar os outros valores numéricos disponíveis para alcançar diferentes efeitos. | |
type:String (default = "inner ") — Tipo de bisel. Os valores válidos são as constantes BitmapFilterType : BitmapFilterType.INNER , BitmapFilterType.OUTER ou BitmapFilterType.FULL .
| |
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.
|
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 — Nova ocorrência BevelFilter com todas as mesmas propriedades que a ocorrência BevelFilter original.
|
- Importe as classes necessárias.
- Declare três propriedades usadas na função
draw()
, que desenha o objeto no qual o filtro de bisel é aplicado. - Crie a função de construtor
BevelFilterExample()
, que faz o seguinte:- Chama a função
draw()
, que é declarada posteriormente. - Declara uma variável
filter
como um objeto BitmapFilter e o atribui para o retorno de uma chamada paragetBitmapFilter()
. - Cria um novo objeto Matriz
myFilters
e adicionafilter
à matriz e atribuimyFilters
à propriedadefilters
do objeto BevelFilterExample. Isso aplica todos os filtros encontrados emmyFilters
, o que, nesse caso, é somentefilter
.
- Chama a função
- Crie a função
getBitmapFilter
para criar e definir as propriedades do filtro. - Crie a função
draw()
. Essa função usa métodos da classe Graphics, acessados por meio da propriedadegraphics
da classe Sprite para desenhar o quadrado.
package { import flash.display.Sprite; import flash.filters.BevelFilter; import flash.filters.BitmapFilter; import flash.filters.BitmapFilterQuality; import flash.filters.BitmapFilterType; public class BevelFilterExample extends Sprite { private var bgColor:uint = 0xFFCC00; private var size:uint = 80; private var offset:uint = 50; public function BevelFilterExample() { draw(); var filter:BitmapFilter = getBitmapFilter(); var myFilters:Array = new Array(); myFilters.push(filter); filters = myFilters; } private function getBitmapFilter():BitmapFilter { var distance:Number = 5; var angleInDegrees:Number = 45; var highlightColor:Number = 0xFFFF00; var highlightAlpha:Number = 0.8; var shadowColor:Number = 0x0000FF; var shadowAlpha:Number = 0.8; var blurX:Number = 5; var blurY:Number = 5; var strength:Number = 5; var quality:Number = BitmapFilterQuality.HIGH; var type:String = BitmapFilterType.INNER; var knockout:Boolean = false; return new BevelFilter(distance, angleInDegrees, highlightColor, highlightAlpha, shadowColor, shadowAlpha, blurX, blurY, strength, quality, type, knockout); } private function draw():void { graphics.beginFill(bgColor); graphics.drawRect(offset, offset, size, size); graphics.endFill(); } } }
Wed Jun 13 2018, 11:10 AM Z