| Пакет | spark.filters |
| Класс | public class ConvolutionFilter |
| Наследование | ConvolutionFilter  BaseFilter EventDispatcher Object |
| Реализует | IBitmapFilter |
| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Создать фильтр «Свертывание» можно с помощью синтаксиса new ConvolutionFilter(). Выбор фильтра зависит от объекта, к которому требуется его применить:
- Если фильтр применяется к фрагментам ролика, текстовым полям, кнопкам или видео, следует использовать свойство
filters(наследуемое от класса DisplayObject). При задании объекту свойстваfiltersсам объект не изменяется, а фильтр можно удалить через свойствоfilters. - Для применения фильтров к объектам BitmapData следует пользоваться методом
BitmapData.applyFilter(). При вызовеapplyFilter()для объекта BitmapData из исходного объекта BitmapData и объекта фильтра формируется изображение с применением фильтра.
При применении фильтра к экранному объекту свойство cacheAsBitmap этого объекта принимает значение true. Если удалить все фильтры, будет восстановлено исходное значение cacheAsBitmap.
Фильтр не применяется, если полученное изображение превышает максимальные размеры. В AIR 1.5 и Flash Player 10 максимальный размер изображения составляет 8 191 пикселей в ширину или высоту, а общее количество пикселей не может превышать 16 777 215. (Т. е. если ширина изображения составляет 8 191 пикселя, его высота не может быть больше 2 048 пикселей.) Например, при масштабировании большого фрагмента ролика, к которому применен фильтр, фильтр будет снят, если получившееся изображение превысит максимальные размеры.
Синтаксис MXML
Показать синтаксис MXML
Скрыть синтаксис MXMLThe <s:ConvolutionFilter> tag inherits all of the tag
attributes of its superclass and adds the following tag attributes:
<s:ConvolutionFilter Properties alpha="1" clamp="true" color="0xFF0000" divisor="1.0" matrix="[]" matrixX="0" matrixY="0" preserveAlpha="true" />
| Свойство | Определено | ||
|---|---|---|---|
| alpha : Number
Значение альфа-прозрачности цвета. | ConvolutionFilter | ||
| bias : Number
Степень смещения, добавляемого к результату преобразования матрицы. | ConvolutionFilter | ||
| clamp : Boolean
Определяет, зафиксировано ли изображение. | ConvolutionFilter | ||
| color : uint
Цвет свечения. | ConvolutionFilter | ||
 | constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| divisor : Number
Делитель, используемый при проведении преобразования матрицы. | ConvolutionFilter | ||
| matrix : Array
Степень размытия по горизонтали. | ConvolutionFilter | ||
| matrixX : Number
Измерение х матрицы (число строк в матрице). | ConvolutionFilter | ||
| matrixY : Number
Измерение y матрицы (число столбцов в матрице). | ConvolutionFilter | ||
| preserveAlpha : Boolean
Определяет, сохраняется ли альфа-канал без эффекта фильтра или фильтр свертывания применяется к альфа-каналу так же, как и к цветовым каналам. | ConvolutionFilter | ||
| Метод | Определено | ||
|---|---|---|---|
ConvolutionFilter(matrixX:Number = 0, matrixY:Number = 0, matrix:Array = null, divisor:Number = 1.0, bias:Number = 0.0, preserveAlpha:Boolean = true, clamp:Boolean = true, color:uint = 0, alpha:Number = 0.0)
Конструктор. | ConvolutionFilter | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. | EventDispatcher | |
Возвращает копию данного объекта фильтра. | ConvolutionFilter | ||
|
Посылает событие в поток событий. | 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):voidbias | свойство |
bias:Number| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Степень смещения, добавляемого к результату преобразования матрицы. Смещение увеличивает значение цвета в каждом канале, так что темные цвета кажутся светлее.
Значением по умолчанию является 0.
Реализация
public function get bias():Number public function set bias(value:Number):voidclamp | свойство |
clamp:Boolean| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Определяет, зафиксировано ли изображение. Для пикселей, лежащих за пределами исходного изображения, значение true указывает, что входное изображение растянуто по каждой из границ методом дублирования значений цветов на соответствующем крае входного изображения. Значение false указывает на то, что следует использовать другой цвет, согласно значениям свойств color и alpha.
Значением по умолчанию является true.
Реализация
public function get clamp():Boolean public function set clamp(value:Boolean):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):voiddivisor | свойство |
divisor:Number| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Делитель, используемый при проведении преобразования матрицы. Значением по умолчанию является 1. Делитель, являющийся суммой всех значений матрицы, смягчает интенсивность цвета получаемого изображения. Значение 0 игнорируется, а вместо него используется значение по умолчанию.
Значением по умолчанию является 1.0.
Реализация
public function get divisor():Number public function set divisor(value:Number):voidmatrix | свойство |
matrix:Array| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Степень размытия по горизонтали. Действительны значения от 0 до 255. Размытие со значением 1 или менее означает, что исходное изображение копируется как есть. По умолчанию используется значение 4. Значения, являющиеся степенью 2 (т. е. 2, 4, 8, 16 и 32), оптимизируются и выполняются быстрее, чем остальные.
Значением по умолчанию является [].
Реализация
public function get matrix():Array public function set matrix(value:Array):voidmatrixX | свойство |
matrixY | свойство |
preserveAlpha | свойство |
preserveAlpha:Boolean| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Определяет, сохраняется ли альфа-канал без эффекта фильтра или фильтр свертывания применяется к альфа-каналу так же, как и к цветовым каналам. Значение false указывает, что свертывание применяется ко всем каналам, включая альфа-канал. Значение true указывает, что свертывание применяется только к цветовым каналам.
Значением по умолчанию является true.
Реализация
public function get preserveAlpha():Boolean public function set preserveAlpha(value:Boolean):voidConvolutionFilter | () | Конструктор |
public function ConvolutionFilter(matrixX:Number = 0, matrixY:Number = 0, matrix:Array = null, divisor:Number = 1.0, bias:Number = 0.0, preserveAlpha:Boolean = true, clamp:Boolean = true, color:uint = 0, alpha:Number = 0.0)| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Конструктор.
ПараметрыmatrixX:Number (default = 0) | |
matrixY:Number (default = 0) | |
matrix:Array (default = null)matrixX * matrixY.
| |
divisor:Number (default = 1.0) | |
bias:Number (default = 0.0) | |
preserveAlpha:Boolean (default = true)false указывает, что значение альфа-канала не сохранено, а свертывание применяется ко всем каналам, включая альфа-канал. Значение true указывает, что свертывание применяется только к цветовым каналам. По умолчанию используется значение true.
| |
clamp:Boolean (default = true)true указывает на то, что входное изображение растянуто по каждой из границ методом дублирования значений цветов на данном крае входного изображения. Значение false указывает на то, что следует использовать другой цвет, согласно значениям свойств color и alpha. Значение по умолчанию — true.
| |
color:uint (default = 0) | |
alpha:Number (default = 0.0) |
clone | () | метод |
public function clone():BitmapFilter| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Возвращает копию данного объекта фильтра.
ВозвращаетBitmapFilter — Новый экземпляр ConvolutionFilter с теми же свойствами, что и оригинальный экземпляр ConvolutionFilter.
|
<?xml version="1.0"?>
<!-- filters/examples/ConvolutionGlowFilterExample .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 myOutlineConvolutionFilter:ConvolutionFilter;
private var mySharpnessConvolutionFilter:ConvolutionFilter;
private var myBrightnessConvolutionFilter:ConvolutionFilter;
private var outlineMatrix:Array = [ -30, 30, 0,
-30, 30, 0,
-30, 30, 0 ];
private var sharpnessMatrix:Array = [0, -1, 0,
-1, 20, -1,
0, -1, 0];
private var brightnessMatrix:Array = [2, 2, 2,
2, 0, 2,
2, 2, 2];
public function createFilters():void {
myOutlineConvolutionFilter = new ConvolutionFilter(3, 3, outlineMatrix, 9, 0, true, true, 0x00CC99, 0);
mySharpnessConvolutionFilter = new ConvolutionFilter(3, 3, sharpnessMatrix, 9, 0, true, true, 0x00CC99, 0);
myBrightnessConvolutionFilter = new ConvolutionFilter(3, 3, brightnessMatrix, 3, 0, true, true, 0x00CC99, 0);
outlineImage.filters = [myOutlineConvolutionFilter];
sharpnessImage.filters = [mySharpnessConvolutionFilter];
brightnessImage.filters = [myBrightnessConvolutionFilter];
}
]]></fx:Script>
<s:VGroup>
<s:VGroup>
<s:Label text="Original Image"/>
<mx:Image id="originalImage" source="@Embed(source='assets/Nokia_6630.png')"/>
</s:VGroup>
<s:VGroup>
<s:Label text="Outline Matrix Image"/>
<mx:Image id="outlineImage" source="@Embed(source='assets/Nokia_6630.png')"/>
</s:VGroup>
<s:VGroup>
<s:Label text="Sharpness Matrix Image"/>
<mx:Image id="sharpnessImage" source="@Embed(source='assets/Nokia_6630.png')"/>
</s:VGroup>
<s:VGroup>
<s:Label text="Brightness Matrix Image"/>
<mx:Image id="brightnessImage" source="@Embed(source='assets/Nokia_6630.png')"/>
</s:VGroup>
</s:VGroup>
</s:Application>
Tue Jun 12 2018, 11:34 AM Z