| Пакет | flash.filters |
| Класс | public final class DropShadowFilter |
| Наследование | DropShadowFilter BitmapFilter Object |
| Язык версии: | 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):voidangle | свойство |
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):voidblurY | свойство |
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):voidcolor | свойство |
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):voidinner | свойство |
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 — трижды. Фильтры с более низкими значениями выполняются быстрее.
Для большинства приложений достаточно значений качества 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):voidDropShadowFilter | () | Конструктор |
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
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойства