| Пакет | 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):voidblurX | свойство |
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):voidblurY | свойство |
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):voidcolor | свойство |
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):voidknockout | свойство |
knockout:Boolean| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Определяет, применяется ли к объекту эффект выбивки. Значение true делает заливку объекта прозрачной и делает видимым цвет фона документа. Значение по умолчанию — false (без эффекта выбивки).
Реализация
public function get knockout():Boolean public function set knockout(value:Boolean):voidquality | свойство |
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):voidGlowFilter | () | Конструктор |
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
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойства