GradientGlowFilter

Пакет	spark.filters
Класс	public class GradientGlowFilter
Наследование	GradientGlowFilter GradientFilter BaseDimensionFilter BaseFilter EventDispatcher Object
Реализует	IBitmapFilter

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 4

Версии среды выполнения:

Flash Player 10, AIR 1.5

Класс GradientGlowFilter позволяет применять эффект градиентного свечения к экранным объектам. Градиентное свечение — это реалистичное свечение с цветовым градиентом, которым можно управлять. Можно накладывать градиентное свечение по внутреннему или внешнему краю объекта или поверх объекта. Фильтр можно применять к любому экранному объекту (т.е. объекту, наследуемому от класса DisplayObject), например MovieClip, SimpleButton, TextField, Video, а также объектам BitmapData.

Выбор фильтра зависит от объекта, к которому требуется его применить:

Применить фильтр к экранным объектам можно с помощью свойства filters. При задании объекту свойства 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 expanded

Скрыть синтаксис MXML

The <s:GradientGlowFilter> tag inherits all of the tag attributes of its superclass and adds no tag attributes:

  <s:GradientGlowFilter/>

Свойство MXML по умолчаниюentries

Посмотреть примеры

Связанные элементы API

spark.filters.GlowFilter
flash.filters.GradientGlowFilter
flash.display.BitmapData.applyFilter()
flash.display.DisplayObject.cacheAsBitmap
flash.display.DisplayObject.filters

Общедоступные свойства

Скрыть унаследованные общедоступные свойства

Показать унаследованные общедоступные свойства

	Свойство		Определено
		angle : Number Угол в градусах.	GradientFilter
		blurX : Number Степень размытия по горизонтали.	BaseDimensionFilter
		blurY : Number Степень размытия по вертикали.	BaseDimensionFilter
		constructor : Object Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.	Object
		distance : Number Расстояние смещения свечения.	GradientFilter
		entries : Array Массив объектов GradientEntry, определяющий узор градиентной заливки.	GradientFilter
		knockout : Boolean Определяет, применяется ли к объекту эффект выбивки.	BaseDimensionFilter
		quality : int Заданное число применений фильтра.	BaseDimensionFilter
		strength : Number Степень вдавливания или нанесения.	BaseDimensionFilter
		type : String Расположение эффекта фильтра.	GradientFilter

Общедоступные методы

Скрыть унаследованные общедоступные методы

Показать унаследованные общедоступные методы

	Метод		Определено
		GradientGlowFilter(distance:Number = 4.0, angle:Number = 45, colors:Array = null, alphas:Array = null, ratios:Array = null, blurX:Number = 4.0, blurY:Number = 4.0, strength:Number = 1, quality:int = 1, type:String = "outer", knockout:Boolean = false) Конструктор.	GradientGlowFilter
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии.	EventDispatcher
		clone():BitmapFilter Возвращает копию данного объекта фильтра.	GradientGlowFilter
		dispatchEvent(event:Event):Boolean Посылает событие в поток событий.	EventDispatcher
		hasEventListener(type:String):Boolean Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события.	EventDispatcher
		hasOwnProperty(name:String):Boolean Показывает, определено ли заданное свойство для объекта.	Object
		isPrototypeOf(theClass:Object):Boolean Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.	Object
		notifyFilterChanged():void Передает событие изменения после изменения фильтра.	BaseFilter
		propertyIsEnumerable(name:String):Boolean Показывает наличие заданного свойства и его перечисляемость.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Удаляет прослушиватель из объекта EventDispatcher.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Задает доступность динамического свойства для операций цикла.	Object
		toLocaleString():String Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.	Object
		toString():String Возвращает строковое представление заданного объекта.	Object
		valueOf():Object Возвращает элементарное значение заданного объекта.	Object
		willTrigger(type:String):Boolean Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником.	EventDispatcher

События

Дополнительные сведения о событиях

Скрыть унаследованные события

Показать унаследованные события

	Событие		Сводка	Определено
		activate	[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным.	EventDispatcher
		deactivate	[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным.	EventDispatcher

Общедоступные константы

Скрыть унаследованные общедоступные константы

Показать унаследованные общедоступные константы

	Константа		Определено

Сведения о конструкторе

()

Конструктор

public function GradientGlowFilter(distance:Number = 4.0, angle:Number = 45, colors:Array = null, alphas:Array = null, ratios:Array = null, blurX:Number = 4.0, blurY:Number = 4.0, strength:Number = 1, quality:int = 1, type:String = "outer", knockout:Boolean = false)

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 4

Версии среды выполнения:

Flash Player 10, AIR 1.5

Конструктор.

Параметры

	`distance:Number` (default = `4.0`) — Расстояние смещения свечения.

	`angle:Number` (default = `45`) — Угол в градусах. Действительны значения от 0 до 360.

	`colors:Array` (default = `null`) — Массив цветов, задающий градиент. Например, красный задается значением 0xFF0000, голубой — значением 0x0000FF и т.д.

	`alphas:Array` (default = `null`) — Массив значений альфа-прозрачности для соответствующих цветов в массиве `colors`. Действительные значения для каждого из элементов массива — от 0 до 1. Например, при задании значения 0,25 устанавливается 25% альфа-прозрачность.

	`ratios:Array` (default = `null`) — Массив значений распределения цветов. Действительны значения от 0 до 255. Это значение определяет процент ширины, на которой цвет представлен на 100%.

	`blurX:Number` (default = `4.0`) — Степень размытия по горизонтали. Действительны значения от 0 до 255. Размытие со значением 1 или менее означает, что исходное изображение копируется как есть. Значения, являющиеся степенью 2 (т. е. 2, 4, 8, 16 и 32), оптимизируются и выполняются быстрее, чем остальные.

	`blurY:Number` (default = `4.0`) — Степень размытия по вертикали. Действительны значения от 0 до 255. Размытие со значением 1 или менее означает, что исходное изображение копируется как есть. Значения, являющиеся степенью 2 (т. е. 2, 4, 8, 16 и 32), оптимизируются и выполняются быстрее, чем остальные.

	`strength:Number` (default = `1`) — Степень вдавливания или нанесения. Чем выше значение, тем более насыщен цвет тени и тем сильнее контраст между свечением и фоном. Действительны значения от 0 до 255. Чем больше значение, тем более насыщен цвет. Значение 0 означает, что фильтр не применяется.

	`quality:int` (default = `1`) — Заданное число применений фильтра. Используйте константы flash.filters.BitmapFilterQuality: `BitmapFilterQuality.LOW` `BitmapFilterQuality.MEDIUM` `BitmapFilterQuality.HIGH` Подробные сведения см. в описании свойства `quality`.

	`type:String` (default = "`outer`") — Расположение эффекта фильтра. Возможными значениями являются константы flash.filters.BitmapFilterType: `BitmapFilterType.OUTER` — свечение по внешнему краю объекта.; по умолчанию. `BitmapFilterType.INNER` – свечение по внутреннему краю объекта. `BitmapFilterType.FULL` — свечение по всему объекту.

	`knockout:Boolean` (default = `false`) — Определяет, применяется ли к объекту эффект выбивки. Эффект выбивки делает заливку объекта прозрачной и выявляет цвет фона документа. Значение `true` указывает на наличие эффекта выбивки. По умолчанию задано значение `false` (без эффекта выбивки).

Сведения о методе

clone

()

метод

public function clone():BitmapFilter

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 4

Версии среды выполнения:

Flash Player 10, AIR 1.5

Возвращает копию данного объекта фильтра.

Возвращает

BitmapFilter — Новый экземпляр GradientGlowFilter с теми же свойствами, что и оригинальный экземпляр GradientGlowFilter.

Примеры Использование этого примера

GradientGlowFilterExample.mxml

<?xml version="1.0"?>
<!-- filters/examples/GradientGlowFilterExample .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 myGradientGlowFilter:GradientGlowFilter;  
     private var colors:Array = [0xFFFFFF, 0xFF0000, 0xFFFF00, 0x00CCFF];
     private var alphas:Array = [0, 1, 1, 1];  
     private var ratios:Array = [0, 63, 126, 255];
             
     public function createFilters():void {        
        myGradientGlowFilter = new GradientGlowFilter(0, 45, colors, alphas,
            ratios, 50, 50, 2.5, BitmapFilterQuality.HIGH, BitmapFilterType.OUTER, false);
        b1.filters = [myGradientGlowFilter];
     }
  
  ]]></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:GradientGlowFilter 
                    distance="10"
                    angle="45"
                    blurX="50" 
                    blurY="50" 
                    strength="2.5" 
                    quality="{BitmapFilterQuality.HIGH}"
                    type="{BitmapFilterType.OUTER}" 
                    knockout="false">
                        <s:entries>
                            <s:GradientEntry alpha="0" color="0xFFFFFF" ratio="0"/>
                            <s:GradientEntry alpha="1" color="0xFF0000" ratio="63"/>
                            <s:GradientEntry alpha="1" color="0xFFFF00" ratio="126"/>
                            <s:GradientEntry alpha="1" color="0x00CCFF" ratio="255"/>
                        </s:entries>
                 </s:GradientGlowFilter>
            </s:filters>
        </s:Button>
    </s:VGroup>        
</s:Application>

Юридическая информация | Политика конфиденциальности онлайн

GradientGlowFilter - AS3 Flex

Классы x

GradientGlowFilter

clone