spark.filtersGradientBevelFilter GradientBevelFilter クラスを使用すると、オブジェクトにグラデーションベベル効果を適用し、表示できます。The <s:GradientBevelFilter> tag inherits all of the tag attributes of its superclass and adds no tag attributes:

  <s:GradientBevelFilter/>
  
]]>
mx.filters:IBitmapFilterspark.filters:GradientFilter GradientBevelFilter クラスを使用すると、オブジェクトにグラデーションベベル効果を適用し、表示できます。グラデーションベベルは、オブジェクトの外側、内側、または上側が斜めになったエッジであり、グラデーションカラーで強調されます。斜めのエッジによってオブジェクトが 3 次元に見えます。このフィルターは、MovieClip、SimpleButton、TextField、Video オブジェクトなどの DisplayObject クラスから継承した表示オブジェクト、および BitmapData オブジェクトに適用できます。

フィルターの使用方法は、フィルターの適用先オブジェクトによって異なります。

  • 表示オブジェクトにフィルターを適用する場合は、filters プロパティを使用します。オブジェクトの filters プロパティを設定しても、オブジェクトは変更されません。filters プロパティをクリアすることにより、フィルターを取り消すことができます。
  • BitmapData オブジェクトにフィルターを適用するには、BitmapData.applyFilter() メソッドを使用します。BitmapData オブジェクトで applyFilter() を呼び出すことによって、ソース BitmapData オブジェクトとフィルターオブジェクトが取得され、フィルターを適用したイメージが生成されます。

表示オブジェクトにフィルターを適用すると、表示オブジェクトの cacheAsBitmap プロパティは true に設定されます。すべてのフィルターをクリアすると、cacheAsBitmap の元の値が復元されます。

このフィルターはステージの拡大 / 縮小に対応していますが、通常の拡大 / 縮小、回転、傾斜には対応していません。オブジェクト自体を拡大 / 縮小する場合(scaleXscaleY の値が 1.0 以外に設定されている場合)、フィルター効果は拡大 / 縮小されません。フィルターが拡大 / 縮小されるのは、ユーザーがステージをズームインする場合のみです。

結果として得られるイメージが最大サイズを超えると、フィルターは適用されません。AIR 1.5 および Flash Player 10 における最大サイズは、幅または高さが 8,191 ピクセルで、合計のピクセル数は 16,777,215 ピクセルを超えないようにしてください(つまり、幅が 8,191 ピクセルのイメージでは、高さが 2,048 ピクセルになります)。例えば、フィルターが適用されたサイズの大きいムービークリップをズームインするとき、結果として得られるイメージが最大サイズを超える場合は、フィルターがオフになります。

spark.filters.BevelFilterflash.filters.GradientBevelFilterGradientBevelFilter.ratiosflash.display.BitmapData.applyFilter()flash.display.DisplayObject.filtersflash.display.DisplayObject.cacheAsBitmapGradientBevelFilter コンストラクターです。distance4.0オフセット距離です。指定できる値は 0 ~ 8 です。 angle45角度(度数)です。指定できる値は 0 ~ 360 です。 colorsnullグラデーションで使用する RGB 16 進数カラー値の配列です。例えば、赤は 0xFF0000、青は 0x0000FF などです。 alphasnullcolors 配列内の各色に対応するアルファ透明度の値の配列です。配列の各エレメントに指定できる値は、0 ~ 1 です。例えば、.25 を指定すると、透明度の値として 25% が設定されます。 ratiosnull色分布比率の配列です。0 ~ 255 の範囲の値を指定できます。 blurX4.0水平方向のぼかし量。指定できる値は 0 ~ 255 です。1 以下の値を指定すると、元のイメージがそのままコピーされます。デフォルト値は 4 です。2 のべき乗(2、4、8、16、32 など)は、他の値と比べて速くレンダリングできるよう最適化されます。 blurY4.0垂直方向のぼかし量。指定できる値は 0 ~ 255 です。1 以下の値を指定すると、元のイメージがそのままコピーされます。2 のべき乗(2、4、8、16、32 など)は、他の値と比べて速くレンダリングできるよう最適化されます。 strength1インプリントの強さまたは広がりです。値が大きいほど、濃い色がインプリントされるので、ベベルと背景との間のコントラストが強くなります。指定できる値は 0 ~ 255 です。値を 0 にすると、フィルターが適用されなくなります。 quality1フィルターの品質です。次の BitmapFilterQuality 定数を使用します。
  • BitmapFilterQuality.LOW
  • BitmapFilterQuality.MEDIUM
  • BitmapFilterQuality.HIGH

詳細については、quality プロパティの説明を参照してください。

typeinnerベベル効果の配置です。指定できる値は、BitmapFilterType 定数です。
  • BitmapFilterType.OUTER - ベベルがオブジェクトの外側エッジに配置されます。
  • BitmapFilterType.INNER - ベベルがオブジェクトの内側エッジに配置されます。
  • BitmapFilterType.FULL - ベベルがオブジェクトの上に配置されます。
knockoutfalseノックアウト効果を適用するかどうかを指定します。true を指定すると、オブジェクトの塗りが透明になり、ドキュメントの背景色が表示されます。
コンストラクターです。
clone このフィルターオブジェクトのコピーを返します。元の GradientBevelFilter インスタンスとプロパティがすべて同じである新しい GradientBevelFilter インスタンスです。 このフィルターオブジェクトのコピーを返します。
DropShadowFilter DropShadowFilter クラスは、ドロップシャドウを表示オブジェクトに追加します。The <s:DropShadowFilter> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <s:DropShadowFilter 
    Properties
    alpha="1"
    angle="45"
    color="0xFF0000"
    distance="4"
    hideObject="false"
    inner="false"
  />
  
]]>
mx.filters:IBitmapFiltermx.filters:BaseDimensionFilter DropShadowFilter クラスは、ドロップシャドウを表示オブジェクトに追加します。シャドウアルゴリズムは、ぼかしフィルターで使用するのと同じボックスフィルターに基づいています。ドロップシャドウのスタイルには複数のオプションがあり、内側シャドウ、外側シャドウ、ノックアウトモードなどがあります。このフィルターは、MovieClip、SimpleButton、TextField、Video オブジェクトなどの DisplayObject クラスから継承した表示オブジェクト、および BitmapData オブジェクトに適用できます。

フィルターの使用方法は、フィルターの適用先オブジェクトによって異なります。

  • 表示オブジェクトにフィルターを適用する場合は、DisplayObject から継承した filters プロパティを使用します。オブジェクトの filters プロパティを設定しても、オブジェクトは変更されません。filters プロパティをクリアすることにより、フィルターを取り消すことができます。
  • BitmapData オブジェクトにフィルターを適用するには、BitmapData.applyFilter() メソッドを使用します。BitmapData オブジェクトで applyFilter() を呼び出すことによって、ソース BitmapData オブジェクトとフィルターオブジェクトが取得され、フィルターを適用したイメージが生成されます。

表示オブジェクトにフィルターを適用すると、表示オブジェクトの cacheAsBitmap プロパティの値が true に設定されます。すべてのフィルターをクリアすると、cacheAsBitmap の元の値が復元されます。

このフィルターはステージの拡大 / 縮小に対応していますが、通常の拡大 / 縮小、回転、傾斜には対応していません。オブジェクト自体が拡大 / 縮小される場合(scaleXscaleY プロパティの値が 1.0 以外に設定されている場合)、フィルターは拡大 / 縮小されません。フィルターが拡大 / 縮小されるのは、ユーザーがステージをズームインする場合のみです。

結果として得られるイメージが最大サイズを超えると、フィルターは適用されません。AIR 1.5 および Flash Player 10 における最大サイズは、幅または高さが 8,191 ピクセルで、合計のピクセル数は 16,777,215 ピクセルを超えないようにしてください(つまり、幅が 8,191 ピクセルのイメージでは、高さが 2,048 ピクセルになります)。例えば、フィルターが適用されたサイズの大きいムービークリップをズームインするとき、結果として得られるイメージが最大サイズを超える場合は、フィルターがオフになります。

flash.filters.DropShadowFilterDropShadowFilter コンストラクターです。distance4.0シャドウのオフセット距離(ピクセル単位)です。 angle450 ~ 360 度で表されるシャドウの角度(浮動小数)です。 color0シャドウのカラーです。16 進数形式(0xRRGGBB)で指定します。デフォルト値は 0x000000 です。 alpha1.0シャドウカラーのアルファ透明度値です。0.0 ~ 1.0 の値を指定できます。例えば .25 と指定すると、透明度は 25% になります。 blurX4.0水平方向のぼかし量。指定できる値は 0 ~ 255.0(浮動小数)です。 blurY4.0垂直方向のぼかし量。指定できる値は 0 ~ 255.0(浮動小数)です。 strength1.0インプリントの強さまたは広がりです。値が大きいほど、濃い色がインプリントされるので、シャドウと背景との間のコントラストが強くなります。指定できる値は 0 ~ 255.0 です。 quality1フィルターを適用する回数。BitmapFilterQuality 定数を使用します。
  • BitmapFilterQuality.LOW
  • BitmapFilterQuality.MEDIUM
  • BitmapFilterQuality.HIGH

これらの値については、quality プロパティの説明を参照してください。

innerfalseシャドウが内側のシャドウであるかどうかを指定します。true の場合は、内側シャドウを示します。値 false は外側シャドウ(オブジェクトの外側のエッジにあるシャドウ)を示します。 knockoutfalsetrue の場合は、ノックアウト効果を適用します。その結果、オブジェクトの塗りが透明になり、ドキュメントの背景色が表示されます。 hideObjectfalseオブジェクトが非表示であるかどうかを示します。true を指定すると、オブジェクト自体は描画されず、シャドウだけが表示されます。
コンストラクターです。
flash.filters.BitmapFilterQuality
clone このフィルターオブジェクトのコピーを返します。元の DropShadowFilter インスタンスのプロパティをすべて備えた新しい DropShadowFilter インスタンスです。 このフィルターオブジェクトのコピーを返します。 alpha カラーのアルファ透明度の値です。1 カラーのアルファ透明度の値です。指定できる値は 0 ~ 1 です。例えば、.25 を指定すると、透明度の値として 25% が設定されます。 angle ベベルの角度です。45 ベベルの角度です。有効な値の範囲は 0 ~ 360°です。角度の値は、オブジェクトに対する架空の光源の角度を表し、オブジェクトに対する効果の相対位置を決定します。distance プロパティが 0 に設定された場合、効果がオブジェクトからオフセットされないため、angle プロパティは適用されません。 color グローのカラーを表します。0xFF0000 グローのカラーを表します。有効な値は、16 進数形式(0xRRGGBB)です。 distance ベベルのオフセット距離です。4 ベベルのオフセット距離です。この値はピクセル単位で指定します(浮動小数値)。 hideObject オブジェクトが非表示であるかどうかを示します。false オブジェクトが非表示であるかどうかを示します。true を指定すると、オブジェクト自体は描画されず、シャドウだけが表示されます。デフォルトは false で、オブジェクトが表示されます。 inner グローが内側グローであるかどうかを示します。false グローが内側グローであるかどうかを示します。true の場合は、内側グローであることを示します。デフォルトは false (外側グロー) で、オブジェクトの外側のエッジにあるグローが作成されます。
ConvolutionFilter ConvolutionFilter クラスを使用すると、マトリックス畳み込みフィルター効果を適用できます。The <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"
 />
 
]]>
mx.filters:IBitmapFiltermx.filters:BaseFilter ConvolutionFilter クラスを使用すると、マトリックス畳み込みフィルター効果を適用できます。畳み込みでは、入力イメージ内のピクセルを、隣接するピクセルと組み合わせて、イメージを作成します。畳み込みを使用すると、ぼかし、エッジ検出、シャープ、エンボス、ベベルなど、幅広いイメージ効果を実現できます。このフィルターは、MovieClip、SimpleButton、TextField、Video オブジェクトなどの DisplayObject クラスから継承した表示オブジェクト、および BitmapData オブジェクトに適用できます。

畳み込みフィルターを作成するには、シンタックス new ConvolutionFilter() を使用します。フィルターの使用方法は、フィルターの適用先オブジェクトによって異なります。

  • ムービークリップ、テキストフィールド、ボタン、およびビデオにフィルターを適用する場合は、DisplayObject から継承した filters プロパティを使用します。オブジェクトの filters プロパティを設定しても、オブジェクトは変更されません。filters プロパティをクリアすることにより、フィルターを取り消すことができます。
  • BitmapData オブジェクトにフィルターを適用するには、BitmapData.applyFilter() メソッドを使用します。BitmapData オブジェクトで applyFilter() を呼び出すことによって、ソース BitmapData オブジェクトとフィルターオブジェクトが取得され、フィルターを適用したイメージが生成されます。

表示オブジェクトにフィルターを適用すると、オブジェクトの cacheAsBitmap プロパティの値が true に設定されます。すべてのフィルターをクリアすると、cacheAsBitmap の元の値が復元されます。

結果として得られるイメージが最大サイズを超えると、フィルターは適用されません。AIR 1.5 および Flash Player 10 における最大サイズは、幅または高さが 8,191 ピクセルで、合計のピクセル数は 16,777,215 ピクセルを超えないようにしてください(つまり、幅が 8,191 ピクセルのイメージでは、高さが 2,048 ピクセルになります)。例えば、フィルターが適用されたサイズの大きいムービークリップをズームインするとき、結果として得られるイメージが最大サイズを超える場合は、フィルターがオフになります。

ConvolutionFilter コンストラクターです。matrixX0マトリックスの x 次元(マトリックスの列数)です。デフォルト値は 0 です。 matrixY0マトリックスの y 次元(マトリックスの行数)です。デフォルト値は 0 です。 matrixnullマトリックス変換に使用する値の配列です。この配列に含まれる項目数は必ず matrixX ~~ matrixY に等しくなります。 divisor1.0マトリックス変換中に使用する除数です。デフォルト値は 1 です。除数がすべてのマトリックス値の合計と等しい場合は、結果全体のカラー強度が均等化されます。値 0 は無視され、代わりにデフォルト値が使用されます。 bias0.0マトリックス変換の結果に加算するバイアスです。デフォルト値は 0 です。 preserveAlphatruefalse である場合は、アルファ値が保持されず、アルファチャンネルを含め、すべてのチャンネルに畳み込みを適用します。true である場合は、畳み込みをカラーチャンネルだけに適用します。デフォルト値は true です。 clamptruetrue の場合、ソースイメージの外にあるピクセルに対して、入力イメージの所定のエッジのカラー値を複製するという方法で、必要に応じて境界に沿って入力イメージを拡張します。false の場合は、別の色を使用します。その色は color プロパティと alpha プロパティで指定します。デフォルト値は true です。 color0ソースイメージの外にあるピクセルを置換する 16 進数のカラー値です。 alpha0.0代替カラーのアルファです。 コンストラクターです。 clone このフィルターオブジェクトのコピーを返します。元の ConvolutionMatrixFilter インスタンスとプロパティがすべて同じである新しい ConvolutionFilter インスタンスです。 このフィルターオブジェクトのコピーを返します。 alpha カラーのアルファ透明度の値です。1 カラーのアルファ透明度の値です。指定できる値は 0 ~ 1 です。例えば、.25 を指定すると、透明度の値として 25% が設定されます。 bias マトリックス変換の結果に加算するバイアス量です。0 マトリックス変換の結果に加算するバイアス量です。バイアスにより各チャンネルのカラー値が増えるため、暗い色は明るくなります。 clamp イメージをクランプする必要があるかどうかを示します。true イメージをクランプする必要があるかどうかを示します。true の場合、ソースイメージの外にあるピクセルに対して、入力イメージの各エッジのカラー値を複製するという方法で、必要に応じて境界に沿って入力イメージを拡張します。false の場合は、別の色を使用します。その色は color プロパティと alpha プロパティで指定します。 color グローのカラーを表します。0xFF0000 グローのカラーを表します。有効な値は、16 進数形式(0xRRGGBB)です。 divisor マトリックス変換中に使用する除数です。1.0 マトリックス変換中に使用する除数です。デフォルト値は 1 です。序数がすべてのマトリックス値の合計と等しい場合は、結果全体のカラー強度が均等化されます。値 0 は無視され、代わりにデフォルト値が使用されます。 matrixX マトリックスの x 次元(マトリックスの行数)です。0 マトリックスの x 次元(マトリックスの行数)です。 matrixY マトリックスの y 次元(マトリックスの列数)です。0 マトリックスの y 次元(マトリックスの列数)です。 matrix 水平方向のぼかし量。[] 水平方向のぼかし量。指定できる値は 0 ~ 255 です。1 以下の値を指定すると、元のイメージがそのままコピーされます。デフォルト値は 4 です。2 のべき乗(2、4、8、16、32 など)は、他の値と比べて速くレンダリングできるよう最適化されます。 preserveAlpha アルファチャンネルがフィルター効果なしで維持されるかどうか、またはカラーチャンネルだけではなくアルファチャンネルにも畳み込みフィルターが適用されるかどうかを示します。true アルファチャンネルがフィルター効果なしで維持されるかどうか、またはカラーチャンネルだけではなくアルファチャンネルにも畳み込みフィルターが適用されるかどうかを示します。false である場合は、アルファチャンネルを含め、すべてのチャンネルに畳み込みを適用します。true である場合は、畳み込みをカラーチャンネルだけに適用します。
BlurFilter BlurFilter クラスを使用すると、表示オブジェクトにぼかし効果を適用できます。The <s:BlurFilter> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <s:BlurFilter
    Properties
    blurX="4.0"
    blurY="4.0"
    quality="low"
  />
  
]]>
mx.filters:IBitmapFiltermx.filters:BaseFilter BlurFilter クラスを使用すると、表示オブジェクトにぼかし効果を適用できます。ぼかし効果は、イメージの細部をぼかします。ソフトフォーカスがかかっているように見えるぼかしから、半透明ガラスを通してイメージを見るようにかすんで見えるガウスぼかしまで作成できます。このフィルターの quality プロパティを低く設定すると、ソフトフォーカスがかかっているように見えるぼかしになります。quality プロパティを高く設定すると、ガウスぼかしフィルターに似たものになります。このフィルターは、MovieClip、SimpleButton、TextField、Video オブジェクトなどの DisplayObject クラスから継承した表示オブジェクト、および BitmapData オブジェクトに適用できます。

新しいフィルターを作成するには、コンストラクター new BlurFilter() を使用します。フィルターの使用方法は、フィルターの適用先オブジェクトによって異なります。

  • ムービークリップ、テキストフィールド、ボタン、およびビデオにフィルターを適用する場合は、DisplayObject から継承した filters プロパティを使用します。オブジェクトの filters プロパティを設定しても、オブジェクトは変更されません。filters プロパティをクリアすることにより、フィルターを取り消すことができます。
  • BitmapData オブジェクトにフィルターを適用するには、BitmapData.applyFilter() メソッドを使用します。BitmapData オブジェクトで applyFilter() を呼び出すことによって、ソース BitmapData オブジェクトとフィルターオブジェクトが取得され、フィルターを適用したイメージが生成されます。

表示オブジェクトにフィルターを適用すると、表示オブジェクトの cacheAsBitmap プロパティは true に設定されます。すべてのフィルターを削除すると、cacheAsBitmap の元の値が復元されます。

このフィルターはステージの拡大 / 縮小に対応していますが、通常の拡大 / 縮小、回転、傾斜には対応していません。オブジェクト自体が拡大 / 縮小される場合(scaleXscaleY が 100% に設定されていない場合)、フィルター効果は拡大 / 縮小されません。フィルターが拡大 / 縮小されるのは、ユーザーがステージをズームインする場合のみです。

結果として得られるイメージが最大サイズを超えると、フィルターは適用されません。AIR 1.5 および Flash Player 10 における最大サイズは、幅または高さが 8,191 ピクセルで、合計のピクセル数は 16,777,215 ピクセルを超えないようにしてください(つまり、幅が 8,191 ピクセルのイメージでは、高さが 2,048 ピクセルになります)。例えば、フィルターが適用されたサイズの大きいムービークリップをズームインするとき、結果として得られるイメージが最大サイズを超える場合は、フィルターがオフになります。

flash.filters.BlurFilterflash.display.DisplayObject.filtersflash.display.DisplayObject.cacheAsBitmapflash.display.BitmapData.applyFilter()BlurFilter コンストラクターです。blurX4.0水平方向のぼかし量。指定できる値は 0 ~ 255.0(浮動小数値)です。 blurY4.0垂直方向のぼかし量。指定できる値は 0 ~ 255.0(浮動小数値)です。 quality1フィルターを適用する回数。品質は flash.filters.BitmapFilterQuality 定数を使用して指定できます。
  • flash.filters.BitmapFilterQuality.LOW
  • flash.filters.BitmapFilterQuality.MEDIUM
  • flash.filters.BitmapFilterQuality.HIGH

高品質にすると、ガウスぼかしに似たものになります。多くのアプリケーションでは、これら 3 つの値で十分です。最大 15 までの値を使用して様々な効果を出すことができますが、値が大きくなるほどレンダリング速度が低下することに注意してください。

フィルターを初期化します。
コンストラクターです。デフォルト値では、ソフトフォーカスのかかったイメージが作成されます。
clone このフィルターオブジェクトのコピーを返します。元の BlurFilter インスタンスとプロパティがすべて同じである新しい BlurFilter インスタンスです。 このフィルターオブジェクトのコピーを返します。 blurX 水平方向のぼかし量。4.0 水平方向のぼかし量。指定できる値は 0 ~ 255 です。1 以下の値を指定すると、元のイメージがそのままコピーされます。デフォルト値は 4 です。2 のべき乗(2、4、8、16、32 など)は、他の値と比べて速くレンダリングできるよう最適化されます。 blurY 垂直方向のぼかし量。4.0 垂直方向のぼかし量。指定できる値は 0 ~ 255 です。1 以下の値を指定すると、元のイメージがそのままコピーされます。デフォルト値は 4 です。2 のべき乗(2、4、8、16、32 など)は、他の値と比べて速くレンダリングできるよう最適化されます。 quality フィルターを適用する回数。"low" フィルターを適用する回数。デフォルト値は、フィルターを 1 回適用することに相当する BitmapFilterQuality.LOW です。値 BitmapFilterQuality.MEDIUM はフィルターを 2 回適用します。値 BitmapFilterQuality.HIGH はフィルターを 3 回適用します。フィルターに設定された値が小さいほど、速くレンダリングできます。

多くのアプリケーションでは、quality の値は低、中、または高で十分です。最大 15 までの値を使用してさまざまな効果を出すことができますが、値が大きくなるほどレンダリング速度が低下します。quality の値を増やす代わりに、blurXblurY の値を増やすだけで、同様の効果が得られます。この方法を実行すると、より高速にレンダリングされます。

ColorMatrixFilter ColorMatrixFilter クラスを使用すると、入力イメージの各ピクセルの RGBA カラー値とアルファ値に 4 × 5 マトリックス変換を適用することで、新しい RGBA カラー値とアルファ値から成る結果を作成できます。The <s:ColorMatrixFilter> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <s:ColorMatrixFilter
    Properties
    matrix="[1,0,0,0,0,0,1,0,0,0,0,0,1,0,0,0,0,0,1,0]"
  />
  
]]>
mx.filters:IBitmapFiltermx.filters:BaseFilter ColorMatrixFilter クラスを使用すると、入力イメージの各ピクセルの RGBA カラー値とアルファ値に 4 × 5 マトリックス変換を適用することで、新しい RGBA カラー値とアルファ値から成る結果を作成できます。これにより、彩度変更、色相回転、輝度アルファ変換など、さまざまな効果を利用できます。このフィルターは、MovieClip、SimpleButton、TextField、Video オブジェクトなどの DisplayObject クラスから継承した表示オブジェクト、および BitmapData オブジェクトに適用できます。 flash.filters.ColorMatrixFilterColorMatrixFilter コンストラクターです。matrixnull4 × 5 のマトリックス構成を持つ 20 個のアイテムの配列です。 新しい ColorMatrixFilter インスタンスを初期化します。 コンストラクターです。 clone このフィルターオブジェクトのコピーを返します。元のインスタンスと同じプロパティをすべて備えた新しい ColorMatrixFilter インスタンスです。 このフィルターオブジェクトのコピーを返します。 matrix レンダリングされたエレメントに適用される 4 × 5 マトリックスを構成する 20 個の倍精度実数のカンマ区切りリストです。[1,0,0,0,0,0,1,0,0,0,0,0,1,0,0,0,0,0,1,0] レンダリングされたエレメントに適用される 4 × 5 マトリックスを構成する 20 個の倍精度実数のカンマ区切りリストです。マトリックスは行優先順です。つまり、最初の 5 つのエレメントにベクター [srcR,srcG,srcB,srcA,1] を乗算して出力の赤の値を決定し、次の 5 つが出力の緑の値を決定する、のようになります。

値は、配列、または 20 個の数字のカンマ区切りのストリングである必要があります。

GradientFilter グラデーションビジュアルエフェクトを提供するフィルターの基本クラスです。The <s:GradientFilter> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <s:GradientFilter
    Properties
    angle="45"
    distance="4.0"
    entries="[]"
    type="inner"
  />
  
]]>
mx.filters:BaseDimensionFilter グラデーションビジュアルエフェクトを提供するフィルターの基本クラスです。 spark.filters.GradientGlowFilterspark.filters.GradientBevelFilterGradientFilter コンストラクターです。colorsnullグラデーションで使用する RGB 16 進数カラー値の配列です。例えば、赤は 0xFF0000、青は 0x0000FF などです。 alphasnullcolors 配列内の各色に対応するアルファ透明度の値の配列です。配列の各エレメントに指定できる値は、0 ~ 1 です。例えば、.25 を指定すると、透明度の値として 25% が設定されます。 ratiosnull色分布比率の配列です。0 ~ 255 の範囲の値を指定できます。 コンストラクターです。 angle 角度(度数)です。45 角度(度数)です。指定できる値は 0 ~ 360 です。角度の値は、オブジェクトに対する架空の光源の角度を表し、オブジェクトに対する効果の相対位置を決定します。distance が 0 に設定されている場合、効果がオブジェクトからオフセットされないので、angle プロパティはオブジェクトに影響しません。 distance グローのオフセット距離です。4.0 グローのオフセット距離です。 entries グラデーションの塗りのパターンを定義する GradientEntry オブジェクトの配列です。[] グラデーションの塗りのパターンを定義する GradientEntry オブジェクトの配列です。 type フィルター効果の配置です。BitmapFilterType.INNER フィルター効果の配置です。指定できる値は、flash.filters.BitmapFilterType 定数です。
  • BitmapFilterType.OUTER - グローがオブジェクトの外側エッジに配置されます。
  • BitmapFilterType.INNER - グローがオブジェクトの内側エッジに配置されます。
  • BitmapFilterType.FULL - グローがオブジェクトの上に配置されます。
flash.filters.BitmapFilterType
BevelFilter BevelFilter クラスを使用すると、表示オブジェクトにベベル効果を追加できます。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"
  />
  
]]>
mx.filters:IBitmapFiltermx.filters:BaseDimensionFilter BevelFilter クラスを使用すると、表示オブジェクトにベベル効果を追加できます。ボタンなどのオブジェクトにベベル効果を適用すると 3 次元的に表現されます。異なるハイライトカラー、シャドウカラー、ベベルのぼかし量、ベベルの角度、ベベルの配置、ノックアウト効果を使用して、ベベルの外観をカスタマイズできます。このフィルターは、MovieClip、SimpleButton、TextField、Video オブジェクトなどの DisplayObject クラスから継承した表示オブジェクト、および BitmapData オブジェクトに適用できます。

新しいフィルターを作成するには、コンストラクター new BevelFilter() を使用します。フィルターの使用方法は、フィルターの適用先オブジェクトによって異なります。

  • ムービークリップ、テキストフィールド、ボタン、およびビデオにフィルターを適用する場合は、DisplayObject から継承した filters プロパティを使用します。オブジェクトの filters プロパティを設定しても、オブジェクトは変更されません。filters プロパティをクリアすることにより、フィルターを取り消すことができます。
  • BitmapData オブジェクトにフィルターを適用するには、BitmapData.applyFilter() メソッドを使用します。BitmapData オブジェクトで applyFilter() を呼び出すことによって、ソース BitmapData オブジェクトとフィルターオブジェクトが取得され、フィルターを適用したイメージが生成されます。

表示オブジェクトにフィルターを適用すると、オブジェクトの cacheAsBitmap プロパティの値が true に設定されます。すべてのフィルターを削除すると、cacheAsBitmap の元の値が復元されます。

このフィルターはステージの拡大 / 縮小に対応していますが、通常の拡大 / 縮小、回転、傾斜には対応していません。オブジェクト自体が拡大 / 縮小される場合(scaleXscaleY プロパティが 100% に設定されていない場合)、フィルターは拡大 / 縮小されません。フィルターが拡大 / 縮小されるのは、ユーザーがステージをズームインする場合のみです。

結果として得られるイメージが最大サイズを超えると、フィルターは適用されません。AIR 1.5 および Flash Player 10 における最大サイズは、幅または高さが 8,191 ピクセルで、合計のピクセル数は 16,777,215 ピクセルを超えないようにしてください(つまり、幅が 8,191 ピクセルのイメージでは、高さが 2,048 ピクセルになります)。例えば、フィルターが適用されたサイズの大きいムービークリップをズームインするとき、結果として得られるイメージが最大サイズを超える場合は、フィルターがオフになります。

flash.filters.BevelFilterflash.display.DisplayObject.filtersflash.display.DisplayObject.cacheAsBitmapflash.display.BitmapData.applyFilter()BevelFilter コンストラクターです。distance4.0ベベルのオフセット距離(ピクセル単位)です(浮動小数)。 angle45ベベルの角度(0 ~ 360 度)です。 highlightColor0xFFFFFFベベルのハイライトカラー 0xRRGGBB です。 highlightAlpha1.0ハイライトカラーのアルファ透明度の値です。0.0 ~ 1.0 の値を指定できます。例えば .25 と指定すると、透明度は 25% になります。 shadowColor0x000000ベベルのシャドウカラー 0xRRGGBB です。 shadowAlpha1.0シャドウカラーのアルファ透明度の値です。0.0 ~ 1.0 の値を指定できます。例えば .25 と指定すると、透明度は 25% になります。 blurX4.0水平方向のぼかし量(ピクセル単位)です。指定できる値は 0 ~ 255.0(浮動小数)です。 blurY4.0垂直方向のぼかし量(ピクセル単位)です。指定できる値は 0 ~ 255.0(浮動小数)です。 strength1インプリントの強さまたは広がりです。値が大きいほど、濃い色がインプリントされるので、ベベルと背景との間のコントラストが強くなります。指定できる値は 0 ~ 255.0 です。 quality1ベベルの品質です。指定できる値は 0 ~ 15 ですが、多くのアプリケーションでは flash.filters.BitmapFilterQuality 定数を使用できます。
  • BitmapFilterQuality.LOW
  • BitmapFilterQuality.MEDIUM
  • BitmapFilterQuality.HIGH

フィルターに設定された値が小さいほど、速くレンダリングできます。指定できる他の数値を使用すると、異なる効果を作り出すことができます。

typeinnerベベルの種類です。指定できる値は、次の flash.filters.BitmapFilterType 定数です。BitmapFilterType.INNERBitmapFilterType.OUTER、または BitmapFilterType.FULLknockoutfalsetrue の場合は、ノックアウト効果を適用します。その結果、オブジェクトの塗りが透明になり、ドキュメントの背景色が表示されます。
コンストラクターです。
flash.filters.BitmapFilterQualityflash.filters.BitmapFilterType
clone このフィルターオブジェクトのコピーを返します。元の BevelFilter インスタンスとプロパティがすべて同じである新しい BevelFilter インスタンスです。 このフィルターオブジェクトのコピーを返します。 angle ベベルの角度です。45 ベベルの角度です。有効な値の範囲は 0 ~ 360 です。角度の値は、オブジェクトに対する架空の光源の角度を表し、オブジェクトに対する効果の相対位置を決定します。distance プロパティが 0 に設定された場合、効果がオブジェクトからオフセットされないため、angle プロパティは適用されません。 distance ベベルのオフセット距離です。4 ベベルのオフセット距離です。この値はピクセル単位で指定します(浮動小数値)。 highlightAlpha ハイライトカラーのアルファ透明度の値です。1 ハイライトカラーのアルファ透明度の値です。値には、0 ~ 1 の正規化した値を指定します。例えば、.25 を指定すると、透明度の値として 25%が設定されます。 highlightColor ベベルのハイライトカラーです。0xFFFFFF ベベルのハイライトカラーです。指定できる値は、16 進数形式(0xRRGGBB)です。 shadowAlpha シャドウカラーのアルファ透明度の値です。1 シャドウカラーのアルファ透明度の値です。値には、0 ~ 1 の正規化した値を指定します。例えば、.25 を指定すると、透明度の値として 25%が設定されます。 shadowColor ベベルのシャドウカラーです。0x000000 ベベルのシャドウカラーです。指定できる値は、16 進数形式(0xRRGGBB)です。 type フィルター効果の配置です。BitmapFilterType.INNER フィルター効果の配置です。指定できる値は、flash.filters.BitmapFilterType 定数です。
  • BitmapFilterType.OUTER - グローがオブジェクトの外側エッジに配置されます。
  • BitmapFilterType.INNER - グローがオブジェクトの内側エッジに配置されます。これはデフォルトです。
  • BitmapFilterType.FULL - グローがオブジェクトの上に配置されます。
flash.filters.BitmapFilterType
GradientGlowFilter GradientGlowFilter クラスを使用すると、表示オブジェクトにグラデーショングロー効果を適用できます。The <s:GradientGlowFilter> tag inherits all of the tag attributes of its superclass and adds no tag attributes:

  <s:GradientGlowFilter/>
  
]]>
mx.filters:IBitmapFilterspark.filters:GradientFilter GradientGlowFilter クラスを使用すると、表示オブジェクトにグラデーショングロー効果を適用できます。グラデーショングローとは、制御可能なカラーグラデーションによるリアルな輝きです。グラデーショングローは、オブジェクトの内側エッジや外側エッジの周囲、またはオブジェクトの上に適用できます。このフィルターは、MovieClip、SimpleButton、TextField、Video オブジェクトなどの DisplayObject クラスから継承した表示オブジェクト、および BitmapData オブジェクトに適用できます。

フィルターの使用方法は、フィルターの適用先オブジェクトによって異なります。

  • 表示オブジェクトにフィルターを適用する場合は、filters プロパティを使用します。オブジェクトの filters プロパティを設定しても、オブジェクトは変更されません。filters プロパティをクリアすることにより、フィルターを取り消すことができます。
  • BitmapData オブジェクトにフィルターを適用するには、BitmapData.applyFilter() メソッドを使用します。BitmapData オブジェクトで applyFilter() を呼び出すことによって、ソース BitmapData オブジェクトとフィルターオブジェクトが取得され、フィルターを適用したイメージが生成されます。

表示オブジェクトにフィルターを適用すると、表示オブジェクトの cacheAsBitmap プロパティは true に設定されます。すべてのフィルターをクリアすると、cacheAsBitmap の元の値が復元されます。

このフィルターはステージの拡大 / 縮小に対応していますが、通常の拡大 / 縮小、回転、傾斜には対応していません。オブジェクト自体を拡大 / 縮小する場合(scaleXscaleY の値が 1.0 以外に設定されている場合)、フィルター効果は拡大 / 縮小されません。フィルターが拡大 / 縮小されるのは、ユーザーがステージをズームインする場合のみです。

結果として得られるイメージが最大サイズを超えると、フィルターは適用されません。AIR 1.5 および Flash Player 10 における最大サイズは、幅または高さが 8,191 ピクセルで、合計のピクセル数は 16,777,215 ピクセルを超えないようにしてください(つまり、幅が 8,191 ピクセルのイメージでは、高さが 2,048 ピクセルになります)。例えば、フィルターが適用されたサイズの大きいムービークリップをズームインするとき、結果として得られるイメージが最大サイズを超える場合は、フィルターがオフになります。

spark.filters.GlowFilterflash.filters.GradientGlowFilterflash.display.BitmapData.applyFilter()flash.display.DisplayObject.cacheAsBitmapflash.display.DisplayObject.filtersGradientGlowFilter コンストラクターです。distance4.0グローのオフセット距離です。 angle45角度(度数)です。指定できる値は 0 ~ 360 です。 colorsnullグラデーションを定義する色の配列です。例えば、赤は 0xFF0000、青は 0x0000FF などです。 alphasnullcolors 配列内の各色に対応するアルファ透明度の値の配列です。配列の各エレメントに指定できる値は、0 ~ 1 です。例えば、.25 と指定すると、アルファ透明度は 25% になります。 ratiosnull色分布比率の配列です。指定できる値は 0 ~ 255 です。各値は、100% でサンプリングされる色の幅の割合をパーセントで定義します。 blurX4.0水平方向のぼかし量。指定できる値は 0 ~ 255 です。1 以下の値を指定すると、元のイメージがそのままコピーされます。2 のべき乗(2、4、8、16、32 など)は、他の値と比べて速くレンダリングできるよう最適化されます。 blurY4.0垂直方向のぼかし量。指定できる値は 0 ~ 255 です。1 以下の値を指定すると、元のイメージがそのままコピーされます。2 のべき乗(2、4、8、16、32 など)は、他の値と比べて速くレンダリングできるよう最適化されます。 strength1インプリントの強さまたは広がりです。値が大きいほど、濃い色がインプリントされるので、グローと背景との間のコントラストが強くなります。指定できる値は 0 ~ 255 です。値が大きいほど、インプリントが濃くなります。値を 0 にすると、フィルターが適用されなくなります。 quality1フィルターを適用する回数。flash.filters.BitmapFilterQuality 定数を使用します。
  • BitmapFilterQuality.LOW
  • BitmapFilterQuality.MEDIUM
  • BitmapFilterQuality.HIGH

詳細については、quality プロパティの説明を参照してください。

typeouterフィルター効果の配置です。指定できる値は、flash.filters.BitmapFilterType 定数です。
  • BitmapFilterType.OUTER - グローがオブジェクトの外側エッジに配置されます。デフォルトです。
  • BitmapFilterType.INNER - グローがオブジェクトの内側エッジに配置されます。
  • BitmapFilterType.FULL - グローがオブジェクトの上に配置されます。
knockoutfalseオブジェクトにノックアウト効果を適用するかどうかを指定します。ノックアウト効果を適用すると、オブジェクトの塗りが透明になり、ドキュメントの背景色が表示されます。true を指定すると、ノックアウト効果が適用されます。デフォルトは false で、ノックアウト効果は適用されません。
コンストラクターです。
clone このフィルターオブジェクトのコピーを返します。元の GradientGlowFilter インスタンスとプロパティがすべて同じである新しい GradientGlowFilter インスタンスです。 このフィルターオブジェクトのコピーを返します。
DisplacementMapFilter DisplacementMapFilter クラスは、指定された BitmapData オブジェクト(置き換えマップイメージと言います)のピクセル値を使用して、オブジェクトの置き換え(変位)を実行します。The <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"
 />
 
]]>
mx.filters:IBitmapFiltermx.filters:BaseFilter DisplacementMapFilter クラスは、指定された BitmapData オブジェクト(置き換えマップイメージと言います)のピクセル値を使用して、オブジェクトの置き換え(変位)を実行します。このフィルターを使用して、MovieClip、SimpleButton、TextField、Video オブジェクトなどの DisplayObject クラスから継承したオブジェクト、および BitmapData オブジェクトにワープ効果や斑点効果を適用できます。

フィルターの使用方法は、フィルターの適用先オブジェクトによって異なります。

  • 表示オブジェクトにフィルターを適用する場合は、表示オブジェクトの filters プロパティを使用します。オブジェクトの filters プロパティを設定しても、オブジェクトは変更されません。filters プロパティをクリアすることにより、フィルターを取り消すことができます。
  • BitmapData オブジェクトにフィルターを適用するには、BitmapData.applyFilter() メソッドを使用します。BitmapData オブジェクトで applyFilter() を呼び出すことによって、ソース BitmapData オブジェクトとフィルターオブジェクトが取得され、フィルターを適用したイメージが生成されます。

表示オブジェクトにフィルターを適用すると、表示オブジェクトの 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))から取得します。

フィルターで使用するマップイメージは、ステージの拡大 / 縮小率に一致するように拡大 / 縮小されます。オブジェクト自体を拡大 / 縮小する場合には拡大 / 縮小されません。

このフィルターはステージの拡大 / 縮小に対応していますが、通常の拡大 / 縮小、回転、傾斜には対応していません。オブジェクト自体を拡大 / 縮小する場合(scaleXscaleY プロパティが 1.0 以外に設定されている場合)、フィルター効果は拡大 / 縮小されません。フィルターが拡大 / 縮小されるのは、ユーザーがステージをズームインする場合のみです。

flash.display.BitmapData.applyFilter()flash.display.DisplayObject.filtersflash.display.DisplayObject.cacheAsBitmapDisplacementMapFilter コンストラクターです。mapBitmapnull置き換えマップデータが含まれる BitmapData オブジェクトです。 mapPointnullマップイメージの左上隅を基準としたターゲット表示オブジェクトの左上隅のオフセットが含まれる値です。 componentX0x の結果を変位させる場合にどのカラーチャンネルをマップイメージで使用するかを指定します。指定できる値は、BitmapDataChannel 定数です。 componentY0y の結果を変位させる場合にどのカラーチャンネルをマップイメージで使用するかを指定します。指定できる値は、BitmapDataChannel 定数です。 scaleX0.0マップ計算の x 置き換え結果を拡大 / 縮小する場合に使用する乗数です。 scaleY0.0マップ計算の y 置き換え結果を拡大 / 縮小する場合に使用する乗数です。 modewrapフィルターのモードです。指定できる値は、DisplacementMapFilterMode 定数です。 color0範囲外置き換えの場合に使用する色を指定します。置き換えの有効範囲は 0.0 ~ 1.0 です。このパラメーターは、modeDisplacementMapFilterMode.COLOR に設定する場合に使用します。 alpha0.0範囲外置き換えの場合に使用するアルファ値を指定します。0.0 ~ 1.0 に正規化した値を指定します。例えば、.25 を指定すると、透明度の値として 25% が設定されます。このパラメーターは、modeDisplacementMapFilterMode.COLOR に設定する場合に使用します。 コンストラクターです。 flash.display.BitmapDataChannelflash.filters.DisplacementMapFilterModeclone このフィルターオブジェクトのコピーを返します。元のインスタンスと同じプロパティをすべて備えた新しい DisplacementMapFilter インスタンスです。 このフィルターオブジェクトのコピーを返します。 alpha 範囲外置き換えの場合に使用するアルファ透明度値を指定します。0 範囲外置き換えの場合に使用するアルファ透明度値を指定します。0.0 ~ 1.0 に正規化した値を指定します。例えば、.25 を指定すると、透明度の値として 25% が設定されます。デフォルト値は 0 です。mode プロパティが DisplacementMapFilterMode.COLOR に設定されている場合は、このプロパティを使用します。 color 範囲外置き換えの場合に使用する色を指定します。0x000000 範囲外置き換えの場合に使用する色を指定します。置き換えの有効範囲は 0.0 ~ 1.0 です。この値は、16 進数形式です。color のデフォルト値は 0 です。mode プロパティが DisplacementMapFilterMode.COLOR に設定されている場合は、このプロパティを使用します。 componentX x の結果を変位させる場合にどのカラーチャンネルをマップイメージで使用するかを指定します。0, meaning no channel. x の結果を変位させる場合にどのカラーチャンネルをマップイメージで使用するかを指定します。指定できる値は、BitmapDataChannel 定数です。
  • BitmapDataChannel.ALPHA
  • BitmapDataChannel.BLUE
  • BitmapDataChannel.GREEN
  • BitmapDataChannel.RED
flash.display.BitmapDataChannel
componentY y の結果を変位させる場合にどのカラーチャンネルをマップイメージで使用するかを指定します。0, meaning no channel. y の結果を変位させる場合にどのカラーチャンネルをマップイメージで使用するかを指定します。指定できる値は、BitmapDataChannel 定数です。
  • BitmapDataChannel.ALPHA
  • BitmapDataChannel.BLUE
  • BitmapDataChannel.GREEN
  • BitmapDataChannel.RED
mapBitmap 置き換えマップデータが含まれる BitmapData オブジェクトです。null 置き換えマップデータが含まれる BitmapData オブジェクトです。 mapPoint マップイメージの左上隅を基準としたターゲット表示オブジェクトの左上隅のオフセットが含まれる値です。null マップイメージの左上隅を基準としたターゲット表示オブジェクトの左上隅のオフセットが含まれる値です。 mode フィルターのモードです。DisplacementMapFilterMode.WRAP フィルターのモードです。指定できる値は、DisplacementMapFilterMode 定数です。
  • DisplacementMapFilterMode.WRAP - 置き換え値をソースイメージの反対側で折り返します。
  • DisplacementMapFilterMode.CLAMP - 置き換え値をソースイメージのエッジに固定します。
  • DisplacementMapFilterMode.IGNORE - 置き換え値が範囲外である場合、その置き換えを無視して、ソースピクセルを使用します。
  • DisplacementMapFilterMode.COLOR - 置き換え値がイメージの外にある場合、color プロパティと alpha プロパティの値を置き換えます。
scaleX マップ計算の x 置き換え結果を拡大 / 縮小する場合に使用する乗数です。0 マップ計算の x 置き換え結果を拡大 / 縮小する場合に使用する乗数です。 scaleY マップ計算の y 置き換え結果を拡大 / 縮小する場合に使用する乗数です。0 マップ計算の y 置き換え結果を拡大 / 縮小する場合に使用する乗数です。
ShaderFilter Flex ShaderFilter クラスを使用すると、Flash の ShaderFilter、Shader および ShaderData クラスを使用してフィルターとして Pixel Bender シェーダーを適用する場合の詳細事項の多くを考慮する必要がなくなります。The <s:ShaderFilter> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <s:ShaderFilter
    Properties
    bottomExtension="0"
    leftExtension="0"
    precisionHint="full"
    rightExtension="0"
    shader="[]"
    topExtension="0"
  />
  
]]>
mx.filters:IBitmapFilterflash.events:IEventDispatcherflash.utils:Proxy Flex ShaderFilter クラスを使用すると、Flash の ShaderFilter、Shader および ShaderData クラスを使用してフィルターとして Pixel Bender シェーダーを適用する場合の詳細事項の多くを考慮する必要がなくなります。

ShaderFilter クラスは、Shader オブジェクトのインスタンスまたは(Embed からなどの)Shader の Class の代理のいずれかを使用して初期化する必要があります。続いて、ShaderFilter クラスは基になる Shader に対するプロキシとして機能し、単純な名前付きプロパティとしてスカラーおよび多次元の両方のシェーダー入力パラメーターに直接アクセスするための便利なメカニズムを提供します。

単純なスカラーシェーダー入力パラメーター(FLOAT 型や INT 型など)を設定するには、myFilter.radius のように、プロパティを直接参照できます。

多次元シェーダー入力パラメーター(FLOAT2 など)の個別のコンポーネントを設定またはアニメーション化するには、プロパティ接尾辞の規則を使用して、個別の値に直接アクセスできます。次のコードは、FLOAT2 プロパティ center の 1 番目と 2 番目のコンポーネントを設定する 2 つの方法を示しています。

     // 'center' is an input parameter of type FLOAT2.
     shader.center = [10,20];
 
     // Use property suffix convention to access the first and second component of 'center'. 
     shader.center_x = 10;
     shader.center_y = 20;
 

サポートされていて使用できるすべてのプロパティ接尾辞は次のとおりです。

  • 型 BOOL2、BOOL3、BOOL4、FLOAT2、FLOAT3、FLOAT4、INT2、INT3、または INT4 のシェーダー入力パラメーターの場合、「r g b a」、「x y z w」、または「s t p q」を使用して、それぞれ 1 番目、2 番目、3 番目および 4 番目のコンポーネントにアクセスできます。
  • 型 MATRIX2x2、MATRIX3x3 または MATRIX4x4 のシェーダー入力パラメーターの場合、「a b c d e f g h i j k l m n o p」を使用して、特定のマトリックスのそれぞれ 1 番目から 16 番目のコンポーネントにアクセスできます。

ShaderFilter のプロパティは(アニメーション化中などに)変化するため、ShaderFilter は自動的に、適用先のビジュアルコンポーネントのフィルター配列に自身を再適用します。

単純な ShaderFilter の例: <?xml version="1.0"?> <s:Application xmlns:s="library://ns.adobe.com/flex/spark" xmlns:fx="http://ns.adobe.com/mxml/2009"> <!-- The hypothetical 'spherize' shader applied below has two input parameters, 'center' and 'radius' with the following attributes: parameter 'center' ==< type: float2 minValue: float2(-200,-200) maxValue: float2(800,500) defaultValue: float2(400,250) description: "displacement center" parameter 'radius' ==< type: float minValue: float(.1) maxValue: float(400) defaultValue: float(200) description: "radius" --> <s:Label text="ABCDEF"> <s:filters> <s:ShaderFilter shader="@Embed(source='shaders/spherize.pbj')" radius="25" center_x="50" center_y="15" /> </s:filters> </s:Label> </s:Application>
spark.effects.AnimateFilterShaderFilter コンストラクターです。shadernull完全に実現された flash.display.Shader インスタンスまたは Shader を表す Class(Embed からなど)です。 コンストラクターです。 bottomExtension 0 leftExtension 0 precisionHint 基になるシェーダーが実行する算術演算の精度です。ShaderPrecision.FULL 基になるシェーダーが実行する算術演算の精度です。precisionHint プロパティで使用可能な値セットは、ShaderPrecision クラスの定数によって定義されます。 flash.display.Shaderflash.display.ShaderPrecisionrightExtension 0 shader flash.display.Shader インスタンスです。 flash.display.Shader インスタンスです。 flash.display.ShadertopExtension 0
GlowFilter GlowFilter クラスを使用すると、表示オブジェクトにグロー効果を適用できます。The <s:GlowFilter> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <s:GlowFilter
    Properties
    alpha="1"
    color="0xFF0000"
    inner="false"
  />
  
]]>
mx.filters:IBitmapFiltermx.filters:BaseDimensionFilter GlowFilter クラスを使用すると、表示オブジェクトにグロー効果を適用できます。グローのスタイルには複数のオプションがあり、内側グロー、外側グロー、ノックアウトモードなどがあります。グローフィルターは、distance プロパティと angle プロパティを 0 に設定したドロップシャドウフィルターによく似ています。このフィルターは、MovieClip、SimpleButton、TextField、Video オブジェクトなどの DisplayObject クラスから継承した表示オブジェクト、および BitmapData オブジェクトに適用できます。

フィルターの使用方法は、フィルターの適用先オブジェクトによって異なります。

  • 表示オブジェクトにフィルターを適用する場合は、DisplayObject から継承した filters プロパティを使用します。オブジェクトの filters プロパティを設定しても、オブジェクトは変更されません。filters プロパティをクリアすることにより、フィルターを取り消すことができます。
  • BitmapData オブジェクトにフィルターを適用するには、BitmapData.applyFilter() メソッドを使用します。BitmapData オブジェクトで applyFilter() を呼び出すことによって、ソース BitmapData オブジェクトとフィルターオブジェクトが取得され、フィルターを適用したイメージが生成されます。

表示オブジェクトにフィルターを適用すると、表示オブジェクトの cacheAsBitmap プロパティは true に設定されます。すべてのフィルターをクリアすると、cacheAsBitmap の元の値が復元されます。

このフィルターはステージの拡大 / 縮小に対応していますが、通常の拡大 / 縮小、回転、傾斜には対応していません。オブジェクト自体が拡大 / 縮小される場合(scaleXscaleY プロパティの値が 1.0 以外に設定されている場合)、フィルターは拡大 / 縮小されません。フィルターが拡大 / 縮小されるのは、ユーザーがステージをズームインする場合のみです。

結果として得られるイメージが最大サイズを超えると、フィルターは適用されません。AIR 1.5 および Flash Player 10 における最大サイズは、幅または高さが 8,191 ピクセルで、合計のピクセル数は 16,777,215 ピクセルを超えないようにしてください(つまり、幅が 8,191 ピクセルのイメージでは、高さが 2,048 ピクセルになります)。例えば、フィルターが適用されたサイズの大きいムービークリップをズームインするとき、結果として得られるイメージが最大サイズを超える場合は、フィルターがオフになります。

flash.filters.GlowFilterflash.display.BitmapData.applyFilter()flash.display.DisplayObject.filtersflash.display.DisplayObject.cacheAsBitmapflash.display.DisplayObject.scaleXflash.display.DisplayObject.scaleYflash.filters.DropShadowFilter.distanceflash.filters.DropShadowFilter.angleGlowFilter コンストラクターです。color0xFF0000グローのカラーです。16 進数形式(0xRRGGBB)で指定します。デフォルト値は 0xFF0000 です。 alpha1.0カラーのアルファ透明度の値です。指定できる値は 0 ~ 1 です。例えば、.25 を指定すると、透明度の値として 25% が設定されます。 blurX4.0水平方向のぼかし量。指定できる値は 0 ~ 255(浮動小数)です。2 のべき乗(2、4、8、16、32 など)は、他の値と比べて速くレンダリングできるよう最適化されます。 blurY4.0垂直方向のぼかし量。指定できる値は 0 ~ 255(浮動小数)です。2 のべき乗(2、4、8、16、32 など)は、他の値と比べて速くレンダリングできるよう最適化されます。 strength1インプリントの強さまたは広がりです。値が大きいほど、濃い色がインプリントされるので、グローと背景との間のコントラストが強くなります。指定できる値は 0 ~ 255 です。 quality1フィルターを適用する回数。BitmapFilterQuality 定数を使用します。
  • BitmapFilterQuality.LOW
  • BitmapFilterQuality.MEDIUM
  • BitmapFilterQuality.HIGH

詳細については、quality プロパティの説明を参照してください。

innerfalseグローが内側グローであるかどうかを示します。true の場合は、内側グローであることを示します。値 false は外側グロー(オブジェクトの外周にあるグロー)を示します。 knockoutfalseオブジェクトにノックアウト効果を適用するかどうかを指定します。true を指定すると、オブジェクトの塗りが透明になり、ドキュメントの背景色が表示されます。
コンストラクターです。
BitmapFilterQuality
clone このフィルターオブジェクトのコピーを返します。元の GlowFilter インスタンスのプロパティをすべて備えた新しい GlowFilter インスタンスです。 このフィルターオブジェクトのコピーを返します。 alpha カラーのアルファ透明度の値です。1 カラーのアルファ透明度の値です。指定できる値は 0 ~ 1 です。例えば、.25 を指定すると、透明度の値として 25% が設定されます。 color グローのカラーを表します。0xFF0000 グローのカラーを表します。有効な値は、16 進数形式(0xRRGGBB)です。 inner グローが内側グローであるかどうかを示します。false グローが内側グローであるかどうかを示します。true の場合は、内側グローであることを示します。デフォルトは false(外側グロー)で、オブジェクトの外側のエッジにあるグローを示します。