2017-09-12 22:42:36 +02:00
<?xml version="1.0" encoding="UTF-8" ?>
2022-08-05 18:51:38 +02:00
<class name= "Gradient" inherits= "Resource" version= "3.6" xmlns:xsi= "http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation= "../class.xsd" >
2017-09-12 22:42:36 +02:00
<brief_description >
2019-06-22 01:04:47 +02:00
A color interpolator resource which can be used to generate colors between user-defined color points.
2017-09-12 22:42:36 +02:00
</brief_description>
<description >
2022-08-05 09:54:46 +02:00
Given a set of colors, this resource will interpolate them in order. This means that if you have color 1, color 2 and color 3, the gradient will interpolate from color 1 to color 2 and from color 2 to color 3. The gradient will initially have 2 colors (black and white), one (black) at gradient lower offset 0 and the other (white) at the gradient higher offset 1.
See also [Curve] which supports more complex easing methods, but does not support colors.
2017-09-12 22:42:36 +02:00
</description>
<tutorials >
</tutorials>
<methods >
<method name= "add_point" >
2021-07-30 15:28:05 +02:00
<return type= "void" />
<argument index= "0" name= "offset" type= "float" />
<argument index= "1" name= "color" type= "Color" />
2017-09-12 22:42:36 +02:00
<description >
2019-06-22 01:04:47 +02:00
Adds the specified color to the end of the ramp, with the specified offset.
2017-09-12 22:42:36 +02:00
</description>
</method>
2020-08-10 10:23:12 +02:00
<method name= "get_color" >
2021-07-30 15:28:05 +02:00
<return type= "Color" />
<argument index= "0" name= "point" type= "int" />
2017-09-12 22:42:36 +02:00
<description >
2019-06-22 01:04:47 +02:00
Returns the color of the ramp color at index [code]point[/code].
2017-09-12 22:42:36 +02:00
</description>
</method>
2020-08-10 10:23:12 +02:00
<method name= "get_offset" >
2021-07-30 15:28:05 +02:00
<return type= "float" />
<argument index= "0" name= "point" type= "int" />
2017-09-12 22:42:36 +02:00
<description >
2019-06-22 01:04:47 +02:00
Returns the offset of the ramp color at index [code]point[/code].
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "get_point_count" qualifiers= "const" >
2021-07-30 15:28:05 +02:00
<return type= "int" />
2017-09-12 22:42:36 +02:00
<description >
2019-06-22 01:04:47 +02:00
Returns the number of colors in the ramp.
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "interpolate" >
2021-07-30 15:28:05 +02:00
<return type= "Color" />
<argument index= "0" name= "offset" type= "float" />
2017-09-12 22:42:36 +02:00
<description >
2019-06-22 01:04:47 +02:00
Returns the interpolated color specified by [code]offset[/code].
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "remove_point" >
2021-07-30 15:28:05 +02:00
<return type= "void" />
<argument index= "0" name= "point" type= "int" />
2017-09-12 22:42:36 +02:00
<description >
2020-12-28 17:57:55 +01:00
Removes the color at the index [code]point[/code].
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "set_color" >
2021-07-30 15:28:05 +02:00
<return type= "void" />
<argument index= "0" name= "point" type= "int" />
<argument index= "1" name= "color" type= "Color" />
2017-09-12 22:42:36 +02:00
<description >
2019-06-22 01:04:47 +02:00
Sets the color of the ramp color at index [code]point[/code].
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "set_offset" >
2021-07-30 15:28:05 +02:00
<return type= "void" />
<argument index= "0" name= "point" type= "int" />
<argument index= "1" name= "offset" type= "float" />
2017-09-12 22:42:36 +02:00
<description >
2019-06-22 01:04:47 +02:00
Sets the offset for the ramp color at index [code]point[/code].
2017-09-12 22:42:36 +02:00
</description>
</method>
</methods>
<members >
2019-06-29 12:38:01 +02:00
<member name= "colors" type= "PoolColorArray" setter= "set_colors" getter= "get_colors" default= "PoolColorArray( 0, 0, 0, 1, 1, 1, 1, 1 )" >
2017-10-09 12:49:12 +02:00
Gradient's colors returned as a [PoolColorArray].
2017-09-12 22:42:36 +02:00
</member>
2022-05-12 19:51:56 +02:00
<member name= "interpolation_mode" type= "int" setter= "set_interpolation_mode" getter= "get_interpolation_mode" enum= "Gradient.InterpolationMode" default= "0" >
Defines how the colors between points of the gradient are interpolated. See [enum InterpolationMode] for available modes.
</member>
2019-06-29 12:38:01 +02:00
<member name= "offsets" type= "PoolRealArray" setter= "set_offsets" getter= "get_offsets" default= "PoolRealArray( 0, 1 )" >
2017-10-09 12:49:12 +02:00
Gradient's offsets returned as a [PoolRealArray].
2017-09-12 22:42:36 +02:00
</member>
</members>
<constants >
2022-05-12 19:51:56 +02:00
<constant name= "GRADIENT_INTERPOLATE_LINEAR" value= "0" enum= "InterpolationMode" >
Linear interpolation.
</constant>
<constant name= "GRADIENT_INTERPOLATE_CONSTANT" value= "1" enum= "InterpolationMode" >
Constant interpolation, color changes abruptly at each point and stays uniform between. This might cause visible aliasing when used for a gradient texture in some cases.
</constant>
<constant name= "GRADIENT_INTERPOLATE_CUBIC" value= "2" enum= "InterpolationMode" >
Cubic interpolation.
</constant>
2017-09-12 22:42:36 +02:00
</constants>
</class>