GradientBevelFilter  - AS3

Un array di valori di trasparenza alfa per i colori corrispondenti nell'array colors. I valori validi per ciascun elemento dell'array sono compresi tra 0 e 1. Ad esempio, 0.25 imposta un valore di trasparenza del 25%.

Non è possibile cambiare la proprietà alphas mediante la modifica diretta dei relativi valori. Al contrario, è necessario ottenere un riferimento a alphas, modificarlo e quindi impostare alphas sul riferimento.

Le proprietà colors, alphas e ratios sono correlate. Il primo elemento dell'array colors corrisponde al primo elemento dell'array alphas e dell'array ratios, e così via.

Elementi API correlati

L'angolo, espresso in gradi. I valori validi sono compresi tra 0 e 360. Il valore predefinito è 45.

Il valore angle rappresenta l'angolo della fonte di luce teorica che colpisce l'oggetto. Questo valore determina l'angolo in base al quale i colori con gradiente vengono applicati all'oggetto: le aree dove compaiono l'evidenziazione e l'ombra o dove compare il primo colore dell'array. I colori vengono in seguito applicati nell'ordine in cui compaiono nell'array.

Elementi API correlati

La quantità di sfocatura orizzontale. I valori validi sono compresi tra 0 e 255. Un valore di sfocatura pari a 1 o inferiore indica che l'immagine viene copiata senza alterazioni. Il valore predefinito è 4. 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.

La quantità di sfocatura verticale. I valori validi sono compresi tra 0 e 255. Un valore di sfocatura pari a 1 o inferiore indica che l'immagine viene copiata senza alterazioni. Il valore predefinito è 4. 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.

Un array di valori di colore esadecimali RGB da utilizzare nel gradiente. Ad esempio il rosso è 0xFF0000, il blu è 0x0000FF e così via.

Non è possibile cambiare la proprietà colors mediante la modifica diretta dei relativi valori. È necessario invece ottenere un riferimento a colors, modificarlo e quindi impostare colors sul riferimento.

Le proprietà colors, alphas e ratios sono correlate. Il primo elemento dell'array colors corrisponde al primo elemento dell'array alphas e dell'array ratios, e così via.

Elementi API correlati

La distanza dell'offset. I valori validi sono compresi tra 0 e 8. Il valore predefinito è 4,0.

Specifica se l'oggetto presenta un effetto di foratura. L'effetto di foratura rende trasparente il riempimento dell'oggetto e rivela il colore di sfondo del documento. Il valore true specifica un effetto di foratura; il valore predefinito è false (nessun effetto di foratura).

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.

Elementi API correlati

Un array di rapporti di distribuzione del colore per i colori corrispondenti nell'array colors. I valori validi per ciascun elemento dell'array sono compresi tra 0 e 255.

Non è possibile cambiare la proprietà ratios mediante la modifica diretta dei relativi valori. È necessario invece ottenere un riferimento a ratios, modificarlo e quindi impostare ratios sul riferimento.

Le proprietà colors, alphas e ratios sono correlate. Il primo elemento dell'array colors corrisponde al primo elemento dell'array alphas e dell'array ratios, e così via.

Per comprendere la distribuzione dei colori in una smussatura con gradiente è necessario definire innanzitutto i colori che si desidera inserire nella smussatura. Una smussatura semplice ha un colore di evidenziazione e un colore d'ombra; una smussatura con gradiente ha un gradiente di evidenziazione e un gradiente d'ombra. Supponete che l'evidenziazione appaia nell'angolo in alto a sinistra e l'ombra nell'angolo in basso a destra. Supponete che un possibile utilizzo del filtro preveda quattro colori per l'evidenziazione e quattro per l'ombra. Oltre all'evidenziazione e all'ombra, il filtro usa un colore di riempimento di base in cui i bordi dell'evidenziazione e dell'ombra si incontrano. Pertanto, il numero totale di colori è nove e il numero corrispondente di elementi nell'array dei rapporti è nove.

Se immaginate che un gradiente è composto da strisce di vari colori che si fondono l'uno nell'altro, ogni valore del rapporto determina la posizione del colore sul raggio del gradiente in cui 0 e 255 rappresentano rispettivamente il punto più esterno e il punto più interno del gradiente. Per un utilizzo tipico, il valore intermedio è 128, ovvero il valore del riempimento di base. Per ottenere l'effetto di smussatura visualizzato nell'immagine riportata sotto, assegnate i valori del rapporto nel modo seguente, basandosi sull'esempio dei nove colori:

• I primi quattro colori sono compresi tra 0 e 127 e aumentano di valore in modo che ogni valore sia uguale o superiore al precedente. Questo è il bordo di smussatura con l'evidenziazione.
• Il quinto colore (il colore intermedio) è il riempimento di base impostato su 128. Il valore in pixel di 128 determina il riempimento di base che appare al di fuori della forma (e attorno agli angoli di smussatura) se il tipo è impostato su esterno oppure all'interno della forma coprendo il riempimento stesso dell'oggetto se il tipo è impostato su interno.
• Gli ultimi quattro colori sono compresi tra 129 e 255 e aumentano di valore in modo che ogni valore sia uguale o superiore al precedente. Questo è il bordo di smussatura con l'ombra.

Se desiderate un'equa distribuzione dei colori per ciascun bordo, utilizzate un numero dispari con il colore intermedio come riempimento di base. Distribuite equamente i valori 0-127 e 129-255 tra i colori utilizzati, quindi regolate il valore per modificare la larghezza di ciascuna striscia di colore del gradiente. Per una smussatura con gradiente basato su nove colori, un possibile array è [16, 32, 64, 96, 128, 160, 192, 224, 235]. L'immagine seguente mostra la smussatura con gradiente descritta:

Tenere presente che l'applicazione dei colori nel gradiente varia a seconda dei valori delle proprietà blurX, blurY, strength e quality nonché dei valori ratios.

Elementi API correlati

L'intensità dell'impressione o applicazione. Più elevato è il valore, maggiore è la quantità di colore impressa e maggiore è il contrasto tra la smussatura e lo sfondo. I valori validi sono compresi tra 0 e 255. Un valore pari a 0 indica che il filtro non è applicato. Il valore predefinito è 1.

Elementi API correlati

La posizione dell'effetto di smussatura. I valori possibili sono costanti di BitmapFilterType:

• BitmapFilterType.OUTER - Smusso applicato al bordo esterno dell'oggetto.
• BitmapFilterType.INNER - Smusso applicato al bordo interno dell'oggetto.
• BitmapFilterType.FULL - Smusso applicato sopra l'oggetto.

Inizializza il filtro con i parametri specificati.

Elementi API correlati

Restituisce una copia di questo oggetto filtro.

1. Importare le classi richieste.
2. Dichiarare le variabili globali per definire il quadrato e il filtro.
3. Create la funzione di costruzione che esegue le seguenti operazioni:
   • 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 grigio.
   • Crea un oggetto BitmapFilter denominato filter e assegna ad esso il valore restituito da una chiamata a getBitmapFilter(), che crea il filtro.
   • Crea un nuovo array denominato myFilters e aggiunge filter ad esso.
   • Assegna myFilters alla proprietà filters dell'oggetto GradientBevelFilterExample. In questo modo vengono applicati tutti i filtri presenti in myFilters; in questo caso solo filter.

package {
    import flash.display.Sprite;
    import flash.filters.BitmapFilter;
    import flash.filters.BitmapFilterQuality;
    import flash.filters.BitmapFilterType;
    import flash.filters.GradientBevelFilter;

    public class GradientBevelFilterExample extends Sprite {
        private var bgColor:uint     = 0xCCCCCC;
        private var size:uint        = 80;
        private var offset:uint      = 50;
        private var distance:Number  = 5;
        private var angleInDegrees:Number = 225; // opposite 45 degrees
        private var colors:Array     = [0xFFFFFF, 0xCCCCCC, 0x000000];
        private var alphas:Array     = [1, 0, 1];
        private var ratios:Array     = [0, 128, 255];
        private var blurX:Number     = 8;
        private var blurY:Number     = 8;
        private var strength:Number  = 2;
        private var quality:Number   = BitmapFilterQuality.HIGH
        private var type:String      = BitmapFilterType.INNER;
        private var knockout:Boolean = true;

        public function GradientBevelFilterExample() {
            draw();
            var filter:BitmapFilter = getBitmapFilter();
            var myFilters:Array = new Array();
            myFilters.push(filter);
            filters = myFilters;
        }

        private function getBitmapFilter():BitmapFilter {
            return new GradientBevelFilter(distance,
                                           angleInDegrees,
                                           colors,
                                           alphas,
                                           ratios,
                                           blurX,
                                           blurY,
                                           strength,
                                           quality,
                                           type,
                                           knockout);
        }

        private function draw():void {
            graphics.beginFill(bgColor);
            graphics.drawRect(offset, offset, size, size);
            graphics.endFill();
        }
    }
}