GradientBevelFilter

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

Язык версии:

ActionScript 3.0

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

Flex 4

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

Flash Player 10, AIR 1.5

Класс GradientBevelFilter позволяет применять эффект градиентного наклона к экранным объектам. Градиентный наклон представляет собой скошенный край с цветовым градиентом на внешней или внутренней стороне или поверх всего объекта. Скошенные края придают объектам эффект трехмерности. Фильтр можно применять к любому экранному объекту (т. е. объекту, наследуемому от класса 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:GradientBevelFilter> tag inherits all of the tag attributes of its superclass and adds no tag attributes:

  <s:GradientBevelFilter/>

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

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

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

spark.filters.BevelFilter
flash.filters.GradientBevelFilter
GradientBevelFilter.ratios
flash.display.BitmapData.applyFilter()
flash.display.DisplayObject.filters
flash.display.DisplayObject.cacheAsBitmap

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

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

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

	Свойство		Определено
		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

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

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

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

	Метод		Определено
		GradientBevelFilter(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 = "inner", knockout:Boolean = false) Конструктор.	GradientBevelFilter
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии.	EventDispatcher
		clone():BitmapFilter Возвращает копию данного объекта фильтра.	GradientBevelFilter
		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 GradientBevelFilter(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 = "inner", knockout:Boolean = false)

Язык версии:

ActionScript 3.0

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

Flex 4

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

Flash Player 10, AIR 1.5

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

Параметры

	`distance:Number` (default = `4.0`) — Расстояние смещения. Действительны значения от 0 до 8.

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

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

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

	`ratios:Array` (default = `null`) — Массив значений распределения цветов; действительными являются значения от 0 до 255.

	`blurX:Number` (default = `4.0`) — Степень размытия по горизонтали. Действительны значения от 0 до 255. Размытие со значением 1 или менее означает, что исходное изображение копируется как есть. По умолчанию используется значение 4. Значения, являющиеся степенью 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`) — Качество фильтра. Используйте константы BitmapFilterQuality: `BitmapFilterQuality.LOW` `BitmapFilterQuality.MEDIUM` `BitmapFilterQuality.HIGH` Подробные сведения см. в описании свойства `quality`.

	`type:String` (default = "`inner`") — Местоположение эффекта «Наклон». Возможные значения констант BitmapFilterType: `BitmapFilterType.OUTER` — наклон по внешнему краю объекта. `BitmapFilterType.INNER` — наклон по внутреннему краю объекта. `BitmapFilterType.FULL` — наклон по всему объекту.

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

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

clone

()

метод

public function clone():BitmapFilter

Язык версии:

ActionScript 3.0

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

Flex 4

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

Flash Player 10, AIR 1.5

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

Возвращает

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

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

GradientBevelFilterExample.mxml

<?xml version="1.0"?>
<!-- filters/examples/BevelFilterExample.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 myGradientBevelFilter:GradientBevelFilter;       
     private var colors:Array = [0xFFFFFF, 0xCCCCCC, 0x000000];
     private var alphas:Array = [1, 0, 1];  
     private var ratios:Array = [0, 128, 255];
  
     public function createFilters():void {        
        myGradientBevelFilter = new GradientBevelFilter(5, 45, colors, alphas, ratios, 8, 8, 2, BitmapFilterQuality.MEDIUM, BitmapFilterType.INNER, false);
        b1.filters = [myGradientBevelFilter];
     }
  
  ]]></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:GradientBevelFilter 
                    distance="5"
                    angle="45"
                    blurX="8" 
                    blurY="8" 
                    strength="2"
                    quality="{BitmapFilterQuality.MEDIUM}"
                    type="{BitmapFilterType.INNER}"
                    knockout="false">
                        <s:entries>
                            <s:GradientEntry alpha="1" color="0xFFFFFF" ratio="0"/>
                            <s:GradientEntry alpha="0" color="0xCCCCCC" ratio="128"/>
                            <s:GradientEntry alpha="1" color="0x000000" ratio="255"/>
                        </s:entries>
                </s:GradientBevelFilter>
            </s:filters>
        </s:Button>
        
    </s:VGroup>        
</s:Application>

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

GradientBevelFilter - AS3 Flex

Классы x

GradientBevelFilter

clone