套件 | flash.filters |
類別 | public final class GlowFilter |
繼承 | GlowFilter BitmapFilter Object |
語言版本: | ActionScript 3.0 |
執行階段版本: | AIR 1.0, Flash Player 9 |
distance
及 angle
屬性設為 0 的投影濾鏡。 您可以將此濾鏡套用至任何顯示物件 (亦即,繼承自 DisplayObject 類別的物件),例如 MovieClip、SimpleButton、TextField 和 Video 物件,以及 BitmapData 物件。
濾鏡的使用取決於濾鏡套用到的物件:
- 若要將濾鏡套用至顯示物件,請使用
filters
屬性 (繼承自 DisplayObject)。 設定物件的filters
屬性不會修改該物件,而且只要清除filters
屬性就可以移除濾鏡。 - 若要將濾鏡套用至 BitmapData 物件,請使用
BitmapData.applyFilter()
方法。 對 BitmapData 物件呼叫applyFilter()
時會採用原始 BitmapData 物件和濾鏡物件,結果會產生套用濾鏡後的影像。
如果您將濾鏡套用至顯示物件,該顯示物件的 cacheAsBitmap
屬性就會設定為 true
。 如果您清除所有濾鏡,則會還原 cacheAsBitmap
的原始值。
這個濾鏡支援舞台縮放。但是,並不支援一般的縮放、旋轉和傾斜。 如果是縮放物件本身 (如果 scaleX
和 scaleY
設定為 1.0 以外的值),則不會縮放濾鏡。 濾鏡只在使用者在「舞台」上放大顯示時才會進行縮放。
如果產生的影像超過最大尺寸,系統就不會套用濾鏡。在 AIR 1.5 和 Flash Player 10 中,最大寬度或高度為 8,191 像素,而且像素總計不得超過 16,777,215 像素。(因此,如果影像寬度為 8,191 像素,則其高度上限為 2,048 像素)。若為 Flash Player 9 和 AIR 1.1 及其更早版本,高度和寬度的上限都是 2,880 像素。例如,當您在套用某個濾鏡的大型影片片段上進行放大顯示時,如果產生的影像超過最大尺寸,便會關閉該濾鏡。
相關 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
屬性 | 定義自 | ||
---|---|---|---|
alpha : Number
顏色的 Alpha 透明度值。 | GlowFilter | ||
blurX : Number
水平模糊化量。 | GlowFilter | ||
blurY : Number
垂直模糊化量。 | GlowFilter | ||
color : uint
光暈的顏色。 | GlowFilter | ||
constructor : Object
類別物件的參照或是特定物件實體的建構函數。 | Object | ||
inner : Boolean
指定光暈是否為內光暈。 | GlowFilter | ||
knockout : Boolean
指定物件是否具有去底色特效。 | GlowFilter | ||
quality : int
套用濾鏡的次數。 | GlowFilter | ||
strength : Number
壓印強度或範圍。 | GlowFilter |
方法 | 定義自 | ||
---|---|---|---|
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)
以指定的參數初始化新的 GlowFilter 實體。 | GlowFilter | ||
[覆寫]
傳回此濾鏡物件的副本。 | GlowFilter | ||
指出物件是否有已定義的指定屬性。 | Object | ||
指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。 | Object | ||
指出指定的屬性是否存在,以及是否可列舉。 | Object | ||
為迴圈作業設定動態屬性的可用性。 | Object | ||
傳回代表此物件的字串,根據地區特定慣例進行格式化。 | Object | ||
會傳回指定之物件的字串形式。 | Object | ||
會傳回指定之物件的基本值。 | Object |
alpha | 屬性 |
blurX | 屬性 |
blurY | 屬性 |
color | 屬性 |
inner | 屬性 |
knockout | 屬性 |
quality | 屬性 |
quality:int
語言版本: | ActionScript 3.0 |
執行階段版本: | AIR 1.0, Flash Player 9 |
套用濾鏡的次數。 預設值為 BitmapFilterQuality.LOW
(相當於套用一次濾鏡)。 BitmapFilterQuality.MEDIUM
值會套用兩次濾鏡,而 BitmapFilterQuality.HIGH
值會套用三次濾鏡。 設定值較低的濾鏡,其顯示速度較快。
對大部份應用程式而言,將 quality
值設為低、中或高就足夠了。 雖然您可以使用其他數值 (最高可至 15) 來達成不同的效果,但越高的值就代表越緩慢的顯示速度。 只要增加 blurX
和 blurY
屬性的值,通常就可以得到類似的效果和較快的顯示速度,而不需要增加 quality
的值。
實作
public function get quality():int
public function set quality(value:int):void
相關 API 元素
strength | 屬性 |
GlowFilter | () | 建構函式 |
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)
語言版本: | ActionScript 3.0 |
執行階段版本: | AIR 1.0, Flash Player 9 |
以指定的參數初始化新的 GlowFilter 實體。
參數color:uint (default = 0xFF0000 ) — 光暈的顏色,會以十六進位格式 0xRRGGBB 表示。 預設值為 0xFF0000。
| |
alpha:Number (default = 1.0 ) — 顏色的 Alpha 透明度值。 有效值為 0 到 1。 例如,.25 會設定 25% 的透明度值。
| |
blurX:Number (default = 6.0 ) — 水平模糊化量。 有效值為 0 到 255 (浮點)。 2 的冪次方數值 (如 2、4、8、16 和 32) 是經過最佳化的,以便在顯示時會比其他值更為快速。
| |
blurY:Number (default = 6.0 ) — 垂直模糊化量。 有效值為 0 到 255 (浮點)。 2 的冪次方數值 (如 2、4、8、16 和 32) 是經過最佳化的,以便在顯示時會比其他值更為快速。
| |
strength:Number (default = 2 ) — 壓印強度或範圍。 數值越高,便壓印越多顏色,光暈與背景之間的對比越強烈。 有效值為 0 到 255。
| |
quality:int (default = 1 ) — 套用濾鏡的次數。 請使用 BitmapFilterQuality 常數¡
如需詳細資訊,請參閱 | |
inner:Boolean (default = false ) — 指定光暈是否為內光暈。 true 值會指定內光暈。 false 值會指定外光暈 (也就是物件外緣周圍的光暈)。
| |
knockout:Boolean (default = false ) — 指定物件是否具有去底色特效。 true 值可以讓物件的填色透明,並顯露出文件的背景顏色。
|
相關 API 元素
clone | () | 方法 |
override public function clone():BitmapFilter
語言版本: | ActionScript 3.0 |
執行階段版本: | AIR 1.0, Flash Player 9 |
傳回此濾鏡物件的副本。
傳回值BitmapFilter — 新的 GlowFilter 實體,具有原始 GlowFilter 實體的所有屬性。
|
- 匯入所需的類別。
- 宣告用於
draw
方法的三個屬性,使用 Graphics 類別的方法 (透過 Sprite 的graphics
屬性存取) 來繪製橘色方形。 - 建立建構函數,以進行下列動作:
- 呼叫
draw
函數以建立矩形。 - 建立 BitmapFilter 物件
glowFilter
並為它指派getBitmapFilter()
函數的傳回值。 - 將
glowFilter
物件的傳回值陣列指派至根顯示物件的filters
屬性。在此情況下,根顯示物件的所有顯示物件子項將繼承光暈濾鏡屬性。因此,在draw()
函數中建立的矩形,將顯示光暈濾鏡屬性。
- 呼叫
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, 03:47 PM Z