| パッケージ | spark.filters |
| クラス | public class GradientBevelFilter |
| 継承 | GradientBevelFilter  GradientFilter BaseDimensionFilter BaseFilter EventDispatcher Object |
| 実装 | IBitmapFilter |
| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
フィルターの使用方法は、フィルターの適用先オブジェクトによって異なります。
- 表示オブジェクトにフィルターを適用する場合は、
filtersプロパティを使用します。オブジェクトのfiltersプロパティを設定しても、オブジェクトは変更されません。filtersプロパティをクリアすることにより、フィルターを取り消すことができます。 - BitmapData オブジェクトにフィルターを適用するには、
BitmapData.applyFilter()メソッドを使用します。BitmapData オブジェクトでapplyFilter()を呼び出すことによって、ソース BitmapData オブジェクトとフィルターオブジェクトが取得され、フィルターを適用したイメージが生成されます。
表示オブジェクトにフィルターを適用すると、表示オブジェクトの cacheAsBitmap プロパティは true に設定されます。すべてのフィルターをクリアすると、cacheAsBitmap の元の値が復元されます。
このフィルターはステージの拡大 / 縮小に対応していますが、通常の拡大 / 縮小、回転、傾斜には対応していません。オブジェクト自体を拡大 / 縮小する場合（scaleX と scaleY の値が 1.0 以外に設定されている場合）、フィルター効果は拡大 / 縮小されません。フィルターが拡大 / 縮小されるのは、ユーザーがステージをズームインする場合のみです。
結果として得られるイメージが最大サイズを超えると、フィルターは適用されません。AIR 1.5 および Flash Player 10 における最大サイズは、幅または高さが 8,191 ピクセルで、合計のピクセル数は 16,777,215 ピクセルを超えないようにしてください（つまり、幅が 8,191 ピクセルのイメージでは、高さが 2,048 ピクセルになります）。例えば、フィルターが適用されたサイズの大きいムービークリップをズームインするとき、結果として得られるイメージが最大サイズを超える場合は、フィルターがオフになります。
MXML シンタックス
MXML シンタックスを表示
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
flash.filters.GradientBevelFilter
GradientBevelFilter.ratios
flash.display.BitmapData.applyFilter()
flash.display.DisplayObject.filters
flash.display.DisplayObject.cacheAsBitmap
パブリックプロパティ
パブリックメソッド
| メソッド | 定義元 | ||
|---|---|---|---|
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 | |
このフィルターオブジェクトのコピーを返します。 | GradientBevelFilter | ||
|
イベントをイベントフローに送出します。 | EventDispatcher | |
|
EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。 | EventDispatcher | |
|
オブジェクトに指定されたプロパティが定義されているかどうかを示します。 | Object | |
|
Object クラスのインスタンスが、パラメーターとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。 | Object | |
|
フィルターの変更時に変更イベントを伝播します。 | BaseFilter | |
|
指定されたプロパティが存在し、列挙できるかどうかを示します。 | Object | |
|
EventDispatcher オブジェクトからリスナーを削除します。 | EventDispatcher | |
|
ループ処理に対するダイナミックプロパティの可用性を設定します。 | Object | |
|
ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。 | Object | |
|
指定されたオブジェクトのストリング表現を返します。 | Object | |
|
指定されたオブジェクトのプリミティブな値を返します。 | Object | |
|
指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。 | EventDispatcher | |
パブリック定数
コンストラクターの詳細
GradientBevelFilter | () | コンストラクター |
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) | |
angle:Number (default = 45) | |
colors:Array (default = null) | |
alphas:Array (default = null)colors 配列内の各色に対応するアルファ透明度の値の配列です。配列の各エレメントに指定できる値は、0 ～ 1 です。例えば、.25 を指定すると、透明度の値として 25% が設定されます。
| |
ratios:Array (default = null) | |
blurX:Number (default = 4.0) | |
blurY:Number (default = 4.0) | |
strength:Number (default = 1) | |
quality:int (default = 1)
詳細については、 | |
type:String (default = "inner")
| |
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>
Tue Jun 12 2018, 10:34 AM Z