| Пакет | spark.filters |
| Класс | public class GlowFilter |
| Наследование | GlowFilter  BaseDimensionFilter BaseFilter EventDispatcher Object |
| Реализует | IBitmapFilter |
| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
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 пикселей.) Например, при масштабировании большого фрагмента ролика, к которому применен фильтр, фильтр будет снят, если получившееся изображение превысит максимальные размеры.
Синтаксис MXML
Показать синтаксис MXML
Скрыть синтаксис MXMLThe <s:GlowFilter> tag inherits all of the tag
attributes of its superclass and adds the following tag attributes:
<s:GlowFilter
Properties
alpha="1"
color="0xFF0000"
inner="false"
/>
Связанные элементы API
flash.display.BitmapData.applyFilter()
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
Степень размытия по горизонтали. | BaseDimensionFilter | |
| blurY : Number
Степень размытия по вертикали. | BaseDimensionFilter | |
| color : uint
Цвет свечения. | GlowFilter | ||
| constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| inner : Boolean
Определяет, является ли свечение внутренним свечением. | GlowFilter | ||
| knockout : Boolean
Определяет, применяется ли к объекту эффект выбивки. | BaseDimensionFilter | |
| quality : int
Заданное число применений фильтра. | BaseDimensionFilter | |
| strength : Number
Степень вдавливания или нанесения. | BaseDimensionFilter | |
| Метод | Определено | ||
|---|---|---|---|
GlowFilter(color:uint = 0xFF0000, alpha:Number = 1.0, blurX:Number = 4.0, blurY:Number = 4.0, strength:Number = 1, quality:int = 1, inner:Boolean = false, knockout:Boolean = false)
Конструктор. | GlowFilter | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. | EventDispatcher | |
Возвращает копию данного объекта фильтра. | GlowFilter | ||
|
Посылает событие в поток событий. | 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):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):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):voidGlowFilter | () | Конструктор |
public function GlowFilter(color:uint = 0xFF0000, alpha:Number = 1.0, blurX:Number = 4.0, blurY:Number = 4.0, strength:Number = 1, quality:int = 1, inner:Boolean = false, knockout:Boolean = false)| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Конструктор.
Параметрыcolor:uint (default = 0xFF0000) | |
alpha:Number (default = 1.0) | |
blurX:Number (default = 4.0) | |
blurY:Number (default = 4.0) | |
strength:Number (default = 1) | |
quality:int (default = 1)
Подробные сведения см. в описании свойства | |
inner:Boolean (default = false) true говорит о том, что свечение внутреннее. Значение false задает внешнее свечение (свечение вокруг внешнего контура объекта).
| |
knockout:Boolean (default = false)true делает заливку объекта прозрачной и делает видимым цвет фона документа.
|
Связанные элементы API
clone | () | метод |
public function clone():BitmapFilter| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Возвращает копию данного объекта фильтра.
ВозвращаетBitmapFilter — Новый экземпляр GlowFilter со всеми свойствами оригинального экземпляра GlowFilter.
|
<?xml version="1.0"?>
<!-- filters/examples/GlowFilterExample .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 myGlowFilter:GlowFilter;
private var color:Number = 0xFF33FF;
public function createFilters():void {
myGlowFilter = new GlowFilter(color, .8, 6, 6, .65, BitmapFilterQuality.MEDIUM,
false, false);
b1.filters = [myGlowFilter];
}
]]></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:GlowFilter
color="0xFF33FF"
alpha=".8"
blurX="6"
blurY="6"
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