AnimateFilter

Пакет	spark.effects
Класс	public class AnimateFilter
Наследование	AnimateFilter Animate Effect EventDispatcher Object

Язык версии:

ActionScript 3.0

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

Flex 4

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

Flash Player 10, AIR 1.5

Эффект AnimateFilter применяет экземпляр mx.filters.IBitmapFilter к целевому объекту и позволяет анимировать свойства фильтра между значениями. В отличие от эффектов, которое анимируют свойства целевого объекта, эффект AnimateFilter анимирует свойства фильтра, примененного к целевому объекту.

Фильтры, к которым применим этот эффект, определены в пакете . Общие фильтры включают DropShadowFilter, GlowFilter, BlurFilter и ShaderFilter.

Для определения свойств фильтра, подлежащих анимации, необходимо передать массив объектов SimpleMotionPath свойству motionPath эффекта AnimateFilter. Каждый объект SimpleMotionPath определяет свойство в фильтре, начальное значение свойства и конечное значение свойства.

Синтаксис MXML expanded

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

The <s:AnimateFilter> tag inherits all of the tag attributes of its superclass, and adds the following tag attributes:

  <s:AnimateFilter
    Properties
    id="ID"
    bitmapFilter="no default"
  />

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

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

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

spark.effects.supportClasses.AnimateFilterInstance

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

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

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

	Свойство		Определено
		bitmapFilter : IBitmapFilter Применяемый и подлежащий анимации экземпляр IBitmapFilter.	AnimateFilter
		className : String [только для чтения] Имя класса эффекта, например Fade.	Effect
		constructor : Object Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.	Object
		customFilter : mx.effects:EffectTargetFilter Указывает пользовательский объект фильтра типа EffectTargetFilter, используемый эффектом для определения целевых объектов, для которых должен воспроизводиться эффект.	Effect
		disableLayout : Boolean Если значение равно true, эффект отключает макет на вышестоящих контейнерах его целевых объектов, устанавливая для свойства autoLayout контейнеров значение false, а также отключает любые ограничения макета на целевые объекты.	Animate
		duration : Number Продолжительность эффекта в миллисекундах.	Effect
		easer : IEaser Реакция замедления для этого эффекта.	Animate
		effectTargetHost : mx.effects:IEffectTargetHost Свойства, позволяющие получить доступ к целевому элементу управления на основе списка для эффекта данных.	Effect
		filter : String Указывает алгоритм фильтрации целевых объектов для эффекта.	Effect
		hideFocusRing : Boolean Определяет, должен ли эффект скрыть кольцо фокуса при запуске.	Effect
		instanceClass : Class Объект типа Class, указывающий класс класса экземпляра эффекта для данного класса эффекта.	Effect
		interpolator : IInterpolator Для вычисления значений между начальными и конечными значениями свойства данным эффектом используется интерполятор.	Animate
		isPlaying : Boolean [только для чтения] Флаг только для чтения, принимающий значение true, если какой-либо экземпляр эффекта воспроизводится в настоящее время, и false в противном случае.	Effect
		motionPaths : Vector.<MotionPath> Вектор объектов MotionPath, каждый из которых содержит имя подлежащего анимации свойства и значения, которые данное свойство принимает в процессе анимации.	Animate
		perElementOffset : Number Дополнительная задержка (в миллисекундах) для целевых объектов эффекта, обрабатываемых после первого целевого объекта эффекта.	Effect
		playheadTime : Number Текущая позиция эффекта.	Effect
		relevantProperties : Array Массив имен свойств, используемых при выполнении фильтрации.	Effect
		relevantStyles : Array Массив имен стилей, используемых при выполнении фильтрации.	Effect
		repeatBehavior : String Поведение повторяющегося эффекта, то есть эффекта со значением repeatCount, равным 0 или > 1.	Animate
		repeatCount : int = 1 Число повторов эффекта.	Effect
		repeatDelay : int = 0 Время ожидания (в миллисекундах) перед повторением эффекта.	Effect
		startDelay : int = 0 Время ожидания (в миллисекундах) перед запуском эффекта.	Effect
		target : Object Объект, к которому применяется данный эффект.	Effect
		targets : Array Массив объектов, являющихся целевыми объектами эффекта.	Effect
		triggerEvent : Event Объект Event, переданный в Effect с помощью EffectManager при запуске эффекта, или null, если эффект воспроизводится без EffectManager.	Effect

Защищенные свойства

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

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

	Свойство		Определено
		applyTransitionEndProperties : Boolean Этот флаг указывает, должен ли эффект, воспроизводящийся при переходе, автоматически применить значения свойств, соответствующие конечному состоянию, или сохранить значения, установленные самим эффектом.	Effect
		endValuesCaptured : Boolean = false Флаг, содержащий значение true, если конечные значения эффекта уже определены, или значение false, если они должны быть получены из текущих свойств целевых объектов эффекта при воспроизведении эффекта.	Effect

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

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

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

	Метод		Определено
		AnimateFilter(target:Object = null, filter:IBitmapFilter = null) Конструктор.	AnimateFilter
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии.	EventDispatcher
		captureEndValues():void Обеспечивает сбор текущих значений соответствующих свойств целевых объектов эффекта и сохраняет их как конечные значения.	Effect
		captureMoreStartValues(targets:Array):void Обеспечивает сбор текущих значений соответствующих свойств дополнительного набора целевых объектов. Flex использует эту функцию при воспроизведении эффекта изменения данных.	Effect
		captureStartValues():void Обеспечивает сбор текущих значений соответствующих свойств для целевых объектов эффекта.	Effect
		createInstance(target:Object = null):IEffectInstance Создает отдельный экземпляр эффекта и инициализирует его.	Effect
		createInstances(targets:Array = null):Array Принимает массив целевых объектов и вызывает метод createInstance() для каждой цели.	Effect
		deleteInstance(instance:IEffectInstance):void Удаляет прослушиватели событий из экземпляра и удаляет экземпляр из списка экземпляров.	Effect
		dispatchEvent(event:Event):Boolean Посылает событие в поток событий.	EventDispatcher
		end(effectInstance:IEffectInstance = null):void Прерывает эффект, воспроизводящийся в настоящее время, и осуществляет немедленный переход в конец эффекта.	Effect
		getAffectedProperties():Array Возвращает массив строк, где каждая строка представляет собой имя свойства, которое было изменено данным эффектом.	Effect
		hasEventListener(type:String):Boolean Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события.	EventDispatcher
		hasOwnProperty(name:String):Boolean Показывает, определено ли заданное свойство для объекта.	Object
		isPrototypeOf(theClass:Object):Boolean Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.	Object
		pause():void Приостанавливает эффект до вызова метода resume().	Effect
		play(targets:Array = null, playReversedFromEnd:Boolean = false):Array Начинает воспроизведение эффекта	Effect
		propertyIsEnumerable(name:String):Boolean Показывает наличие заданного свойства и его перечисляемость.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Удаляет прослушиватель из объекта EventDispatcher.	EventDispatcher
		resume():void Продолжает воспроизведение эффекта после установки паузы путем вызова метода pause().	Effect
		reverse():void Если эффект воспроизводится в настоящее время, воспроизводит эффект в обратном порядке, начиная с текущей позиции эффекта.	Effect
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Задает доступность динамического свойства для операций цикла.	Object
		stop():void Останавливает эффект, оставляя целевые объекты эффекта в текущем состоянии.	Effect
		toLocaleString():String Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.	Object
		toString():String Возвращает строковое представление заданного объекта.	Object
		valueOf():Object Возвращает элементарное значение заданного объекта.	Object
		willTrigger(type:String):Boolean Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником.	EventDispatcher

Защищенные методы

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

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

	Метод		Определено
		applyValueToTarget(target:Object, property:String, value:*, props:Object):void Используется внутренне инфраструктурой Effect.	Effect
		effectEndHandler(event:EffectEvent):void Вызывается по завершении воспроизведения экземпляра эффекта.	Effect
		effectStartHandler(event:EffectEvent):void Этот метод вызывается в момент начала воспроизведения эффекта.	Effect
		effectStopHandler(event:EffectEvent):void Вызывается при остановке воспроизведения экземпляра эффекта посредством вызова метода stop().	Effect
		filterInstance(propChanges:Array, target:Object):Boolean Определяет логику фильтрации экземпляра эффекта.	Effect
		getValueFromTarget(target:Object, property:String):* Вызывается методом captureStartValues() для получения значения свойства целевого объекта.	Effect
		initInstance(instance:IEffectInstance):void Свойства копий эффекта для экземпляра эффекта.	Effect

События

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

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

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

	Сводка	Определено
activate	[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным.	EventDispatcher
deactivate	[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным.	EventDispatcher
effectEnd	Отправляется в момент завершения воспроизведения экземпляра эффекта, по завершении воспроизведения экземпляра или при прерывании воспроизведения эффекта посредством вызова метода end().	Effect
effectRepeat	Передается для каждого эффекта, повторяемого более одного раза, при его новом повторении.	Animate
effectStart	Отправляется в момент начала воспроизведения эффекта.	Effect
effectStop	Отправляется в момент прекращения воспроизведения эффекта, что происходит только в том случае, если воспроизведение эффекта было прервано посредством вызова метода stop().	Effect
effectUpdate	Передается при каждом обновлении целевого объекта эффектом.	Animate

Сведения о свойстве

bitmapFilter

свойство

public var bitmapFilter:IBitmapFilter

Язык версии:

ActionScript 3.0

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

Flex 4

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

Flash Player 10, AIR 1.5

Применяемый и подлежащий анимации экземпляр IBitmapFilter.

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

()

Конструктор

public function AnimateFilter(target:Object = null, filter:IBitmapFilter = null)

Язык версии:

ActionScript 3.0

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

Flex 4

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

Flash Player 10, AIR 1.5

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

Параметры

	`target:Object` (default = `null`) — Объект, анимируемый с использованием данного эффекта.

	`filter:IBitmapFilter` (default = `null`) — Фильтр, применяемый для целевого объекта. Фильтры, к которым применим этот эффект, определены в пакете spark.filters.

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

AnimateFilterEffectExample.mxml

<?xml version="1.0"?>
<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">

    <fx:Declarations>    
        <s:DropShadowFilter id="myDSF"
            color="0x0000FF"
            distance="5"
            angle="315"/>

        <s:AnimateFilter id="myFilter" 
            target="{myB2}"
            repeatCount="0"
            duration="500"
            repeatBehavior="reverse"
            bitmapFilter="{new spark.filters.DropShadowFilter()}">
            <s:SimpleMotionPath property="color" valueFrom="0" valueTo="0x0000FF"/>
            <s:SimpleMotionPath property="distance" valueFrom="0" valueTo="10"/>
            <s:SimpleMotionPath property="angle" valueFrom="270" valueTo="360"/>
        </s:AnimateFilter>
    </fx:Declarations>
 
    <s:Panel title="Animate Filter Effect Example"
        width="75%" height="75%">

        <s:Button id="myB1" 
            x="50" y="50" 
            label="Show a DropShadowFilter" 
            filters="{[myDSF]}"/>
    
        <s:Button id="myB2" 
            x="50" y="95" 
            label="Animate a DropShadowFilter" 
            click="myFilter.end();myFilter.play();"/>
    </s:Panel>
</s:Application>

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

AnimateFilter - AS3 Flex

Классы x

bitmapFilter

AnimateFilter