| Пакет | spark.filters |
| Класс | public class DropShadowFilter |
| Наследование | DropShadowFilter  BaseDimensionFilter BaseFilter EventDispatcher Object |
| Реализует | IBitmapFilter |
| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Выбор фильтра зависит от объекта, к которому требуется его применить:
- Применить фильтры к визуализируемым объектам можно с помощью свойства
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 пикселей.) Например, при масштабировании большого фрагмента ролика, к которому применен фильтр, фильтр будет снят, если получившееся изображение превысит максимальные размеры.
Синтаксис MXML
Показать синтаксис MXML
Скрыть синтаксис MXMLThe <s:DropShadowFilter> tag inherits all of the tag
attributes of its superclass and adds the following tag attributes:
<s:DropShadowFilter
Properties
alpha="1"
angle="45"
color="0xFF0000"
distance="4"
hideObject="false"
inner="false"
/>
Связанные элементы API
| Свойство | Определено | ||
|---|---|---|---|
| alpha : Number
Значение альфа-прозрачности цвета. | DropShadowFilter | ||
| angle : Number
Угол наклона. | DropShadowFilter | ||
 | blurX : Number
Степень размытия по горизонтали. | BaseDimensionFilter | |
| blurY : Number
Степень размытия по вертикали. | BaseDimensionFilter | |
| color : uint
Цвет свечения. | DropShadowFilter | ||
| constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| distance : Number
Расстояние смещения наклона. | DropShadowFilter | ||
| hideObject : Boolean
Определяет, является ли объект скрытым. | DropShadowFilter | ||
| inner : Boolean
Определяет, является ли свечение внутренним свечением. | DropShadowFilter | ||
| knockout : Boolean
Определяет, применяется ли к объекту эффект выбивки. | BaseDimensionFilter | |
| quality : int
Заданное число применений фильтра. | BaseDimensionFilter | |
| strength : Number
Степень вдавливания или нанесения. | BaseDimensionFilter | |
| Метод | Определено | ||
|---|---|---|---|
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 | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. | EventDispatcher | |
Возвращает копию данного объекта фильтра. | DropShadowFilter | ||
|
Посылает событие в поток событий. | EventDispatcher | |
|
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. | EventDispatcher | |
|
Показывает, определено ли заданное свойство для объекта. | Object | |
|
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
|
Передает событие изменения после изменения фильтра. | BaseFilter | |
|
Показывает наличие заданного свойства и его перечисляемость. | Object | |
|
Удаляет прослушиватель из объекта EventDispatcher. | EventDispatcher | |
|
Задает доступность динамического свойства для операций цикла. | Object | |
|
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
|
Возвращает строковое представление заданного объекта. | Object | |
|
Возвращает элементарное значение заданного объекта. | Object | |
|
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | EventDispatcher | |
alpha | свойство |
alpha:Number| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Значение альфа-прозрачности цвета. Действительны значения от 0 до 1. Например, при 0,25 устанавливается 25-процентная прозрачность.
Значением по умолчанию является 1.
Реализация
public function get alpha():Number public function set alpha(value:Number):voidangle | свойство |
angle:Number| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Угол наклона. Действительны значения от 0 до 360°. Значение угла представляет угол, под которым падает свет из предполагаемого источника, и определяет расположение эффекта относительно объекта. Если свойство distance имеет значение 0, эффект не смещается относительно объекта и, следовательно, свойство angle никак не влияет на результат.
Значением по умолчанию является 45.
Реализация
public function get angle():Number public function set angle(value:Number):voidcolor | свойство |
color:uint| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Цвет свечения. Действительны значения в шестнадцатеричном формате 0xRRGGBB.
Значением по умолчанию является 0xFF0000.
Реализация
public function get color():uint public function set color(value:uint):voiddistance | свойство |
distance:Number| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Расстояние смещения наклона. Действительные значения заданы в пикселях (плавающая точка).
Значением по умолчанию является 4.
Реализация
public function get distance():Number public function set distance(value:Number):voidhideObject | свойство |
hideObject:Boolean| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Определяет, является ли объект скрытым. Значение true указывает на то, что сам объект не нарисован, видна только его тень. Значение по умолчанию – false, что предполагает отображение объекта.
Значением по умолчанию является false.
Реализация
public function get hideObject():Boolean public function set hideObject(value:Boolean):voidinner | свойство |
inner:Boolean| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Определяет, является ли свечение внутренним свечением. Значение true говорит о том, что свечение внутреннее. Значением по умолчанию является false, что предполагает внешнее свечение (свечение вокруг внешнего контура объекта).
Значением по умолчанию является false.
Реализация
public function get inner():Boolean public function set inner(value:Boolean):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 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Конструктор.
Параметрыdistance:Number (default = 4.0) | |
angle:Number (default = 45) | |
color:uint (default = 0) | |
alpha:Number (default = 1.0) | |
blurX:Number (default = 4.0) | |
blurY:Number (default = 4.0) | |
strength:Number (default = 1.0) | |
quality:int (default = 1)
Дополнительные сведения об этих значениях см. в описании свойства | |
inner:Boolean (default = false)true задает внутреннюю тень. Значение false задает внешнюю тень (тень вокруг внешнего контура объекта).
| |
knockout:Boolean (default = false)true), который фактически делает заливку объекта прозрачной и выявляет цвет фона документа.
| |
hideObject:Boolean (default = false)true указывает на то, что сам объект не нарисован, видна только его день.
|
Связанные элементы API
clone | () | метод |
public function clone():BitmapFilter| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Возвращает копию данного объекта фильтра.
ВозвращаетBitmapFilter — Новый экземпляр DropShadowFilter со всеми свойствами оригинального экземпляра DropShadowFilter.
|
<?xml version="1.0"?>
<!-- filters/examples/DropShadowFilterExample.mxml -->
<s:Application
xmlns:fx="http://ns.adobe.com/mxml/2009"
xmlns:mx="library://ns.adobe.com/flex/mx"
xmlns:s="library://ns.adobe.com/flex/spark"
creationComplete="createFilters()">
<fx:Script><![CDATA[
import spark.filters.*;
import flash.filters.BitmapFilterQuality;
import flash.filters.BitmapFilterType;
private var myDropShadowFilter:DropShadowFilter;
private var color:Number = 0xFF33FF;
public function createFilters():void {
myDropShadowFilter = new DropShadowFilter(15, 45,
color, 0.8, 8, 8, 0.65, BitmapFilterQuality.MEDIUM, false, false);
b1.filters = [myDropShadowFilter];
}
]]></fx:Script>
<s:VGroup>
<!-- This button has a filter applied in ActionScript. -->
<s:Button id="b1" label="Click me"/>
<!-- This button has a filter applied in MXML. -->
<s:Button id="b2" label="Click me">
<s:filters>
<s:DropShadowFilter
distance="15"
angle="45"
color="0xFF33FF"
alpha=".8"
blurX="8"
blurY="8"
strength=".65"
quality="{BitmapFilterQuality.MEDIUM}"
inner="false"
knockout="false"/>
</s:filters>
</s:Button>
</s:VGroup>
</s:Application>
Tue Jun 12 2018, 11:34 AM Z