openfl
Version:
A fast, productive library for 2D cross-platform development.
169 lines (148 loc) • 7.22 kB
TypeScript
import BitmapFilter from "./BitmapFilter";
declare namespace openfl.filters {
/**
* The GlowFilter class lets you apply a glow effect to display objects. You
* have several options for the style of the glow, including inner or outer
* glow and knockout mode. The glow filter is similar to the drop shadow
* filter with the `distance` and `angle` properties of
* the drop shadow filter set to 0. You can apply the filter to any display
* object(that is, objects that inherit from the DisplayObject class), such
* as MovieClip, SimpleButton, TextField, and Video objects, as well as to
* BitmapData objects.
*
* The use of filters depends on the object to which you apply the
* filter:
*
*
* * To apply filters to display objects, use the `filters`
* property(inherited from DisplayObject). Setting the `filters`
* property of an object does not modify the object, and you can remove the
* filter by clearing the `filters` property.
* * To apply filters to BitmapData objects, use the
* `BitmapData.applyFilter()` method. Calling
* `applyFilter()` on a BitmapData object takes the source
* BitmapData object and the filter object and generates a filtered image as a
* result.
*
*
* If you apply a filter to a display object, the
* `cacheAsBitmap` property of the display object is set to
* `true`. If you clear all filters, the original value of
* `cacheAsBitmap` is restored.
*
* This filter supports Stage scaling. However, it does not support general
* scaling, rotation, and skewing. If the object itself is scaled(if
* `scaleX` and `scaleY` are set to a value other than
* 1.0), the filter is not scaled. It is scaled only when the user zooms in on
* the Stage.
*
* A filter is not applied if the resulting image exceeds the maximum
* dimensions. In AIR 1.5 and Flash Player 10, the maximum is 8,191 pixels in
* width or height, and the total number of pixels cannot exceed 16,777,215
* pixels.(So, if an image is 8,191 pixels wide, it can only be 2,048 pixels
* high.) In Flash Player 9 and earlier and AIR 1.1 and earlier, the
* limitation is 2,880 pixels in height and 2,880 pixels in width. For
* example, if you zoom in on a large movie clip with a filter applied, the
* filter is turned off if the resulting image exceeds the maximum
* dimensions.
*/
/*@:final*/ export class GlowFilter extends BitmapFilter {
/**
* The alpha transparency value for the color. Valid values are 0 to 1. For
* example, .25 sets a transparency value of 25%. The default value is 1.
*/
public alpha:number;
/**
* The amount of horizontal blur. Valid values are 0 to 255(floating point).
* The default value is 6. Values that are a power of 2(such as 2, 4, 8, 16,
* and 32) are optimized to render more quickly than other values.
*/
public blurX:number;
/**
* The amount of vertical blur. Valid values are 0 to 255(floating point).
* The default value is 6. Values that are a power of 2(such as 2, 4, 8, 16,
* and 32) are optimized to render more quickly than other values.
*/
public blurY:number;
/**
* The color of the glow. Valid values are in the hexadecimal format
* 0x_RRGGBB_. The default value is 0xFF0000.
*/
public color:number;
/**
* Specifies whether the glow is an inner glow. The value `true`
* indicates an inner glow. The default is `false`, an outer glow
* (a glow around the outer edges of the object).
*/
public inner:boolean;
/**
* Specifies whether the object has a knockout effect. A value of
* `true` makes the object's fill transparent and reveals the
* background color of the document. The default value is `false`
* (no knockout effect).
*/
public knockout:boolean;
/**
* The number of times to apply the filter. The default value is
* `BitmapFilterQuality.LOW`, which is equivalent to applying the
* filter once. The value `BitmapFilterQuality.MEDIUM` applies the
* filter twice; the value `BitmapFilterQuality.HIGH` applies it
* three times. Filters with lower values are rendered more quickly.
*
* For most applications, a `quality` value of low, medium, or
* high is sufficient. Although you can use additional numeric values up to
* 15 to achieve different effects, higher values are rendered more slowly.
* Instead of increasing the value of `quality`, you can often get
* a similar effect, and with faster rendering, by simply increasing the
* values of the `blurX` and `blurY` properties.
*/
public quality:number;
/**
* The strength of the imprint or spread. The higher the value, the more
* color is imprinted and the stronger the contrast between the glow and the
* background. Valid values are 0 to 255. The default is 2.
*/
public strength:number;
/**
* Initializes a new GlowFilter instance with the specified parameters.
*
* @param color The color of the glow, in the hexadecimal format
* 0x_RRGGBB_. The default value is 0xFF0000.
* @param alpha The alpha transparency value for the color. Valid values
* are 0 to 1. For example, .25 sets a transparency value of
* 25%.
* @param blurX The amount of horizontal blur. Valid values are 0 to 255
* (floating point). Values that are a power of 2(such as 2,
* 4, 8, 16 and 32) are optimized to render more quickly than
* other values.
* @param blurY The amount of vertical blur. Valid values are 0 to 255
* (floating point). Values that are a power of 2(such as 2,
* 4, 8, 16 and 32) are optimized to render more quickly than
* other values.
* @param strength The strength of the imprint or spread. The higher the
* value, the more color is imprinted and the stronger the
* contrast between the glow and the background. Valid values
* are 0 to 255.
* @param quality The number of times to apply the filter. Use the
* BitmapFilterQuality constants:
*
* * `BitmapFilterQuality.LOW`
* * `BitmapFilterQuality.MEDIUM`
* * `BitmapFilterQuality.HIGH`
*
*
* For more information, see the description of the
* `quality` property.
* @param inner Specifies whether the glow is an inner glow. The value
* ` true` specifies an inner glow. The value
* `false` specifies an outer glow(a glow around
* the outer edges of the object).
* @param knockout Specifies whether the object has a knockout effect. The
* value `true` makes the object's fill
* transparent and reveals the background color of the
* document.
*/
public constructor (color?:number, alpha?:number, blurX?:number, blurY?:number, strength?:number, quality?:number, inner?:boolean, knockout?:boolean);
}
}
export default openfl.filters.GlowFilter;