| Пакет | spark.filters |
| Класс | public class BevelFilter |
| Наследование | BevelFilter  BaseDimensionFilter BaseFilter EventDispatcher Object |
| Реализует | IBitmapFilter |
| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Новый фильтр можно создать с помощью конструктора new BevelFilter(). Выбор фильтра зависит от объекта, к которому требуется его применить:
- Если фильтр применяется к фрагментам ролика, текстовым полям, кнопкам или видео, следует использовать свойство
filters(наследуемое от класса DisplayObject). При задании объекту свойстваfiltersсам объект не изменяется, а фильтр можно удалить через свойствоfilters. - Для применения фильтров к объектам BitmapData следует пользоваться методом
BitmapData.applyFilter(). При вызовеapplyFilter()для объекта BitmapData из исходного объекта BitmapData и объекта фильтра формируется изображение с применением фильтра.
При применении фильтра к экранному объекту свойство cacheAsBitmap этого объекта принимает значение true. Если удалить все фильтры, будет восстановлено исходное значение cacheAsBitmap.
Этот фильтр поддерживает масштабирование сцены. Тем не менее, он не поддерживает общее масштабирование, повороты и искажение. Если сам объект увеличен или уменьшен (т. е. если свойства scaleX и scaleY не равны 100%), фильтр не масштабируется. Он масштабируется, только когда пользователь применяет увеличение к самой сцене.
Фильтр не применяется, если полученное изображение превышает максимальные размеры. В AIR 1.5 и Flash Player 10 максимальный размер изображения составляет 8 191 пикселей в ширину или высоту, а общее количество пикселей не может превышать 16 777 215. (Т. е. если ширина изображения составляет 8 191 пикселя, его высота не может быть больше 2 048 пикселей.) Например, при масштабировании большого фрагмента ролика, к которому применен фильтр, фильтр будет снят, если получившееся изображение превысит максимальные размеры.
Синтаксис MXML
Показать синтаксис MXML
Скрыть синтаксис MXMLThe <s:BevelFilter> tag inherits all of the tag
attributes of its superclass and adds the following tag attributes:
<s:BevelFilter
Properties
angle="45"
distance="4"
highlightAlpha="1"
highlightColor="0xFFFFFF"
shadowAlpha="1"
shadowColor="0x000000"
type="inner"
/>
Связанные элементы API
flash.display.DisplayObject.filters
flash.display.DisplayObject.cacheAsBitmap
flash.display.BitmapData.applyFilter()
| Свойство | Определено | ||
|---|---|---|---|
| angle : Number
Угол фаски в градусах. | BevelFilter | ||
 | blurX : Number
Степень размытия по горизонтали. | BaseDimensionFilter | |
| blurY : Number
Степень размытия по вертикали. | BaseDimensionFilter | |
| constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| distance : Number
Расстояние смещения наклона. | BevelFilter | ||
| highlightAlpha : Number
Значение альфа-прозрачности цвета выделения. | BevelFilter | ||
| highlightColor : uint
Цвет подсветки наклона. | BevelFilter | ||
| knockout : Boolean
Определяет, применяется ли к объекту эффект выбивки. | BaseDimensionFilter | |
| quality : int
Заданное число применений фильтра. | BaseDimensionFilter | |
| shadowAlpha : Number
Значение альфа-прозрачности цвета тени. | BevelFilter | ||
| shadowColor : uint
Цвет тени для наклона. | BevelFilter | ||
| strength : Number
Степень вдавливания или нанесения. | BaseDimensionFilter | |
| type : String
Расположение эффекта фильтра. | BevelFilter | ||
| Метод | Определено | ||
|---|---|---|---|
BevelFilter(distance:Number = 4.0, angle:Number = 45, highlightColor:uint = 0xFFFFFF, highlightAlpha:Number = 1.0, shadowColor:uint = 0x000000, shadowAlpha:Number = 1.0, blurX:Number = 4.0, blurY:Number = 4.0, strength:Number = 1, quality:int = 1, type:String = "inner", knockout:Boolean = false)
Конструктор. | BevelFilter | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. | EventDispatcher | |
Возвращает копию данного объекта фильтра. | BevelFilter | ||
|
Посылает событие в поток событий. | EventDispatcher | |
|
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. | EventDispatcher | |
|
Показывает, определено ли заданное свойство для объекта. | Object | |
|
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
|
Передает событие изменения после изменения фильтра. | BaseFilter | |
|
Показывает наличие заданного свойства и его перечисляемость. | Object | |
|
Удаляет прослушиватель из объекта EventDispatcher. | EventDispatcher | |
|
Задает доступность динамического свойства для операций цикла. | Object | |
|
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
|
Возвращает строковое представление заданного объекта. | Object | |
|
Возвращает элементарное значение заданного объекта. | Object | |
|
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | EventDispatcher | |
angle | свойство |
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):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):voidhighlightAlpha | свойство |
highlightAlpha:Number| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Значение альфа-прозрачности цвета выделения. Значение указано в виде нормализованного значения от 0 до 1. Например, при 0,25 устанавливается 25-процентная прозрачность.
Значением по умолчанию является 1.
Реализация
public function get highlightAlpha():Number public function set highlightAlpha(value:Number):voidhighlightColor | свойство |
highlightColor:uint| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Цвет подсветки наклона. Действительны значения в шестнадцатеричном формате, 0xRRGGBB.
Значением по умолчанию является 0xFFFFFF.
Реализация
public function get highlightColor():uint public function set highlightColor(value:uint):voidshadowAlpha | свойство |
shadowAlpha:Number| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Значение альфа-прозрачности цвета тени. Данное значение указано в виде нормализованного значения от 0 до 1. Например, при 0,25 устанавливается 25-процентная прозрачность.
Значением по умолчанию является 1.
Реализация
public function get shadowAlpha():Number public function set shadowAlpha(value:Number):voidshadowColor | свойство |
shadowColor:uint| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Цвет тени для наклона. Действительны значения в шестнадцатеричном формате, 0xRRGGBB.
Значением по умолчанию является 0x000000.
Реализация
public function get shadowColor():uint public function set shadowColor(value:uint):voidtype | свойство |
type:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Расположение эффекта фильтра. Возможными значениями являются константы flash.filters.BitmapFilterType:
BitmapFilterType.OUTER– свечение по внешнему краю объекта.BitmapFilterType.INNER— свечение по внутреннему краю объекта.BitmapFilterType.FULL— свечение по всему объекту.
Значением по умолчанию является BitmapFilterType.INNER.
Реализация
public function get type():String public function set type(value:String):voidСвязанные элементы API
BevelFilter | () | Конструктор |
public function BevelFilter(distance:Number = 4.0, angle:Number = 45, highlightColor:uint = 0xFFFFFF, highlightAlpha:Number = 1.0, shadowColor:uint = 0x000000, shadowAlpha:Number = 1.0, 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) | |
angle:Number (default = 45) | |
highlightColor:uint (default = 0xFFFFFF) | |
highlightAlpha:Number (default = 1.0) | |
shadowColor:uint (default = 0x000000) | |
shadowAlpha:Number (default = 1.0) | |
blurX:Number (default = 4.0) | |
blurY:Number (default = 4.0) | |
strength:Number (default = 1) | |
quality:int (default = 1)flash.filters.BitmapFilterQuality:
Фильтры с более низкими значениями выполняются быстрее. Для достижения нужных эффектов можно использовать и другие числовые значения. | |
type:String (default = "inner")flash.filters.BitmapFilterType: BitmapFilterType.INNER, BitmapFilterType.OUTER или BitmapFilterType.FULL.
| |
knockout:Boolean (default = false)true), который фактически делает заливку объекта прозрачной и выявляет цвет фона документа.
|
Связанные элементы API
clone | () | метод |
public function clone():BitmapFilter| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Возвращает копию данного объекта фильтра.
ВозвращаетBitmapFilter — Новый экземпляр BevelFilter с теми же свойствами, что и оригинальный экземпляр BevelFilter.
|
<?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 myBevelFilter:BevelFilter;
private var color:Number = 0xFF33FF;
public function createFilters():void {
myBevelFilter = new BevelFilter(5, 45, 0xFFFF00, .8, 0x0000FF, .8, 3, 3, 1, BitmapFilterQuality.MEDIUM, BitmapFilterType.INNER, false);
b1.filters = [myBevelFilter];
}
]]></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:BevelFilter
distance="5"
angle="45"
highlightColor="0xFFFF00"
highlightAlpha=".8"
shadowColor="0x0000FF"
shadowAlpha=".8"
blurX="3"
blurY="3"
strength="1"
quality="{BitmapFilterQuality.MEDIUM}"
type="{BitmapFilterType.INNER}"
knockout="false"/>
</s:filters>
</s:Button>
</s:VGroup>
</s:Application>
Tue Jun 12 2018, 11:34 AM Z