Pakiet | flash.filters |
Klasa | public final class GlowFilter |
Dziedziczenie | GlowFilter ![]() ![]() |
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9 |
distance
i angle
filtra cienia są ustawione na 0. Filtr można zastosować do dowolnego obiektu ekranowego (obiektu, który dziedziczy z klasy DisplayObject), takiego jak MovieClip, SimpleButton, TextField i Video, a także do obiektów BitmapData.
Użycie filtra jest uzależnione od obiektu, dla którego filtr ma być stosowany:
- W celu zastosowania filtrów dla obiektów wyświetlanych należy korzystać z właściwości
filters
(dziedziczona z klasy DisplayObject). Ustawienie właściwościfilters
obiektu nie powoduje modyfikacji obiektu, a filtr można usunąć, usuwając właściwośćfilters
. - Aby stosować filtry do obiektów BitmapData, należy użyć metody
BitmapData.applyFilter()
. Wywołanie metodyapplyFilter()
dla obiektu BitmapData powoduje wygenerowanie obrazu filtrowanego ze źródłowego obiektu BitmapData za pomocą obiektu filtru.
Zastosowanie filtru do obiektu wyświetlanego powoduje, że dla właściwości cacheAsBitmap
obiektu wyświetlanego zostaje ustawiona wartość true
. Po usunięciu wszystkich filtrów zostaje przywrócona wartość oryginalna właściwości cacheAsBitmap
.
Filtr obsługuje skalowanie stołu montażowego. Jednak nie obsługuje skalowania ogólnego, rotacji ani pochylenia. Jeśli skalowany jest sam obiekt (dla wartości scaleX
i scaleY
ustawiana jest wartość inna niż 1,0), sam filtr nie jest skalowany. Jest skalowany tylko wówczas, gdy użytkownik powiększy stół montażowy.
Filtr nie zostanie zastosowany, jeśli wynikowy obraz przekracza maksymalne wymiary. W środowisku AIR 1.5 oraz w programie Flash Player 10 maksymalna wartość szerokości lub wysokości to 8 191 pikseli, a całkowita liczba pikseli nie może przekraczać 16 777 215 pikseli. (Dlatego, jeśli obraz jest szeroki na 8 192 pikseli, może mieć jedynie 2 048 pikseli wysokości). W programie Flash Player 9 i wcześniejszych wersjach oraz w środowisku AIR 1.1 i wcześniejszych wersjach ograniczenie wysokości i szerokości wynosiło 2880 pikseli. Przykład: powiększenie dużego klipu filmowego, do którego zastosowano filtr, powoduje, że filtr zostaje wyłączony, gdy obraz wynikowy przekroczy maksymalne wymiary.
Powiązane elementy interfejsu API
flash.display.DisplayObject.filters
flash.display.DisplayObject.cacheAsBitmap
flash.display.DisplayObject.scaleX
flash.display.DisplayObject.scaleY
flash.filters.DropShadowFilter.distance
flash.filters.DropShadowFilter.angle
Właściwość | Zdefiniowane przez | ||
---|---|---|---|
alpha : Number
Wartość przezroczystości alfa koloru. | GlowFilter | ||
blurX : Number
Intensywność rozmycia w poziomie. | GlowFilter | ||
blurY : Number
Intensywność rozmycia w pionie. | GlowFilter | ||
color : uint
Kolor blasku. | GlowFilter | ||
![]() | constructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu. | Object | |
inner : Boolean
Określa, czy blask jest blaskiem wewnętrznym. | GlowFilter | ||
knockout : Boolean
Określa, czy z tym obiektem skojarzono ramkę odcięcia. | GlowFilter | ||
quality : int
Liczba operacji zastosowania filtra. | GlowFilter | ||
strength : Number
Siła odciskania lub zalewkowania. | GlowFilter |
Metoda | Zdefiniowane przez | ||
---|---|---|---|
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)
Inicjuje nowe wystąpienie klasy GlowFilter z określonymi parametrami. | GlowFilter | ||
[przesłanianie]
Zwraca kopię tego obiektu typu Filter. | GlowFilter | ||
![]() |
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość. | Object | |
![]() |
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr. | Object | |
![]() |
Wskazuje, czy określona właściwość istnieje i jest przeliczalna. | Object | |
![]() |
Ustawia dostępność właściwości dynamicznej używanej w pętlach. | Object | |
![]() |
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych. | Object | |
![]() |
Zwraca ciąg reprezentujący określony obiekt. | Object | |
![]() |
Zwraca pierwotną wartość dla określonego obiektu. | Object |
alpha | właściwość |
alpha:Number
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9 |
Wartość przezroczystości alfa koloru. Poprawne wartości należą do zakresu od 0 do 1. Przykład: 0,25 powoduje ustawienie przezroczystości równej 25%. Wartością domyślną jest 1.
Implementacja
public function get alpha():Number
public function set alpha(value:Number):void
blurX | właściwość |
blurX:Number
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9 |
Intensywność rozmycia w poziomie. Poprawne wartości należą do zakresu od 0 do 255 (wielkość zmiennoprzecinkowa). Wartością domyślną jest 6. Wartości, które są potęgami 2 (dwójki 2, 4, 8, 16 i 32) są zoptymalizowane i są renderowane szybciej niż inne wartości.
Implementacja
public function get blurX():Number
public function set blurX(value:Number):void
blurY | właściwość |
blurY:Number
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9 |
Intensywność rozmycia w pionie. Poprawne wartości należą do zakresu od 0 do 255 (wielkość zmiennoprzecinkowa). Wartością domyślną jest 6. Wartości, które są potęgami 2 (na przykład liczby 2, 4, 8, 16 i 32), są zoptymalizowane i są renderowane szybciej niż inne wartości.
Implementacja
public function get blurY():Number
public function set blurY(value:Number):void
color | właściwość |
inner | właściwość |
inner:Boolean
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9 |
Określa, czy blask jest blaskiem wewnętrznym. Wartość true
określa poświatę wewnętrzną. Wartością domyślną jest false
— poświata zewnętrzna (poświata wokół zewnętrznych krawędzi obiektu).
Implementacja
public function get inner():Boolean
public function set inner(value:Boolean):void
knockout | właściwość |
knockout:Boolean
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9 |
Określa, czy z tym obiektem skojarzono ramkę odcięcia. Wartość true
sprawia, że wypełnienie obiektu jest przezroczyste i ujawnia kolor tła dokumentu. Wartością domyślną jest false
(brak odcięcia).
Implementacja
public function get knockout():Boolean
public function set knockout(value:Boolean):void
quality | właściwość |
quality:int
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9 |
Liczba operacji zastosowania filtra. Wartością domyślną jest BitmapFilterQuality.LOW
, która jest równoważna jednorazowemu zastosowaniu filtra. Wartość BitmapFilterQuality.MEDIUM
powoduje dwukrotne zastosowanie filtra; wartość BitmapFilterQuality.HIGH
powoduje trzykrotne zastosowanie filtra. Filtry o niższych wartościach są renderowane szybciej.
W większości zastosowań wystarczające są następujące wartości quality
: low, medium i high. Mimo że w celu osiągnięcia różnych efektów można stosować dodatkowe wartości liczbowe (aż do 15), wyższe wartości są renderowane wolniej. Zamiast zwiększać wartość quality
— w celu uzyskania podobnego efektu przy krótszym czasie renderowania — można po prostu zwiększać wartości właściwości blurX
i blurY
.
Implementacja
public function get quality():int
public function set quality(value:int):void
Powiązane elementy interfejsu API
strength | właściwość |
strength:Number
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9 |
Siła odciskania lub zalewkowania. Im wyższa jest wartość, tym więcej koloru zostaje odciśnięte, co powoduje również wzmocnienie kontrastu między poświatą i tłem. Poprawne wartości należą do zakresu od 0 do 255. Wartością domyślną jest 2.
Implementacja
public function get strength():Number
public function set strength(value:Number):void
GlowFilter | () | Konstruktor |
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)
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9 |
Inicjuje nową instancję obiektu GlowFilter z określonymi parametrami.
Parametrycolor:uint (default = 0xFF0000 ) — Kolor poświaty w formacie szesnasktkowym 0xRRGGBB. Wartością domyślną jest 0xFF0000.
| |
alpha:Number (default = 1.0 ) — Wartość przezroczystości alfa koloru. Poprawne wartości należą do zakresu od 0 do 1. Przykład: 0,25 powoduje ustawienie przezroczystości równej 25%.
| |
blurX:Number (default = 6.0 ) — Intensywność rozmycia w poziomie. Poprawne wartości należą do zakresu od 0 do 255 (wielkość zmiennoprzecinkowa). Wartości, które są potęgami 2 (dwójki 2, 4, 8, 16 i 32) są zoptymalizowane i są renderowane szybciej niż inne wartości.
| |
blurY:Number (default = 6.0 ) — Intensywność rozmycia w pionie. Poprawne wartości należą do zakresu od 0 do 255 (wielkość zmiennoprzecinkowa). Wartości, które są potęgami 2 (na przykład liczby 2, 4, 8, 16 i 32), są zoptymalizowane i są renderowane szybciej niż inne wartości.
| |
strength:Number (default = 2 ) — Siła odciskania lub zalewkowania. Im wyższa jest wartość, tym więcej koloru zostaje odciśnięte, co powoduje również wzmocnienie kontrastu między poświatą i tłem. Poprawne wartości należą do zakresu od 0 do 255.
| |
quality:int (default = 1 ) — Liczba operacji zastosowania filtra. Należy korzystać ze stałych BitmapFilterQuality:
Więcej informacji zawiera opis właściwości | |
inner:Boolean (default = false ) — Określa, czy blask jest blaskiem wewnętrznym. Wartość true określa poświatę wewnętrzną. Wartość false określa poświatę zewnętrzną (poświata wokół zewnętrznych krawędzi obiektu).
| |
knockout:Boolean (default = false ) — Określa, czy z tym obiektem skojarzono ramkę odcięcia. Wartość true sprawia, że wypełnienie obiektu jest przezroczyste i ujawnia kolor tła dokumentu.
|
Powiązane elementy interfejsu API
clone | () | metoda |
override public function clone():BitmapFilter
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9 |
Zwraca kopię tego obiektu typu Filter.
ZwracaBitmapFilter — Nowa instancja GlowFilter z wszystkimi właściwościami oryginalnej instancji GlowFilter.
|
- Zaimportuj wymagane klasy.
- Zadeklaruj trzy właściwości w metodzie
draw
, która korzysta z metod klasy Graphics, do których uzyskuje dostęp za pośrednictwem właściwościgraphics
Sprite w celu narysowania pomarańczowego kwadratu. - Utwórz funkcję konstruktora, którego działanie jest następujące:
- Wywołuje funkcję
draw
w celu utworzenia prostokąta. - Tworzy obiekt
glowFilter
klasy BitmapFilter i przypisuje do niego wartości zwrócone przez funkcjęgetBitmapFilter()
. - Przypisuje tablicę wartości z obiektu
glowFilter
do właściwościfilters
głównego obiektu ekranowego. W tym przypadku wszystkie elementy podrzędne głównego obiektu ekranowego dziedziczą właściwości filtru poświaty. Oznacza to, że prostokąt utworzony za pomocą funkcjidraw()
jest wyświetlany z zastosowaniem właściwości filtru poświaty.
- Wywołuje funkcję
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, 12:06 PM Z