包 | spark.filters |
类 | public class BevelFilter |
继承 | BevelFilter ![]() ![]() ![]() ![]() |
实现 | IBitmapFilter |
语言版本: | ActionScript 3.0 |
产品版本: | Flex 4 |
运行时版本: | Flash Player 10, AIR 1.5 |
要创建新滤镜,请使用构造函数 new BevelFilter()
。滤镜的具体使用取决于要应用滤镜的对象:
- 要对影片剪辑、文本字段、按钮和视频应用滤镜,请使用
filters
属性(继承自 DisplayObject)。设置对象的filters
属性不会修改相应的对象,而清除filters
属性可以删除相应的滤镜。 - 要对 BitmapData 对象应用滤镜,请使用
BitmapData.applyFilter()
方法。对 BitmapData 对象调用applyFilter()
会取得源 BitmapData 对象和滤镜对象,并最终生成一个过滤图像。
如果对显示对象应用滤镜,则该对象的 cacheAsBitmap
属性值将设置为 true
。如果删除所有滤镜,将恢复 cacheAsBitmap
的原始值。
此滤镜支持舞台缩放。但是,它不支持常规缩放、旋转和倾斜。如果对象本身进行了缩放(如果 scaleX
和 scaleY
属性未被设置为 100%),则滤镜不进行缩放。只有用户在舞台上进行放大时它才会缩放。
如果所得图像超过最大尺寸,则不应用滤镜。在 AIR 1.5 和 Flash Player 10 中,最大宽度或高度为 8,191 像素,并且像素总数不能超过 16,777,215 像素。(因此,如果图像的宽度为 8,191 像素,则其高度只能为 2,048 像素。)例如,如果在放大某大型影片剪辑时应用了滤镜,则所得图像超过最大尺寸时,将关闭该滤镜。
MXML 语法
The <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.filters.BevelFilter
flash.display.DisplayObject.filters
flash.display.DisplayObject.cacheAsBitmap
flash.display.BitmapData.applyFilter()
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
加亮颜色的 Alpha 透明度值。 | BevelFilter | ||
highlightColor : uint
斜角的加亮颜色。 | BevelFilter | ||
![]() | knockout : Boolean
指定对象是否具有挖空效果。 | BaseDimensionFilter | |
![]() | quality : int
应用滤镜的次数。 | BaseDimensionFilter | |
shadowAlpha : Number
阴影颜色的 Alpha 透明度值。 | 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 | 属性 |
distance | 属性 |
highlightAlpha | 属性 |
highlightColor | 属性 |
shadowAlpha | 属性 |
shadowColor | 属性 |
type | 属性 |
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 ) — 斜角的角度,0 至 360 度。
| |
highlightColor:uint (default = 0xFFFFFF ) — 斜角的加亮颜色,0xRRGGBB。
| |
highlightAlpha:Number (default = 1.0 ) — 加亮颜色的 Alpha 透明度值。有效值为 0.0 到 1.0。例如,0.25 设置透明度值为 25%。
| |
shadowColor:uint (default = 0x000000 ) — 斜角的阴影颜色,0xRRGGBB。
| |
shadowAlpha:Number (default = 1.0 ) — 阴影颜色的 Alpha 透明度值。有效值为 0.0 到 1.0。例如,0.25 设置透明度值为 25%。
| |
blurX:Number (default = 4.0 ) — 水平模糊量,以像素为单位。有效值为 0 到 255.0(浮点)。
| |
blurY:Number (default = 4.0 ) — 垂直模糊量,以像素为单位。有效值为 0 到 255.0(浮点)。
| |
strength:Number (default = 1 ) — 印记或跨页的强度。该值越高,压印的颜色越深,而且斜角与背景之间的对比度也越强。有效值为 0 到 255.0。
| |
quality:int (default = 1 ) — 斜角的品质。有效值为 0 至 15,但是对于大多数应用情形,可以使用 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 实例。
|
示例 如何使用本示例
BevelFilterExample.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 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:04 AM Z