Пакет | 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()
. При вызовеapplyFilter()
для объекта BitmapData из исходного объекта 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 пикселей в высоту и 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
Значение альфа-прозрачности цвета. | 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 | свойство |
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 | свойство |
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
Связанные элементы API
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 делает заливку объекта прозрачной и делает видимым цвет фона документа.
|
Связанные элементы API
clone | () | метод |
override public function clone():BitmapFilter
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Возвращает копию данного объекта фильтра.
ВозвращаетBitmapFilter — Новый экземпляр GlowFilter со всеми свойствами оригинального экземпляра GlowFilter.
|
- Импортируется требуемый класс.
- Объявляются три свойства метода
draw
, который использует методы класса Graphics, полученные через свойство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, 11:34 AM Z