Pacchetto | flash.filters |
Classe | public final class DropShadowFilter |
Ereditarietà | DropShadowFilter BitmapFilter Object |
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9 |
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, il valore della proprietà cacheAsBitmap
dell'oggetto viene impostato 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. Se, ad esempio, 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
Proprietà | Definito da | ||
---|---|---|---|
alpha : Number
Il valore di trasparenza alfa del colore d'ombra. | DropShadowFilter | ||
angle : Number
L'angolo dell'ombra. | DropShadowFilter | ||
blurX : Number
La quantità di sfocatura orizzontale. | DropShadowFilter | ||
blurY : Number
La quantità di sfocatura verticale. | DropShadowFilter | ||
color : uint
Il colore dell'ombra. | DropShadowFilter | ||
constructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto. | Object | ||
distance : Number
La distanza di offset dell'ombra, in pixel. | DropShadowFilter | ||
hideObject : Boolean
Indica se l'oggetto è nascosto o meno. | DropShadowFilter | ||
inner : Boolean
Indica se l'ombra è interna o meno. | DropShadowFilter | ||
knockout : Boolean
Applica un effetto di foratura (true), che rende trasparente il riempimento dell'oggetto e rivela il colore di sfondo del documento. | DropShadowFilter | ||
quality : int
Il numero di applicazioni del filtro. | DropShadowFilter | ||
strength : Number
L'intensità dell'impressione o applicazione. | DropShadowFilter |
Metodo | Definito da | ||
---|---|---|---|
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)
Crea una nuova istanza DropShadowFilter con i parametri specificati. | DropShadowFilter | ||
[override]
Restituisce una copia di questo oggetto filtro. | DropShadowFilter | ||
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 d'ombra. I valori validi sono compresi tra 0,0 e 1,0. Ad esempio, 0.25 imposta un valore di trasparenza del 25%. Il valore predefinito è 1,0.
Implementazione
public function get alpha():Number
public function set alpha(value:Number):void
angle | proprietà |
angle:Number
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9 |
L'angolo dell'ombra. I valori validi sono compresi tra 0 e 360 gradi (virgola mobile). Il valore predefinito è 45.
Implementazione
public function get angle():Number
public function set angle(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,0 (virgola mobile). Il valore predefinito è 4,0.
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,0 (virgola mobile). Il valore predefinito è 4,0.
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 dell'ombra. I valori validi sono espressi nel formato esadecimale 0xRRGGBB. Il valore predefinito è 0x000000.
Implementazione
public function get color():uint
public function set color(value:uint):void
distance | proprietà |
hideObject | proprietà |
hideObject:Boolean
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9 |
Indica se l'oggetto è nascosto o meno. Il valore true
indica che l'oggetto stesso non è disegnato e che è visibile solo l'ombra. Il valore predefinito è false
(l'oggetto è visibile).
Implementazione
public function get hideObject():Boolean
public function set hideObject(value:Boolean):void
inner | proprietà |
inner:Boolean
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9 |
Indica se l'ombra è interna o meno. Il valore true
indica un'ombra interna. Il valore predefinito è false
, che indica un'ombra esterna, ovvero un'ombra 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 |
Applica un effetto di foratura (true
) che rende trasparente il riempimento dell'oggetto e rivela il colore di sfondo del documento. Il valore predefinito è false
(nessuna 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 l'ombra e lo sfondo. I valori validi sono compresi tra 0 e 255,0. Il valore predefinito è 1.0.
Implementazione
public function get strength():Number
public function set strength(value:Number):void
DropShadowFilter | () | Funzione di costruzione |
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)
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9 |
Crea una nuova istanza DropShadowFilter con i parametri specificati.
Parametridistance:Number (default = 4.0 ) — La distanza di offset dell'ombra, in pixel.
| |
angle:Number (default = 45 ) — L'angolo dell'ombra, compreso tra 0 e 360 gradi (virgola mobile).
| |
color:uint (default = 0 ) — Il colore dell'ombra, espresso nel formato esadecimale 0xRRGGBB. Il valore predefinito è 0x000000.
| |
alpha:Number (default = 1.0 ) — Il valore della trasparenza alfa per il colore d'ombra. I valori validi sono compresi tra 0.0 e 1.0. Ad esempio, 0.25 imposta un valore di trasparenza del 25%.
| |
blurX:Number (default = 4.0 ) — Quantità di sfocatura orizzontale. I valori validi sono compresi tra 0 e 255,0 (virgola mobile).
| |
blurY:Number (default = 4.0 ) — Quantità di sfocatura verticale. I valori validi sono compresi tra 0 e 255,0 (virgola mobile).
| |
strength:Number (default = 1.0 ) — L'intensità dell'impressione o applicazione. Più elevato è il valore, maggiore è la quantità di colore impressa e maggiore è il contrasto tra l'ombra e lo sfondo. I valori validi sono compresi tra 0 e 255,0.
| |
quality:int (default = 1 ) — Il numero di applicazioni del filtro. Utilizzate le costanti di BitmapFilterQuality:
Per ulteriori informazioni su questi valori, vedete la descrizione della proprietà | |
inner:Boolean (default = false ) — Indica se l'ombra è interna o meno. Il valore true specifica un'ombra interna. Il valore false specifica un'ombra esterna (ovvero un'ombra attorno ai bordi esterni dell'oggetto).
| |
knockout:Boolean (default = false ) — Applica un effetto di foratura (true ) che rende trasparente il riempimento dell'oggetto e rivela il colore di sfondo del documento.
| |
hideObject:Boolean (default = false ) — Indica se l'oggetto è nascosto o meno. Il valore true indica che l'oggetto stesso non è disegnato e che ne è visibile solo l'ombra.
|
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 DropShadowFilter con tutte le proprietà dell'originale.
|
- Dichiarate le tre proprietà utilizzate per disegnare il quadrato a cui è applicato il filtro.
- Create la funzione di costruzione La funzione di costruzione chiama il metodo
draw()
, che utilizza i metodi della classe Graphics a cui si accede tramite la proprietàgraphics
di Sprite per disegnare un quadrato arancione. - Nella funzione di costruzione dichiarare una variabile
filter
come oggetto BitmapFilter e assegnarla al valore restituito di una chiamata agetBitmapFilter()
. Il metodogetBitmapFilter()
definisce il filtro filtro ombra esterna utilizzato. - Create un nuovo oggetto Array
myFilters
e aggiungetefilter
all'array. Assegnate l'arraymyFilters
alla proprietàfilters
dell'oggetto DropShadowFilterExample. In questo modo vengono applicati tutti i filtri presenti inmyFilters
; in questo caso solofilter
.
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(); } } }
Tue Jun 12 2018, 02:44 PM Z