Пакет | flash.filters |
Класс | public final class DropShadowFilter |
Наследование | DropShadowFilter ![]() ![]() |
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Выбор фильтра зависит от объекта, к которому требуется его применить:
- Применить фильтры к визуализируемым объектам можно с помощью свойства
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
Свойство | Определено | ||
---|---|---|---|
alpha : Number
Значение альфа-прозрачности для цвета тени. | DropShadowFilter | ||
angle : Number
Угол тени. | DropShadowFilter | ||
blurX : Number
Степень размытия по горизонтали. | DropShadowFilter | ||
blurY : Number
Степень размытия по вертикали. | DropShadowFilter | ||
color : uint
Цвет тени. | DropShadowFilter | ||
![]() | constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
distance : Number
Расстояние смещения для тени (в пикселях). | DropShadowFilter | ||
hideObject : Boolean
Определяет, является ли объект скрытым. | DropShadowFilter | ||
inner : Boolean
Определяет, является ли тень внутренней тенью. | DropShadowFilter | ||
knockout : Boolean
Применяет эффект выбивки (true), который фактически делает заливку объекта прозрачной и выявляет цвет фона документа. | DropShadowFilter | ||
quality : int
Заданное число применений фильтра. | DropShadowFilter | ||
strength : Number
Степень вдавливания или нанесения. | DropShadowFilter |
Метод | Определено | ||
---|---|---|---|
DropShadowFilter(distance:Number = 4.0, angle:Number = 45, color:uint = 0, alpha:Number = 1.0, blurX:Number = 4.0, blurY:Number = 4.0, strength:Number = 1.0, quality:int = 1, inner:Boolean = false, knockout:Boolean = false, hideObject:Boolean = false)
Инициализирует новый экземпляр DropShadowFilter с заданными параметрами. | DropShadowFilter | ||
[переопределить]
Возвращает копию данного объекта фильтра. | DropShadowFilter | ||
![]() |
Показывает, определено ли заданное свойство для объекта. | Object | |
![]() |
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
![]() |
Показывает наличие заданного свойства и его перечисляемость. | Object | |
![]() |
Задает доступность динамического свойства для операций цикла. | Object | |
![]() |
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
![]() |
Возвращает строковое представление заданного объекта. | Object | |
![]() |
Возвращает элементарное значение заданного объекта. | Object |
alpha | свойство |
alpha:Number
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Значение альфа-прозрачности для цвета тени. Действительны значения от 0,0 до 1,0. Например, при 0,25 устанавливается 25-процентная прозрачность. По умолчанию используется значение 1.0.
Реализация
public function get alpha():Number
public function set alpha(value:Number):void
angle | свойство |
blurX | свойство |
blurX:Number
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Степень размытия по горизонтали. Действительны значения от 0 до 255,0 (плавающая запятая). Значением по умолчанию является 4,0.
Реализация
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,0 (плавающая запятая). Значением по умолчанию является 4,0.
Реализация
public function get blurY():Number
public function set blurY(value:Number):void
color | свойство |
distance | свойство |
hideObject | свойство |
hideObject:Boolean
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Определяет, является ли объект скрытым. Значение true
указывает на то, что сам объект не нарисован, видна только его тень. Значение по умолчанию — false
(объект отображается).
Реализация
public function get hideObject():Boolean
public function set hideObject(value:Boolean):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
— трижды. Фильтры с более низкими значениями выполняются быстрее.
Для большинства приложений достаточно значений качества 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,0. По умолчанию — 1,0.
Реализация
public function get strength():Number
public function set strength(value:Number):void
DropShadowFilter | () | Конструктор |
public function DropShadowFilter(distance:Number = 4.0, angle:Number = 45, color:uint = 0, alpha:Number = 1.0, blurX:Number = 4.0, blurY:Number = 4.0, strength:Number = 1.0, quality:int = 1, inner:Boolean = false, knockout:Boolean = false, hideObject:Boolean = false)
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Инициализирует новый экземпляр DropShadowFilter с заданными параметрами.
Параметрыdistance:Number (default = 4.0 ) — Расстояние смещения для тени (в пикселях).
| |
angle:Number (default = 45 ) — Угол падения тени, от 0 до 360 (плавающая запятая).
| |
color:uint (default = 0 ) — Цвет тени в шестнадцатеричном формате 0xRRGGBB. Значение по умолчанию равно 0x000000.
| |
alpha:Number (default = 1.0 ) — Значение альфа-прозрачности для цвета тени. Действительны значения от 0.0 до 1.0. Например, при 0,25 устанавливается 25-процентная прозрачность.
| |
blurX:Number (default = 4.0 ) — Степень размытия по горизонтали. Действительны значения от 0 до 255,0 (плавающая запятая).
| |
blurY:Number (default = 4.0 ) — Степень размытия по вертикали. Действительны значения от 0 до 255,0 (плавающая запятая).
| |
strength:Number (default = 1.0 ) — Степень вдавливания или нанесения. Чем выше значение, тем более насыщен цвет тени и тем сильнее контраст между тенью и фоном. Действительны значения от 0 до 255,0.
| |
quality:int (default = 1 ) — Заданное число применений фильтра. Используйте константы BitmapFilterQuality:
Дополнительные сведения об этих значениях см. в описании свойства | |
inner:Boolean (default = false ) — Определяет, является ли тень внутренней тенью. Значение true задает внутреннюю тень. Значение false задает внешнюю тень (тень вокруг внешнего контура объекта).
| |
knockout:Boolean (default = false ) — Применяет эффект выбивки (true ), который фактически делает заливку объекта прозрачной и выявляет цвет фона документа.
| |
hideObject:Boolean (default = false ) — Определяет, является ли объект скрытым. Значение true указывает на то, что сам объект не нарисован, видна только его день.
|
Связанные элементы API
clone | () | метод |
override public function clone():BitmapFilter
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Возвращает копию данного объекта фильтра.
ВозвращаетBitmapFilter — Новый экземпляр DropShadowFilter со всеми свойствами оригинального экземпляра DropShadowFilter.
|
- Задаются три свойства, которые используются для отрисовки квадрата, к которому применяется фильтр.
- Создается функция конструктора. Конструктор вызывает метод
draw()
, использующий методы класса Graphics, полученные через свойствоgraphics
спрайта для рисования оранжевого квадрата. - В конструкторе задается переменная
filter
в виде объекта BitmapFilter и назначается возвращаемому значению вызова методаgetBitmapFilter()
. МетодgetBitmapFilter()
определяет используемый фильтр теней. - Создается новый объект массива
myFilters
, и к массиву добавляется фильтрfilter
. МассивmyFilters
назначается свойствуfilters
объекта DropShadowFilterExample. В результате применяются все фильтры, обнаруженные в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.DropShadowFilter; public class DropShadowFilterExample extends Sprite { private var bgColor:uint = 0xFFCC00; private var size:uint = 80; private var offset:uint = 50; public function DropShadowFilterExample() { draw(); var filter:BitmapFilter = getBitmapFilter(); var myFilters:Array = new Array(); myFilters.push(filter); filters = myFilters; } private function getBitmapFilter():BitmapFilter { var color:Number = 0x000000; var angle:Number = 45; var alpha:Number = 0.8; var blurX:Number = 8; var blurY:Number = 8; var distance:Number = 15; var strength:Number = 0.65; var inner:Boolean = false; var knockout:Boolean = false; var quality:Number = BitmapFilterQuality.HIGH; return new DropShadowFilter(distance, angle, 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