Pacchetto | flash.filters |
Classe | public final class GlowFilter |
Ereditarietà | GlowFilter BitmapFilter Object |
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9 |
distance
e angle
del filtro ombra esterna impostate su 0. Il filtro può essere applicato a qualunque oggetto di visualizzazione (cioè agli oggetti che ereditano dalla classe DisplayObject) quali MovieClip, SimpleButton, TextField e Video, nonché agli oggetti BitmapData.
L'uso dei filtri dipende dall'oggetto a cui il filtro viene applicato:
- Per applicare filtri agli oggetti di visualizzazione, utilizzate la proprietà
filters
(ereditata da DisplayObject). L'impostazione della proprietàfilters
di un oggetto non modifica l'oggetto ed è possibile eliminare il filtro cancellando la proprietàfilters
. - Per applicare filtri a oggetti BitmapData, utilizzate il metodo
BitmapData.applyFilter()
. Quando si chiamaapplyFilter()
su un oggetto BitmapData, vengono acquisiti l'oggetto BitmapData di origine e l'oggetto filtro e viene generata un'immagine filtrata come risultato.
Se applicate un filtro a un oggetto di visualizzazione, la proprietà cacheAsBitmap
dell'oggetto viene impostata su true
. Se cancellate tutti i filtri, viene ripristinato il valore originario di cacheAsBitmap
.
Questo filtro supporta la modifica in scala sullo stage, ma non supporta operazioni generiche di modifica in scala, rotazione e inclinazione. Se l'oggetto stesso viene modificato in scala (se scaleX
e scaleY
sono impostati su un valore diverso da 1.0) il filtro non viene modificato in scala. La modifica in scala avviene solo quando si ingrandisce lo stage.
Un filtro non viene applicato se l'immagine risultante supera le dimensioni massime. In AIR 1.5 e Flash Player 10, la dimensione massima è di 8.191 pixel in larghezza o altezza, mentre il numero totale di pixel non può essere superiore a 16.777.215, pertanto se un'immagine ha una larghezza di 8.191 pixel, può avere solo una lunghezza di 2.048 pixel. In Flash Player 9 e versioni precedenti e in AIR 1.1 e versioni precedenti, la limitazione è di 2.880 pixel in altezza e 2.880 pixel in larghezza. Ad esempio, se ingrandite un clip filmato di grandi dimensioni quando il filtro è applicato, il filtro viene disattivato se l'immagine risultante supera le dimensioni massime.
Elementi API correlati
flash.display.DisplayObject.filters
flash.display.DisplayObject.cacheAsBitmap
flash.display.DisplayObject.scaleX
flash.display.DisplayObject.scaleY
flash.filters.DropShadowFilter.distance
flash.filters.DropShadowFilter.angle
Proprietà | Definito da | ||
---|---|---|---|
alpha : Number
Il valore di trasparenza alfa del colore. | GlowFilter | ||
blurX : Number
La quantità di sfocatura orizzontale. | GlowFilter | ||
blurY : Number
La quantità di sfocatura verticale. | GlowFilter | ||
color : uint
Il colore del bagliore. | GlowFilter | ||
constructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto. | Object | ||
inner : Boolean
Specifica se il bagliore è interno. | GlowFilter | ||
knockout : Boolean
Specifica se l'oggetto presenta un effetto di foratura. | GlowFilter | ||
quality : int
Il numero di applicazioni del filtro. | GlowFilter | ||
strength : Number
L'intensità dell'impressione o applicazione. | GlowFilter |
Metodo | Definito da | ||
---|---|---|---|
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)
Inizializza una nuova istanza GlowFilter con i parametri specificati. | GlowFilter | ||
[override]
Restituisce una copia di questo oggetto filtro. | GlowFilter | ||
Indica se per un oggetto è definita una proprietà specifica. | Object | ||
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro. | Object | ||
Indica se la proprietà specificata esiste ed è enumerabile. | Object | ||
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche. | Object | ||
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate. | Object | ||
Restituisce la rappresentazione in formato stringa dell'oggetto specificato. | Object | ||
Restituisce il valore di base dell'oggetto specificato. | Object |
alpha | proprietà |
alpha:Number
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9 |
Il valore di trasparenza alfa del colore. I valori validi sono compresi tra 0 e 1. Ad esempio, 0.25 imposta un valore di trasparenza del 25%. Il valore predefinito è 1.
Implementazione
public function get alpha():Number
public function set alpha(value:Number):void
blurX | proprietà |
blurX:Number
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9 |
La quantità di sfocatura orizzontale. I valori validi sono compresi tra 0 e 255 (virgola mobile). Il valore predefinito è 6. I valori che sono potenze di 2 (come 2, 4, 8, 16 e 32) vengono ottimizzati per eseguire il rendering più rapidamente di altri valori.
Implementazione
public function get blurX():Number
public function set blurX(value:Number):void
blurY | proprietà |
blurY:Number
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9 |
La quantità di sfocatura verticale. I valori validi sono compresi tra 0 e 255 (virgola mobile). Il valore predefinito è 6. I valori che sono potenze di 2 (come 2, 4, 8, 16 e 32) vengono ottimizzati per eseguire il rendering più rapidamente di altri valori.
Implementazione
public function get blurY():Number
public function set blurY(value:Number):void
color | proprietà |
color:uint
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9 |
Il colore del bagliore. I valori validi sono espressi nel formato esadecimale 0x RRGGBB. Il valore predefinito è 0xFF0000.
Implementazione
public function get color():uint
public function set color(value:uint):void
inner | proprietà |
inner:Boolean
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9 |
Specifica se il bagliore è interno. Il valore true
indica un bagliore interno. Il valore predefinito è false
, che indica un bagliore esterno (ovvero un bagliore attorno ai bordi esterni dell'oggetto).
Implementazione
public function get inner():Boolean
public function set inner(value:Boolean):void
knockout | proprietà |
knockout:Boolean
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9 |
Specifica se l'oggetto presenta un effetto di foratura. Un valore true
rende trasparente il riempimento dell'oggetto e rivela il colore di sfondo del documento. Il valore predefinito è false
(nessun effetto di foratura).
Implementazione
public function get knockout():Boolean
public function set knockout(value:Boolean):void
quality | proprietà |
quality:int
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9 |
Il numero di applicazioni del filtro. Il valore predefinito è BitmapFilterQuality.LOW
, che equivale ad applicare il filtro una volta. Il valore BitmapFilterQuality.MEDIUM
applica il filtro due volte; il valore BitmapFilterQuality.HIGH
lo applica tre volte. Il rendering dei filtri con valori bassi avviene più rapidamente.
Per la maggior parte delle applicazioni è sufficiente un valore quality
basso, medio o alto. Benché sia possibile utilizzare valori numerici aggiuntivi fino a 15 per ottenere effetti diversi, il rendering dei valori elevati avviene più lentamente. Anziché aumentare il valore di quality
, spesso è possibile ottenere un effetto simile (e con un rendering più veloce) semplicemente incrementando i valori delle proprietà blurX
e blurY
.
Implementazione
public function get quality():int
public function set quality(value:int):void
Elementi API correlati
strength | proprietà |
strength:Number
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9 |
L'intensità dell'impressione o applicazione. Più elevato è il valore, maggiore è la quantità di colore impressa e maggiore è il contrasto tra il bagliore e lo sfondo. I valori validi sono compresi tra 0 e 255. Il valore predefinito è 2.
Implementazione
public function get strength():Number
public function set strength(value:Number):void
GlowFilter | () | Funzione di costruzione |
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)
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9 |
Inizializza una nuova istanza GlowFilter con i parametri specificati.
Parametricolor:uint (default = 0xFF0000 ) — Il colore del bagliore, espresso nel formato esadecimale 0x RRGGBB. Il valore predefinito è 0xFF0000.
| |
alpha:Number (default = 1.0 ) — Il valore di trasparenza alfa del colore. I valori validi sono compresi tra 0 e 1. Ad esempio, 0.25 imposta un valore di trasparenza del 25%.
| |
blurX:Number (default = 6.0 ) — La quantità di sfocatura orizzontale. I valori validi sono compresi tra 0 e 255 (virgola mobile). I valori che sono potenze di 2 (come 2, 4, 8, 16 e 32) vengono ottimizzati per eseguire il rendering più rapidamente di altri valori.
| |
blurY:Number (default = 6.0 ) — La quantità di sfocatura verticale. I valori validi sono compresi tra 0 e 255 (virgola mobile). I valori che sono potenze di 2 (come 2, 4, 8, 16 e 32) vengono ottimizzati per eseguire il rendering più rapidamente di altri valori.
| |
strength:Number (default = 2 ) — L'intensità dell'impressione o applicazione. Più elevato è il valore, maggiore è la quantità di colore impressa e maggiore è il contrasto tra il bagliore e lo sfondo. I valori validi sono compresi tra 0 e 255.
| |
quality:int (default = 1 ) — Il numero di applicazioni del filtro. Utilizzate le costanti di BitmapFilterQuality:
Per ulteriori informazioni, vedete la descrizione della proprietà | |
inner:Boolean (default = false ) — Specifica se il bagliore è interno. Il valore true indica un bagliore interno. Il valore false indica un bagliore esterno (ovvero un bagliore attorno ai bordi esterni dell'oggetto).
| |
knockout:Boolean (default = false ) — Specifica se l'oggetto presenta un effetto di foratura. Il valore true rende trasparente il riempimento dell'oggetto e rivela il colore di sfondo del documento.
|
Elementi API correlati
clone | () | metodo |
override public function clone():BitmapFilter
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9 |
Restituisce una copia di questo oggetto filtro.
RestituisceBitmapFilter — Una nuova istanza GlowFilter con tutte le proprietà dell'istanza originale.
|
- Importare le classi richieste.
- Dichiarate tre proprietà utilizzate nella funzione
draw()
, che utilizza i metodi della classe Graphics a cui si accede tramite la proprietàgraphics
di Sprite per disegnare un quadrato arancione. - Create la funzione di costruzione che esegue le seguenti operazioni:
- Chiama la funzione
draw
per creare un rettangolo. - Crea un oggetto BitmapFilter
glowFilter
e gli assegna i valori restituiti dalla funzionegetBitmapFilter()
. - Assegna l'array di valori dell'oggetto
glowFilter
alla proprietàfilters
dell'oggetto di visualizzazione principale (root). In questo caso, tutti gli oggetti di visualizzazione secondari dell'oggetto root ereditano le proprietà del filtro bagliore. Pertanto, il rettangolo creato nella funzionedraw()
visualizza le proprietà del filtro bagliore.
- Chiama la funzione
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(); } } }
Tue Jun 12 2018, 02:44 PM Z