Translate GDScript Code Examples to C# (C)

Translates Code Examples in classes beginning with `C`.

Includes:
 * Callable
 * CanvasItem
 * CharFXTransform
 * Color
 * ColorRect
 * ConfigFile
 * ConfirmationDialog
 * Control
 * Crypto

1 files changed, 187 insertions, 63 deletions

diff --git a/doc/classes/Color.xml b/doc/classes/Color.xml
index 850e95d5ef..1d249a253c 100644
--- a/doc/classes/Color.xml
+++ b/doc/classes/Color.xml
@@ -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>