package openfl.display {
import openfl.geom.Matrix;
/**
 * 	Defines a gradient fill.
 * 	Use a GraphicsGradientFill object with the `Graphics.drawGraphicsData()`
 * 	method. Drawing a GraphicsGradientFill object is the equivalent of calling
 * 	the `Graphics.beginGradientFill()` method.
 * 
 * 	@see [Using graphics data classes](https://books.openfl.org/openfl-developers-guide/using-the-drawing-api/advanced-use-of-the-drawing-api/using-graphics-data-classes.html)
 * 
 * @externs
 */
public class GraphicsGradientFill implements openfl.display.IGraphicsFill, openfl.display.IGraphicsData {
	/**
	 * 		Creates a new GraphicsGradientFill object.
	 * 
	 * 		@param type                A value from the GradientType class that
	 * 								   specifies which gradient type to use:
	 * 								   `GradientType.LINEAR` or
	 * 								   `GradientType.RADIAL`.
	 * 		@param matrix              A transformation matrix as defined by the
	 * 								   openfl.geom.Matrix class. The
	 * 								   openfl.geom.Matrix class includes a
	 * 								   `createGradientBox()` method, which lets
	 * 								   you conveniently set up the matrix for use
	 * 								   with the `beginGradientFill()` method.
	 * 		@param spreadMethod        A value from the SpreadMethod class that
	 * 								   specifies which spread method to use,
	 * 								   either: `SpreadMethod.PAD`,
	 * 								   `SpreadMethod.REFLECT`, or
	 * 								   `SpreadMethod.REPEAT`.
	 * 		@param interpolationMethod A value from the InterpolationMethod class
	 * 								   that specifies which value to use:
	 * 								   `InterpolationMethod.LINEAR_RGB` or
	 * 								   `InterpolationMethod.RGB`
	 * 		@param focalPointRatio     A number that controls the location of the
	 * 								   focal point of the gradient. A value of 0
	 * 								   sets the focal point in the center. A value
	 * 								   of 1 sets the focal point at one border of
	 * 								   the gradient circle. A value of -1 sets the
	 * 								   focal point at the other border of the
	 * 								   gradient circle. A value less than -1 or
	 * 								   greater than 1 is rounded to -1 or 1,
	 * 								   respectively.
	 * 	
	 */
	public function GraphicsGradientFill(type:String = undefined, colors:Array = undefined, alphas:Array = undefined, ratios:Array = undefined, matrix:openfl.geom.Matrix = undefined, spreadMethod:String = undefined, interpolationMethod:String = undefined, focalPointRatio:Number = undefined) {}
	/**
	 * 		An array of alpha values for the corresponding colors in the colors
	 * 		array. Valid values are between 0 and 1. If the value is less than 0,
	 * 		0 is used. If the value is greater than 1, 1 is used.
	 * 	
	 */
	public var alphas:Array;
	/**
	 * 		An array of RGB hexadecimal color values to use in the gradient. For
	 * 		example, red is 0xFF0000, blue is 0x0000FF, and so on. You can specify
	 * 		up to 15 colors. For each color, specify a corresponding value in the
	 * 		alphas and ratios properties.
	 * 	
	 */
	public var colors:Array;
	/**
	 * 		A number that controls the location of the focal point of the
	 * 		gradient. A value of 0 sets the focal point in the center. A value of
	 * 		1 means that the focal point is at one border of the gradient circle.A
	 * 		value of -1 sets the focal point at the other border of the gradient
	 * 		circle. A value of less than -1 or greater than 1 is rounded to -1 or
	 * 		1, respectively. For example, the following shows a `focalPointRatio`
	 * 		set to 0.75:
	 * 
	 * 		![radial gradient with focalPointRatio set to 0.75](/images/radial_sketch.jpg)
	 * 	
	 */
	public var focalPointRatio:Number;
	/**
	 * 		A value from the InterpolationMethod class that specifies which value
	 * 		to use. Valid values are: `InterpolationMethod.LINEAR_RGB` or
	 * 		`InterpolationMethod.RGB`
	 * 		For example, the following shows a simple linear gradient between two
	 * 		colors (with the `spreadMethod` parameter set to
	 * 		`SpreadMethod.REFLECT`). The different interpolation methods change
	 * 		the appearance as follows:
	 * 
	 * 		| `InterpolationMethod.LINEAR_RGB` | `InterpolationMethod.RGB` |
	 * 		| --- | --- |
	 * 		| ![linear gradient with InterpolationMethod.LINEAR_RGB](/images/beginGradientFill_interp_linearrgb.jpg) | ![linear gradient with InterpolationMethod.RGB](/images/beginGradientFill_interp_rgb.jpg) |
	 * 	
	 */
	public var interpolationMethod:String;
	/**
	 * 		A transformation matrix as defined by the Matrix class. The
	 * 		openfl.geom.Matrix class includes a `createGradientBox()` method to set
	 * 		up the matrix for use with the `beginGradientFill()` method.
	 * 	
	 */
	public var matrix:openfl.geom.Matrix;
	/**
	 * 		An array of color distribution ratios. Valid values are between 0 and
	 * 		255. This value defines the percentage of the width where the color is
	 * 		sampled at 100%. The value 0 represents the left position in the
	 * 		gradient box, and the value 255 represents the right position in the
	 * 		gradient box.
	 * 		**Note:** This value represents positions in the gradient box, not the
	 * 		coordinate space of the final gradient which can be wider or thinner
	 * 		than the gradient box. Specify a value for corresponding to each value
	 * 		in the `colors` property.
	 * 
	 * 		For example, for a linear gradient that includes two colors (blue and
	 * 		green) the following example illustrates the placement of the colors
	 * 		in the gradient based on different values in the `ratios` array:
	 * 
	 * 		| `ratios` | Gradient |
	 * 		| --- | --- |
	 * 		| `[0, 127]` | ![linear gradient blue to green with ratios 0 and 127](/images/gradient-ratios-1.jpg) |
	 * 		| `[0, 255]` | ![linear gradient blue to green with ratios 0 and 255](/images/gradient-ratios-2.jpg) |
	 * 		| `[127, 255]` | ![linear gradient blue to green with ratios 127 and 255](/images/gradient-ratios-3.jpg) |
	 * 
	 * 		The values in the array must increase sequentially; for example, `[0,
	 * 		63, 127, 190, 255]`.
	 * 	
	 */
	public var ratios:Array;
	/**
	 * 		A value from the SpreadMethod class that specifies which spread method
	 * 		to use. Valid values are: `SpreadMethod.PAD`, `SpreadMethod.REFLECT`,
	 * 		or `SpreadMethod.REPEAT`.
	 * 
	 * 		For example, the following shows a simple linear gradient between two
	 * 		colors:
	 * 
	 * 		```haxe
	 * 		import openfl.geom.*;
	 * 		import openfl.display.*;
	 * 
	 * 		var fillType = GradientType.LINEAR;
	 * 		var colors = [0xFF0000, 0x0000FF];
	 * 		var alphas = [1, 1];
	 * 		var ratios = [0x00, 0xFF];
	 * 		var matr = new Matrix();
	 * 		matr.createGradientBox(20, 20, 0, 0, 0);
	 * 		var spreadMethod = SpreadMethod.PAD;
	 * 		graphics.beginGradientFill(fillType, colors, alphas, ratios, matr, spreadMethod);
	 * 		graphics.drawRect(0,0,100,100);
	 * 		```
	 * 
	 * 		This example uses `SpreadMethod.PAD` for the spread method, and the
	 * 		gradient fill looks like the following:
	 * 
	 * 		![linear gradient with SpreadMethod.PAD](/images/beginGradientFill_spread_pad.jpg)
	 * 
	 * 		If you use `SpreadMethod.REFLECT` for the spread method, the gradient
	 * 		fill looks like the following:
	 * 
	 * 		![linear gradient with SpreadMethod.REFLECT](/images/beginGradientFill_spread_reflect.jpg)
	 * 
	 * 		If you use `SpreadMethod.REPEAT` for the spread method, the gradient
	 * 		fill looks like the following:
	 * 
	 * 		![linear gradient with SpreadMethod.REPEAT](/images/beginGradientFill_spread_repeat.jpg)
	 * 	
	 */
	public var spreadMethod:String;
	/**
	 * 		A value from the GradientType class that specifies which gradient type
	 * 		to use. Values are `GradientType.LINEAR` or `GradientType.RADIAL`.
	 * 	
	 */
	public var type:String;
}
}