| Пакет | spark.filters |
| Класс | public class DisplacementMapFilter |
| Наследование | DisplacementMapFilter  BaseFilter EventDispatcher Object |
| Реализует | IBitmapFilter |
| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Выбор фильтра зависит от объекта, к которому требуется его применить:
- Применить фильтры к экранному объекту можно с помощью свойства
filtersэтого объекта. При задании объекту свойстваfiltersсам объект не изменяется, а фильтр можно удалить через свойствоfilters. - Для применения фильтров к объектам BitmapData следует пользоваться методом
BitmapData.applyFilter(). При вызовеapplyFilter()для объекта BitmapData из исходного объекта BitmapData и объекта filter формируется изображение с применением фильтра.
При применении фильтра к экранному объекту свойство cacheAsBitmap этого объекта принимает значение true. Если удалить все фильтры, будет восстановлено исходное значение cacheAsBitmap.
В фильтре используется следующая формула:
dstPixel[x, y] = srcPixel[x + ((componentX(x, y) - 128) * scaleX) / 256, y + ((componentY(x, y) - 128) *scaleY) / 256)
где componentX(x, y) получает значение цвета свойства componentX от свойства mapBitmap при (x — mapPoint.x ,y — mapPoint.y).
Изображение карты, используемое фильтром, масштабируется по размеру сцены. Оно не масштабируется при масштабировании самого объекта.
Этот фильтр поддерживает масштабирование сцены. Тем не менее, общее масштабирование, повороты и искажение не поддерживаются. Если сам объект увеличен или уменьшен (т. е. если свойства scaleX и scaleY принимают значение, отличное от 1,0), фильтр не масштабируется. Он масштабируется, только когда пользователь применяет увеличение к самой сцене.
Показать синтаксис MXML
Скрыть синтаксис MXMLThe <s:DisplacementMapFilter> tag inherits all of the tag
attributes of its superclass and adds the following tag attributes:
<s:DisplacementMapFilter Properties alpha="0" color="0x000000" componentX="0" componentY="0" mapBitmap="null" mapPoint="null" mode="wrap" scaleX="0" scaleY="0" />
Связанные элементы API
flash.display.DisplayObject.filters
flash.display.DisplayObject.cacheAsBitmap
| Свойство | Определено | ||
|---|---|---|---|
| alpha : Number
Задает значение альфа-прозрачности, применяемое для замещения «вне пределов». | DisplacementMapFilter | ||
| color : uint
Задает цвет, используемый при смещениях, выходящих за пределы границ. | DisplacementMapFilter | ||
| componentX : uint
Указывает цветовой канал, который следует использовать в изображении карты для замещения результата x. | DisplacementMapFilter | ||
| componentY : uint
Указывает цветовой канал, который следует использовать в изображении карты для замещения результата y. | DisplacementMapFilter | ||
 | constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| mapBitmap : BitmapData
Объект BitmapData, содержащий данные карты замещения. | DisplacementMapFilter | ||
| mapPoint : Point
Значение, содержащее смещение левого верхнего угла целевого экранного объекта из левого верхнего угла изображения карты. | DisplacementMapFilter | ||
| mode : String
Режим для фильтра. | DisplacementMapFilter | ||
| scaleX : Number
Множитель, с помощью которого масштабируется результат x замещения, полученного в ходе вычисления карты. | DisplacementMapFilter | ||
| scaleY : Number
Множитель, с помощью которого масштабируется результат y замещения, полученного в ходе вычисления карты. | DisplacementMapFilter | ||
| Метод | Определено | ||
|---|---|---|---|
DisplacementMapFilter(mapBitmap:BitmapData = null, mapPoint:Point = null, componentX:uint = 0, componentY:uint = 0, scaleX:Number = 0.0, scaleY:Number = 0.0, mode:String = "wrap", color:uint = 0, alpha:Number = 0.0)
Конструктор. | DisplacementMapFilter | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. | EventDispatcher | |
Возвращает копию данного объекта фильтра. | DisplacementMapFilter | ||
|
Посылает событие в поток событий. | 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,0 до 1,0. Например, при 0,25 устанавливается 25-процентная прозрачность. Значением по умолчанию является 0. Это свойство используется, если свойство mode принимает значение DisplacementMapFilterMode.COLOR.
Значением по умолчанию является 0.
Реализация
public function get alpha():Number public function set alpha(value:Number):voidcolor | свойство |
color:uint| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Задает цвет, используемый при смещениях, выходящих за пределы границ. Допустимый диапазон смещений – от 0,0 до 1,0. Значения приводятся в шестнадцатеричном формате. Значение color по умолчанию равно 0. Это свойство используется, если свойство mode принимает значение DisplacementMapFilterMode.COLOR.
Значением по умолчанию является 0x000000.
Реализация
public function get color():uint public function set color(value:uint):voidcomponentX | свойство |
componentX:uint| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Указывает цветовой канал, который следует использовать в изображении карты для замещения результата x. Возможные значения являются константами BitmapDataChannel:
BitmapDataChannel.ALPHABitmapDataChannel.BLUEBitmapDataChannel.GREENBitmapDataChannel.RED
Значением по умолчанию является 0, meaning no channel..
Реализация
public function get componentX():uint public function set componentX(value:uint):voidСвязанные элементы API
componentY | свойство |
componentY:uint| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Указывает цветовой канал, который следует использовать в изображении карты для замещения результата y. Возможные значения являются константами BitmapDataChannel:
BitmapDataChannel.ALPHABitmapDataChannel.BLUEBitmapDataChannel.GREENBitmapDataChannel.RED
Значением по умолчанию является 0, meaning no channel..
Реализация
public function get componentY():uint public function set componentY(value:uint):voidmapBitmap | свойство |
mapBitmap:BitmapData| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Объект BitmapData, содержащий данные карты замещения.
Значением по умолчанию является null.
Реализация
public function get mapBitmap():BitmapData public function set mapBitmap(value:BitmapData):voidmapPoint | свойство |
mapPoint:Point| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Значение, содержащее смещение левого верхнего угла целевого экранного объекта из левого верхнего угла изображения карты.
Значением по умолчанию является null.
Реализация
public function get mapPoint():Point public function set mapPoint(value:Point):voidmode | свойство |
mode:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Режим для фильтра. Возможные значения являются константами DisplacementMapFilterMode:
DisplacementMapFilterMode.WRAP– переносит значение замещения на другую сторону исходного изображения.DisplacementMapFilterMode.CLAMP— фиксирует значение замещения по краю исходного изображения.DisplacementMapFilterMode.IGNORE— если значение замещения находится вне диапазона, игнорирует замещение и использует исходный пиксель.DisplacementMapFilterMode.COLOR— если значение замещения находится вне изображения, заменяет значения свойств color и alpha.
Значением по умолчанию является DisplacementMapFilterMode.WRAP.
Реализация
public function get mode():String public function set mode(value:String):voidscaleX | свойство |
scaleX:Number| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Множитель, с помощью которого масштабируется результат x замещения, полученного в ходе вычисления карты.
Значением по умолчанию является 0.
Реализация
public function get scaleX():Number public function set scaleX(value:Number):voidscaleY | свойство |
scaleY:Number| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Множитель, с помощью которого масштабируется результат y замещения, полученного в ходе вычисления карты.
Значением по умолчанию является 0.
Реализация
public function get scaleY():Number public function set scaleY(value:Number):voidDisplacementMapFilter | () | Конструктор |
public function DisplacementMapFilter(mapBitmap:BitmapData = null, mapPoint:Point = null, componentX:uint = 0, componentY:uint = 0, scaleX:Number = 0.0, scaleY:Number = 0.0, mode:String = "wrap", color:uint = 0, alpha:Number = 0.0)| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Конструктор.
ПараметрыmapBitmap:BitmapData (default = null) | |
mapPoint:Point (default = null) | |
componentX:uint (default = 0) | |
componentY:uint (default = 0) | |
scaleX:Number (default = 0.0) | |
scaleY:Number (default = 0.0) | |
mode:String (default = "wrap") | |
color:uint (default = 0)mode установлено значение DisplacementMapFilterMode.COLOR.
| |
alpha:Number (default = 0.0)mode установлено значение DisplacementMapFilterMode.COLOR.
|
Связанные элементы API
clone | () | метод |
public function clone():BitmapFilter| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Возвращает копию данного объекта фильтра.
ВозвращаетBitmapFilter — Новый экземпляр DisplacementMapFilter с теми же свойствами, что и оригинальный экземпляр.
|
Tue Jun 12 2018, 11:34 AM Z