Paquete | flash.filters |
Clase | public final class BlurFilter |
Herencia | BlurFilter BitmapFilter Object |
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
quality
de este filtro se define en calidad baja, el resultado es un ligero efecto. Si la propiedad quality
se define en calidad alta, se aproxima a un filtro de desenfoque gaussiano. Puede aplicar el filtro a cualquier objeto de visualización (es decir, objetos que hereden de la clase DisplayObject), como objetos MovieClip, SimpleButton, TextField y Video, y también objetos BitmapData.
Para crear un nuevo filtro, utilice el constructor new BlurFilter()
. El uso de filtros depende del objeto al que se aplique el filtro:
- Para aplicar filtros a clips de película, campos de texto, botones y vídeo, utilice la propiedad
filters
(heredada de DisplayObject). La propiedadfilters
de un objeto no lo modifica y se puede quitar el filtro borrando la propiedadfilters
. - Para aplicar filtros a objetos BitmapData, utilice el método
BitmapData.applyFilter()
. Cuando se llama aapplyFilter()
en un objeto BitmapData, se genera una imagen filtrada al procesar el objeto BitmapData de origen y el objeto de filtro.
Si aplica un filtro a un objeto de visualización, la propiedad cacheAsBitmap
del objeto de visualización se establece en true
. Si quita todos los filtros, se restaurará el valor original de cacheAsBitmap
.
Este filtro admite la aplicación de escala en el escenario. Sin embargo, no admite escalado general, rotación ni sesgo. Cuando se escala el propio objeto (scaleX
y scaleY
no se establecen en 100%), no se escala el filtro. Sólo se escalará cuando el usuario acerque el escenario.
No se aplica ningún filtro si la imagen resultante excede las dimensiones máximas. En AIR 1.5 y en Flash Player 10, la anchura o altura máxima en píxeles es de 8,191, y el número total de píxeles no puede superar los 16,777,215. (De este modo, si una imagen tiene 8,191 píxeles de anchura, sólo podrá tener 2.048 píxeles de altura.) En Flash Player 9 y versiones anteriores y en AIR 1.1 y versiones anteriores, el límite es 2.880 píxeles de alto y 2.880 píxeles de ancho. Por ejemplo, si amplía un clip de película grande al que se le ha aplicado un filtro, éste se desactiva si la imagen resultante supera las dimensiones máximas.
Elementos de API relacionados
flash.display.DisplayObject.cacheAsBitmap
flash.display.BitmapData.applyFilter()
Propiedad | Definido por | ||
---|---|---|---|
blurX : Number
Cantidad de desenfoque horizontal. | BlurFilter | ||
blurY : Number
Cantidad de desenfoque vertical. | BlurFilter | ||
constructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada. | Object | ||
quality : int
Número de veces que debe realizarse el desenfoque. | BlurFilter |
Método | Definido por | ||
---|---|---|---|
Inicializa el filtro con los parámetros especificados. | BlurFilter | ||
[override]
Devuelve una copia de este objeto de filtro. | BlurFilter | ||
Indica si un objeto tiene definida una propiedad especificada. | Object | ||
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro. | Object | ||
Indica si existe la propiedad especificada y si es enumerable. | Object | ||
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle. | Object | ||
Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional. | Object | ||
Devuelve la representación de cadena del objeto especificado. | Object | ||
Devuelve el valor simple del objeto especificado. | Object |
blurX | propiedad |
blurX:Number
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
Cantidad de desenfoque horizontal. Los valores válidos son de 0 a 255 (coma flotante). El valor predeterminado es 4. Los valores que son potencia de 2 (como 2, 4, 8, 16 y 32) se optimizan para representarse más rápidamente que otros valores.
Implementación
public function get blurX():Number
public function set blurX(value:Number):void
blurY | propiedad |
blurY:Number
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
Cantidad de desenfoque vertical. Los valores válidos son de 0 a 255 (coma flotante). El valor predeterminado es 4. Los valores que son potencia de 2 (como 2, 4, 8, 16 y 32) se optimizan para representarse más rápidamente que otros valores.
Implementación
public function get blurY():Number
public function set blurY(value:Number):void
quality | propiedad |
quality:int
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
Número de veces que debe realizarse el desenfoque. El valor predeterminado es BitmapFilterQuality.LOW
, lo que equivale a aplicar el filtro una vez. El valor BitmapFilterQuality.MEDIUM
aplica el filtro dos veces; el valor BitmapFilterQuality.HIGH
lo aplica tres veces y se aproxima a un desenfoque gaussiano. Los filtros con valores más bajos se representan con mayor rapidez.
Para la mayoría de las aplicaciones, es suficiente un valor quality
de calidad baja, media o alta. Aunque puede utilizar valores numéricos hasta 15 para conseguir efectos distintos, los valores más altos se representan más lentamente. En lugar de aumentar el valor de quality
, se suele conseguir un efecto similar, con una representación más rápida, simplemente aumentando los valores de las propiedades blurX
y blurY
.
Puede utilizar las siguientes constantes BitmapFilterQuality para especificar los valores de la propiedad quality
:
BitmapFilterQuality.LOW
BitmapFilterQuality.MEDIUM
BitmapFilterQuality.HIGH
Implementación
public function get quality():int
public function set quality(value:int):void
BlurFilter | () | Información sobre |
public function BlurFilter(blurX:Number = 4.0, blurY:Number = 4.0, quality:int = 1)
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
Inicializa el filtro con los parámetros especificados. Los valores predeterminados crean una imagen suave y desenfocada.
ParámetrosblurX:Number (default = 4.0 ) — La cantidad que se va a desenfocar en horizontal. Los valores válidos son de 0 a 255,0 (valor de coma flotante).
| |
blurY:Number (default = 4.0 ) — La cantidad que se va a desenfocar en vertical. Los valores válidos son de 0 a 255,0 (valor de coma flotante).
| |
quality:int (default = 1 ) — Número de veces que debe aplicarse el filtro. Puede especificar la calidad con las constantes BitmapFilterQuality:
La calidad alta se aproxima a un desenfoque gaussiano. Para la mayoría de las aplicaciones, es suficiente con estos tres valores. Aunque puede utilizar valores numéricos hasta 15 para conseguir efectos distintos, tenga en cuenta que los valores más altos se representan más lentamente. |
clone | () | método |
override public function clone():BitmapFilter
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
Devuelve una copia de este objeto de filtro.
Valor devueltoBitmapFilter — Instancia BlurFilter nueva con las mismas propiedades que la instancia BlurFilter original.
|
- Importe las clases necesarias.
- Declare tres propiedades utilizadas en la función
draw()
, que dibuja el objeto al que se aplicará el filtro de desenfoque. - Cree la función constructora
BlurFilterExample()
, que realiza lo siguiente:- Llama a la función
draw()
, que se declara más adelante. - Declara una variable
filter
como un objeto BitmapFilter y lo asigna al valor devuelto de una llamada agetBitmapFilter()
. - Crea un nuevo objeto Array
myFilters
y añade la propiedadfilter
al conjunto. Después asignamyFilters
a la propiedadfilters
del objeto BlurFilterExample. Esto se aplicará a todos los filtros demyFilters
que, en este caso, sólo esfilter
.
- Llama a la función
- Cree la función
getBitmapFilter()
para crear y definir las propiedades del filtro. - Cree la función
draw()
. Esta función utiliza métodos de la clase Graphics, a la que se accede mediante la propiedadgraphics
de la clase Sprite, para dibujar el cuadrado.
package { import flash.display.Sprite; import flash.filters.BitmapFilter; import flash.filters.BitmapFilterQuality; import flash.filters.BlurFilter; public class BlurFilterExample extends Sprite { private var bgColor:uint = 0xFFCC00; private var size:uint = 80; private var offset:uint = 50; public function BlurFilterExample() { draw(); var filter:BitmapFilter = getBitmapFilter(); var myFilters:Array = new Array(); myFilters.push(filter); filters = myFilters; } private function getBitmapFilter():BitmapFilter { var blurX:Number = 30; var blurY:Number = 30; return new BlurFilter(blurX, blurY, BitmapFilterQuality.HIGH); } private function draw():void { graphics.beginFill(bgColor); graphics.drawRect(offset, offset, size, size); graphics.endFill(); } } }
Tue Jun 12 2018, 02:12 PM Z