|
|
@@ -20,21 +20,39 @@
|
|
|
</argument>
|
|
|
<description>
|
|
|
Constructs a color from an HTML hexadecimal color string in RGB or RGBA format. See also [method @GDScript.ColorN].
|
|
|
- [codeblock]
|
|
|
+ [codeblocks]
|
|
|
+ [gdscript]
|
|
|
# Each of the following creates the same color RGBA(178, 217, 10, 255).
|
|
|
var c3 = Color("#b2d90a") # RGB format with "#".
|
|
|
var c4 = Color("b2d90a") # RGB format.
|
|
|
var c1 = Color("#b2d90aff") # RGBA format with "#".
|
|
|
var c2 = Color("b2d90aff") # RGBA format.
|
|
|
- [/codeblock]
|
|
|
+ [/gdscript]
|
|
|
+ [csharp]
|
|
|
+ // Each of the following creates the same color RGBA(178, 217, 10, 255).
|
|
|
+ var c3 = new Color("#b2d90a");
|
|
|
+ var c4 = new Color("b2d90a"); // RGB format.
|
|
|
+ var c1 = new Color("#b2d90aff");
|
|
|
+ var c2 = new Color("b2d90aff"); // RGBA format.
|
|
|
+ [/csharp]
|
|
|
+ [/codeblocks]
|
|
|
You can also use the "web color" short-hand form by only using 3 or 4 digits.
|
|
|
- [codeblock]
|
|
|
+ [codeblocks]
|
|
|
+ [gdscript]
|
|
|
# Each of the following creates the same color RGBA(17, 34, 51, 255).
|
|
|
var c3 = Color("#123") # RGB format with "#".
|
|
|
var c4 = Color("123") # RGB format.
|
|
|
var c1 = Color("#123f") # RGBA format with "#".
|
|
|
var c2 = Color("123f") # RGBA format.
|
|
|
- [/codeblock]
|
|
|
+ [/gdscript]
|
|
|
+ [csharp]
|
|
|
+ // Each of the following creates the same color RGBA(17, 34, 51, 255).
|
|
|
+ var c3 = new Color("#123");
|
|
|
+ var c4 = new Color("123"); // RGB format.
|
|
|
+ var c1 = new Color("#123f");
|
|
|
+ var c2 = new Color("123f"); // RGBA format.
|
|
|
+ [/csharp]
|
|
|
+ [/codeblocks]
|
|
|
</description>
|
|
|
</method>
|
|
|
<method name="Color">
|
|
|
@@ -44,9 +62,14 @@
|
|
|
</argument>
|
|
|
<description>
|
|
|
Constructs a color from a 32-bit integer (each byte represents a component of the RGBA profile).
|
|
|
- [codeblock]
|
|
|
+ [codeblocks]
|
|
|
+ [gdscript]
|
|
|
var c = Color(274) # Equivalent to RGBA(0, 0, 1, 18)
|
|
|
- [/codeblock]
|
|
|
+ [/gdscript]
|
|
|
+ [csharp]
|
|
|
+ var c = new Color(274); // Equivalent to RGBA(0, 0, 1, 18)
|
|
|
+ [/csharp]
|
|
|
+ [/codeblocks]
|
|
|
</description>
|
|
|
</method>
|
|
|
<method name="Color">
|
|
|
@@ -58,9 +81,14 @@
|
|
|
</argument>
|
|
|
<description>
|
|
|
Constructs a color from an existing color, but with a custom alpha value.
|
|
|
- [codeblock]
|
|
|
+ [codeblocks]
|
|
|
+ [gdscript]
|
|
|
var red = Color(Color.red, 0.5) # 50% transparent red.
|
|
|
- [/codeblock]
|
|
|
+ [/gdscript]
|
|
|
+ [csharp]
|
|
|
+ var red = new Color(Colors.Red, 0.5f); // 50% transparent red.
|
|
|
+ [/csharp]
|
|
|
+ [/codeblocks]
|
|
|
</description>
|
|
|
</method>
|
|
|
<method name="Color">
|
|
|
@@ -74,9 +102,14 @@
|
|
|
</argument>
|
|
|
<description>
|
|
|
Constructs a color from an RGB profile using values between 0 and 1. Alpha will always be 1.
|
|
|
- [codeblock]
|
|
|
- var c = Color(0.2, 1.0, 0.7) # Equivalent to RGBA(51, 255, 178, 255)
|
|
|
- [/codeblock]
|
|
|
+ [codeblocks]
|
|
|
+ [gdscript]
|
|
|
+ var color = Color(0.2, 1.0, 0.7) # Equivalent to RGBA(51, 255, 178, 255)
|
|
|
+ [/gdscript]
|
|
|
+ [csharp]
|
|
|
+ var color = new Color(0.2f, 1.0f, 0.7f); // Equivalent to RGBA(51, 255, 178, 255)
|
|
|
+ [/csharp]
|
|
|
+ [/codeblocks]
|
|
|
</description>
|
|
|
</method>
|
|
|
<method name="Color">
|
|
|
@@ -92,9 +125,14 @@
|
|
|
</argument>
|
|
|
<description>
|
|
|
Constructs a color from an RGBA profile using values between 0 and 1.
|
|
|
- [codeblock]
|
|
|
- var c = Color(0.2, 1.0, 0.7, 0.8) # Equivalent to RGBA(51, 255, 178, 204)
|
|
|
- [/codeblock]
|
|
|
+ [codeblocks]
|
|
|
+ [gdscript]
|
|
|
+ var color = Color(0.2, 1.0, 0.7, 0.8) # Equivalent to RGBA(51, 255, 178, 204)
|
|
|
+ [/gdscript]
|
|
|
+ [csharp]
|
|
|
+ var color = new Color(0.2f, 1.0f, 0.7f, 0.8f); // Equivalent to RGBA(51, 255, 178, 255, 204)
|
|
|
+ [/csharp]
|
|
|
+ [/codeblocks]
|
|
|
</description>
|
|
|
</method>
|
|
|
<method name="blend">
|
|
|
@@ -104,11 +142,18 @@
|
|
|
</argument>
|
|
|
<description>
|
|
|
Returns a new color resulting from blending this color over another. If the color is opaque, the result is also opaque. The second color may have a range of alpha values.
|
|
|
- [codeblock]
|
|
|
+ [codeblocks]
|
|
|
+ [gdscript]
|
|
|
var bg = Color(0.0, 1.0, 0.0, 0.5) # Green with alpha of 50%
|
|
|
var fg = Color(1.0, 0.0, 0.0, 0.5) # Red with alpha of 50%
|
|
|
var blended_color = bg.blend(fg) # Brown with alpha of 75%
|
|
|
- [/codeblock]
|
|
|
+ [/gdscript]
|
|
|
+ [csharp]
|
|
|
+ var bg = new Color(0.0f, 1.0f, 0.0f, 0.5f); // Green with alpha of 50%
|
|
|
+ var fg = new Color(1.0f, 0.0f, 0.0f, 0.5f); // Red with alpha of 50%
|
|
|
+ Color blendedColor = bg.Blend(fg); // Brown with alpha of 75%
|
|
|
+ [/csharp]
|
|
|
+ [/codeblocks]
|
|
|
</description>
|
|
|
</method>
|
|
|
<method name="contrasted">
|
|
|
@@ -116,10 +161,16 @@
|
|
|
</return>
|
|
|
<description>
|
|
|
Returns the most contrasting color.
|
|
|
- [codeblock]
|
|
|
- var c = Color(0.3, 0.4, 0.9)
|
|
|
- var contrasted_color = c.contrasted() # Equivalent to RGBA(204, 229, 102, 255)
|
|
|
- [/codeblock]
|
|
|
+ [codeblocks]
|
|
|
+ [gdscript]
|
|
|
+ var color = Color(0.3, 0.4, 0.9)
|
|
|
+ var contrasted_color = color.contrasted() # Equivalent to RGBA(204, 229, 102, 255)
|
|
|
+ [/gdscript]
|
|
|
+ [csharp]
|
|
|
+ var color = new Color(0.3f, 0.4f, 0.9f);
|
|
|
+ Color contrastedColor = color.Contrasted(); // Equivalent to RGBA(204, 229, 102, 255)
|
|
|
+ [/csharp]
|
|
|
+ [/codeblocks]
|
|
|
</description>
|
|
|
</method>
|
|
|
<method name="darkened">
|
|
|
@@ -129,10 +180,16 @@
|
|
|
</argument>
|
|
|
<description>
|
|
|
Returns a new color resulting from making this color darker by the specified percentage (ratio from 0 to 1).
|
|
|
- [codeblock]
|
|
|
+ [codeblocks]
|
|
|
+ [gdscript]
|
|
|
var green = Color(0.0, 1.0, 0.0)
|
|
|
var darkgreen = green.darkened(0.2) # 20% darker than regular green
|
|
|
- [/codeblock]
|
|
|
+ [/gdscript]
|
|
|
+ [csharp]
|
|
|
+ var green = new Color(0.0f, 1.0f, 0.0f);
|
|
|
+ Color darkgreen = green.Darkened(0.2f); // 20% darker than regular green
|
|
|
+ [/csharp]
|
|
|
+ [/codeblocks]
|
|
|
</description>
|
|
|
</method>
|
|
|
<method name="from_hsv">
|
|
|
@@ -148,9 +205,14 @@
|
|
|
</argument>
|
|
|
<description>
|
|
|
Constructs a color from an HSV profile. [code]h[/code], [code]s[/code], and [code]v[/code] are values between 0 and 1.
|
|
|
- [codeblock]
|
|
|
- var c = Color.from_hsv(0.58, 0.5, 0.79, 0.8) # Equivalent to HSV(210, 50, 79, 0.8) or Color8(100, 151, 201, 0.8)
|
|
|
- [/codeblock]
|
|
|
+ [codeblocks]
|
|
|
+ [gdscript]
|
|
|
+ var color = Color.from_hsv(0.58, 0.5, 0.79, 0.8) # Equivalent to HSV(210, 50, 79, 0.8) or Color8(100, 151, 201, 0.8)
|
|
|
+ [/gdscript]
|
|
|
+ [csharp]
|
|
|
+ Color color = Color.FromHsv(0.58f, 0.5f, 0.79f, 0.8f); // Equivalent to HSV(210, 50, 79, 0.8) or Color8(100, 151, 201, 0.8)
|
|
|
+ [/csharp]
|
|
|
+ [/codeblocks]
|
|
|
</description>
|
|
|
</method>
|
|
|
<method name="inverted">
|
|
|
@@ -158,10 +220,16 @@
|
|
|
</return>
|
|
|
<description>
|
|
|
Returns the inverted color [code](1 - r, 1 - g, 1 - b, a)[/code].
|
|
|
- [codeblock]
|
|
|
- var c = Color(0.3, 0.4, 0.9)
|
|
|
- var inverted_color = c.inverted() # A color of an RGBA(178, 153, 26, 255)
|
|
|
- [/codeblock]
|
|
|
+ [codeblocks]
|
|
|
+ [gdscript]
|
|
|
+ var color = Color(0.3, 0.4, 0.9)
|
|
|
+ var inverted_color = color.inverted() # A color of an RGBA(178, 153, 26, 255)
|
|
|
+ [/gdscript]
|
|
|
+ [csharp]
|
|
|
+ var color = new Color(0.3f, 0.4f, 0.9f);
|
|
|
+ Color invertedColor = color.Inverted(); // A color of an RGBA(178, 153, 26, 255)
|
|
|
+ [/csharp]
|
|
|
+ [/codeblocks]
|
|
|
</description>
|
|
|
</method>
|
|
|
<method name="is_equal_approx">
|
|
|
@@ -182,11 +250,18 @@
|
|
|
</argument>
|
|
|
<description>
|
|
|
Returns the linear interpolation with another color. The interpolation factor [code]t[/code] is between 0 and 1.
|
|
|
- [codeblock]
|
|
|
+ [codeblocks]
|
|
|
+ [gdscript]
|
|
|
var c1 = Color(1.0, 0.0, 0.0)
|
|
|
var c2 = Color(0.0, 1.0, 0.0)
|
|
|
- var li_c = c1.lerp(c2, 0.5) # A color of an RGBA(128, 128, 0, 255)
|
|
|
- [/codeblock]
|
|
|
+ var lerp_color = c1.lerp(c2, 0.5) # A color of an RGBA(128, 128, 0, 255)
|
|
|
+ [/gdscript]
|
|
|
+ [csharp]
|
|
|
+ var c1 = new Color(1.0f, 0.0f, 0.0f);
|
|
|
+ var c2 = new Color(0.0f, 1.0f, 0.0f);
|
|
|
+ Color lerpColor = c1.Lerp(c2, 0.5f); // A color of an RGBA(128, 128, 0, 255)
|
|
|
+ [/csharp]
|
|
|
+ [/codeblocks]
|
|
|
</description>
|
|
|
</method>
|
|
|
<method name="lightened">
|
|
|
@@ -196,10 +271,16 @@
|
|
|
</argument>
|
|
|
<description>
|
|
|
Returns a new color resulting from making this color lighter by the specified percentage (ratio from 0 to 1).
|
|
|
- [codeblock]
|
|
|
+ [codeblocks]
|
|
|
+ [gdscript]
|
|
|
var green = Color(0.0, 1.0, 0.0)
|
|
|
var lightgreen = green.lightened(0.2) # 20% lighter than regular green
|
|
|
- [/codeblock]
|
|
|
+ [/gdscript]
|
|
|
+ [csharp]
|
|
|
+ var green = new Color(0.0f, 1.0f, 0.0f);
|
|
|
+ Color lightgreen = green.Lightened(0.2f); // 20% lighter than regular green
|
|
|
+ [/csharp]
|
|
|
+ [/codeblocks]
|
|
|
</description>
|
|
|
</method>
|
|
|
<method name="to_abgr32">
|
|
|
@@ -207,10 +288,16 @@
|
|
|
</return>
|
|
|
<description>
|
|
|
Returns the color's 32-bit integer in ABGR format (each byte represents a component of the ABGR profile). ABGR is the reversed version of the default format.
|
|
|
- [codeblock]
|
|
|
- var c = Color(1, 0.5, 0.2)
|
|
|
- print(c.to_abgr32()) # Prints 4281565439
|
|
|
- [/codeblock]
|
|
|
+ [codeblocks]
|
|
|
+ [gdscript]
|
|
|
+ var color = Color(1, 0.5, 0.2)
|
|
|
+ print(color.to_abgr32()) # Prints 4281565439
|
|
|
+ [/gdscript]
|
|
|
+ [csharp]
|
|
|
+ var color = new Color(1.0f, 0.5f, 0.2f);
|
|
|
+ GD.Print(color.ToAbgr32()); // Prints 4281565439
|
|
|
+ [/csharp]
|
|
|
+ [/codeblocks]
|
|
|
</description>
|
|
|
</method>
|
|
|
<method name="to_abgr64">
|
|
|
@@ -218,10 +305,16 @@
|
|
|
</return>
|
|
|
<description>
|
|
|
Returns the color's 64-bit integer in ABGR format (each word represents a component of the ABGR profile). ABGR is the reversed version of the default format.
|
|
|
- [codeblock]
|
|
|
- var c = Color(1, 0.5, 0.2)
|
|
|
- print(c.to_abgr64()) # Prints -225178692812801
|
|
|
- [/codeblock]
|
|
|
+ [codeblocks]
|
|
|
+ [gdscript]
|
|
|
+ var color = Color(1, 0.5, 0.2)
|
|
|
+ print(color.to_abgr64()) # Prints -225178692812801
|
|
|
+ [/gdscript]
|
|
|
+ [csharp]
|
|
|
+ var color = new Color(1.0f, 0.5f, 0.2f);
|
|
|
+ GD.Print(color.ToAbgr64()); // Prints -225178692812801
|
|
|
+ [/csharp]
|
|
|
+ [/codeblocks]
|
|
|
</description>
|
|
|
</method>
|
|
|
<method name="to_argb32">
|
|
|
@@ -229,10 +322,16 @@
|
|
|
</return>
|
|
|
<description>
|
|
|
Returns the color's 32-bit integer in ARGB format (each byte represents a component of the ARGB profile). ARGB is more compatible with DirectX.
|
|
|
- [codeblock]
|
|
|
- var c = Color(1, 0.5, 0.2)
|
|
|
- print(c.to_argb32()) # Prints 4294934323
|
|
|
- [/codeblock]
|
|
|
+ [codeblocks]
|
|
|
+ [gdscript]
|
|
|
+ var color = Color(1, 0.5, 0.2)
|
|
|
+ print(color.to_argb32()) # Prints 4294934323
|
|
|
+ [/gdscript]
|
|
|
+ [csharp]
|
|
|
+ var color = new Color(1.0f, 0.5f, 0.2f);
|
|
|
+ GD.Print(color.ToArgb32()); // Prints 4294934323
|
|
|
+ [/csharp]
|
|
|
+ [/codeblocks]
|
|
|
</description>
|
|
|
</method>
|
|
|
<method name="to_argb64">
|
|
|
@@ -240,10 +339,16 @@
|
|
|
</return>
|
|
|
<description>
|
|
|
Returns the color's 64-bit integer in ARGB format (each word represents a component of the ARGB profile). ARGB is more compatible with DirectX.
|
|
|
- [codeblock]
|
|
|
- var c = Color(1, 0.5, 0.2)
|
|
|
- print(c.to_argb64()) # Prints -2147470541
|
|
|
- [/codeblock]
|
|
|
+ [codeblocks]
|
|
|
+ [gdscript]
|
|
|
+ var color = Color(1, 0.5, 0.2)
|
|
|
+ print(color.to_argb64()) # Prints -2147470541
|
|
|
+ [/gdscript]
|
|
|
+ [csharp]
|
|
|
+ var color = new Color(1.0f, 0.5f, 0.2f);
|
|
|
+ GD.Print(color.ToArgb64()); // Prints -2147470541
|
|
|
+ [/csharp]
|
|
|
+ [/codeblocks]
|
|
|
</description>
|
|
|
</method>
|
|
|
<method name="to_html">
|
|
|
@@ -254,11 +359,18 @@
|
|
|
<description>
|
|
|
Returns the color's HTML hexadecimal color string in RGBA format (ex: [code]ff34f822[/code]).
|
|
|
Setting [code]with_alpha[/code] to [code]false[/code] excludes alpha from the hexadecimal string (and uses RGB instead of RGBA format).
|
|
|
- [codeblock]
|
|
|
- var c = Color(1, 1, 1, 0.5)
|
|
|
- var s1 = c.to_html() # Returns "ffffff7f"
|
|
|
- var s2 = c.to_html(false) # Returns "ffffff"
|
|
|
- [/codeblock]
|
|
|
+ [codeblocks]
|
|
|
+ [gdscript]
|
|
|
+ var color = Color(1, 1, 1, 0.5)
|
|
|
+ var with_alpha = color.to_html() # Returns "ffffff7f"
|
|
|
+ var without_alpha = color.to_html(false) # Returns "ffffff"
|
|
|
+ [/gdscript]
|
|
|
+ [csharp]
|
|
|
+ var color = new Color(1, 1, 1, 0.5f);
|
|
|
+ String withAlpha = color.ToHtml(); // Returns "ffffff7f"
|
|
|
+ String withoutAlpha = color.ToHtml(false); // Returns "ffffff"
|
|
|
+ [/csharp]
|
|
|
+ [/codeblocks]
|
|
|
</description>
|
|
|
</method>
|
|
|
<method name="to_rgba32">
|
|
|
@@ -266,10 +378,16 @@
|
|
|
</return>
|
|
|
<description>
|
|
|
Returns the color's 32-bit integer in RGBA format (each byte represents a component of the RGBA profile). RGBA is Godot's default format.
|
|
|
- [codeblock]
|
|
|
- var c = Color(1, 0.5, 0.2)
|
|
|
- print(c.to_rgba32()) # Prints 4286526463
|
|
|
- [/codeblock]
|
|
|
+ [codeblocks]
|
|
|
+ [gdscript]
|
|
|
+ var color = Color(1, 0.5, 0.2)
|
|
|
+ print(color.to_rgba32()) # Prints 4286526463
|
|
|
+ [/gdscript]
|
|
|
+ [csharp]
|
|
|
+ var color = new Color(1, 0.5f, 0.2f);
|
|
|
+ GD.Print(color.ToRgba32()); // Prints 4286526463
|
|
|
+ [/csharp]
|
|
|
+ [/codeblocks]
|
|
|
</description>
|
|
|
</method>
|
|
|
<method name="to_rgba64">
|
|
|
@@ -277,10 +395,16 @@
|
|
|
</return>
|
|
|
<description>
|
|
|
Returns the color's 64-bit integer in RGBA format (each word represents a component of the RGBA profile). RGBA is Godot's default format.
|
|
|
- [codeblock]
|
|
|
- var c = Color(1, 0.5, 0.2)
|
|
|
- print(c.to_rgba64()) # Prints -140736629309441
|
|
|
- [/codeblock]
|
|
|
+ [codeblocks]
|
|
|
+ [gdscript]
|
|
|
+ var color = Color(1, 0.5, 0.2)
|
|
|
+ print(color.to_rgba64()) # Prints -140736629309441
|
|
|
+ [/gdscript]
|
|
|
+ [csharp]
|
|
|
+ var color = new Color(1, 0.5f, 0.2f);
|
|
|
+ GD.Print(color.ToRgba64()); // Prints -140736629309441
|
|
|
+ [/csharp]
|
|
|
+ [/codeblocks]
|
|
|
</description>
|
|
|
</method>
|
|
|
</methods>
|