Пакет | flash.filters |
Класс | public final class GlowFilter |
Наследование | GlowFilter ![]() ![]() |
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
distance
и angle
присвоено значение 0. Фильтр можно применять к любому визуализируемому объекту (т.е. объекту, наследуемому от класса DisplayObject), например MovieClip, SimpleButton, TextField, Video, а также объектам BitmapData.
Выбор фильтра зависит от объекта, к которому требуется его применить:
filters
(наследуется от DisplayObject). При задании объекту свойства filters
сам объект не модифицируется, а фильтр можно удалить через свойство filters
. BitmapData.applyFilter()
. При вызове applyFilter()
для объекта BitmapData из исходного объекта BitmapData и объекта фильтра формируется изображение с применением фильтра.При применении фильтра к визуализируемому объекту свойство cacheAsBitmap
этого объекта принимает значение true
. Если удалить все фильтры, будет восстановлено исходное значение cacheAsBitmap
.
Этот фильтр поддерживает масштабирование сцены. Тем не менее, он не поддерживает общее масштабирование, повороты и искажение. Если сам объект увеличен или уменьшен (т.е. если свойства scaleX
и scaleY
принимают значение, отличное от 1,0), фильтр не масштабируется. Он масштабируется, только когда пользователь применяет увеличение к самой сцене.
Невозможно применить фильтр к изображениям, если их получившаяся длина или ширина превышает 2880 пикселов. Например, при масштабировании большого фрагмента ролика, к которому применен фильтр, фильтр будет снят, если получившееся изображение достигнет предела 2880 пикселов в длину или в ширину.
См. также
Свойство | Определено | ||
---|---|---|---|
alpha : Number
Значение альфа-прозрачности цвета. | GlowFilter | ||
blurX : Number
Степень размытия по горизонтали. | GlowFilter | ||
blurY : Number
Степень размытия по вертикали. | GlowFilter | ||
color : uint
Цвет свечения. | GlowFilter | ||
![]() | constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
inner : Boolean
Определяет, является ли свечение внутренним свечением. | GlowFilter | ||
knockout : Boolean
Определяет, применяется ли к объекту эффект выбивки. | GlowFilter | ||
![]() | prototype : Object [статические]
Ссылка на модель объекта класса или функции. | Object | |
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 |
alpha | свойство |
alpha:Number
[чтение и запись] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Значение альфа-прозрачности цвета. Действительны значения от 0 до 1. Например, при 0,25 устанавливается 25-процентная прозрачность. Значение по умолчанию 1.
public function get alpha():Number
public function set alpha(value:Number):void
blurX | свойство |
blurX:Number
[чтение и запись] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Степень размытия по горизонтали. Действительны значения от 0 до 255 (плавающая точка). Значение по умолчанию 6. Значения, являющиеся степенью 2 (т.е. 2, 4, 8, 16 и 32), оптимизируются и выполняются быстрее, чем остальные.
public function get blurX():Number
public function set blurX(value:Number):void
blurY | свойство |
blurY:Number
[чтение и запись] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Степень размытия по вертикали. Действительны значения от 0 до 255 (плавающая точка). Значение по умолчанию 6. Значения, являющиеся степенью 2 (т.е. 2, 4, 8, 16 и 32), оптимизируются и выполняются быстрее, чем остальные.
public function get blurY():Number
public function set blurY(value:Number):void
color | свойство |
color:uint
[чтение и запись] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Цвет свечения. Действительны значения в шестнадцатеричном формате 0xRRGGBB. Значение по умолчанию — 0xFF0000.
public function get color():uint
public function set color(value:uint):void
inner | свойство |
inner:Boolean
[чтение и запись] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Определяет, является ли свечение внутренним свечением. Значение true
говорит о том, что свечение внутреннее. Значение false
задает внешнее свечение (свечение вокруг внешнего контура объекта).
public function get inner():Boolean
public function set inner(value:Boolean):void
knockout | свойство |
knockout:Boolean
[чтение и запись] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Определяет, применяется ли к объекту эффект выбивки. Значение true
делает заливку объекта прозрачной и делает видимым цвет фона документа. Значение по умолчанию — false
(без эффекта выбивки).
public function get knockout():Boolean
public function set knockout(value:Boolean):void
quality | свойство |
quality:int
[чтение и запись] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Заданное число применений фильтра. Значение по умолчанию — BitmapFilterQuality.LOW
, что эквивалентно однократному применению фильтра. Значение BitmapFilterQuality.MEDIUM
применяет фильтр дважды; значение BitmapFilterQuality.HIGH
— трижды. Фильтры с более низкими значениями выполняются быстрее.
Для большинства приложений достаточно значения quality
на уровне "low" ("низкое"), "medium" ("среднее") или "high" (высокое). Хотя можно использовать дополнительные числовые значения до 15 для получения разнообразных эффектов, более высокие значения выполняются дольше. Вместо увеличения значения quality
можно просто увеличить значения свойств blurX
и blurY
. Это даст похожий эффект, а выполнение будет происходить быстрее.
public function get quality():int
public function set quality(value:int):void
См. также
strength | свойство |
strength:Number
[чтение и запись] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Степень вдавливания или растискивания. Чем выше значение, тем более насыщен цвет тени и тем сильнее контраст между свечением и фоном. Действительны значения от 0 до 255. Значение по умолчанию равно 2.
public function get strength():Number
public function set strength(value:Number):void
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 ) — Значение альфа-прозрачности цвета. Действительны значения от 0 до 1. Например, при 0,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 делает заливку объекта прозрачной и делает видимым цвет фона документа.
|
См. также
clone | () | метод |
override public function clone():BitmapFilter
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Возвращает копию данного объекта фильтра.
ВозвращаетBitmapFilter — Новый экземпляр GlowFilter со всеми свойствами оригинального экземпляра GlowFilter.
|
draw()
, который использует методы класса Graphics, полученные через свойство graphics
спрайта для рисования оранжевого квадрата.draw
.filter
и назначает ему возвращаемое значение вызова getBitmapFilter()
, определяющего фильтр.myFilters
и добавляет к нему filter
. myFilters
свойству filters
объекта BevelFilterExample. В результате применяются все фильтры, обнаруженные в myFilters
. В нашем случае это только один фильтр filter
.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(); var filter:BitmapFilter = getBitmapFilter(); var myFilters:Array = new Array(); myFilters.push(filter); filters = myFilters; } 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(); } } }