From 66e341a7b2d0c4e9e16c7b9ca014bb34c35cc223 Mon Sep 17 00:00:00 2001
From: dhruvjanghu <janghudhruv@gmail.com>
Date: Mon, 6 Oct 2025 02:19:44 +1100
Subject: [PATCH] Added split_text usage example in all languages with
 consistent visuals and structure

---
 .../utilities/split_text-1-example-oop.cs     |  82 ++++++++++++++++++
 .../split_text-1-example-top-level.cs         |  53 +++++++++++
 .../utilities/split_text-1-example.cpp        |  56 ++++++++++++
 .../utilities/split_text-1-example.png        | Bin 0 -> 6855 bytes
 .../utilities/split_text-1-example.py         |  45 ++++++++++
 .../utilities/split_text-1-example.txt        |   1 +
 6 files changed, 237 insertions(+)
 create mode 100644 public/usage-examples/utilities/split_text-1-example-oop.cs
 create mode 100644 public/usage-examples/utilities/split_text-1-example-top-level.cs
 create mode 100644 public/usage-examples/utilities/split_text-1-example.cpp
 create mode 100644 public/usage-examples/utilities/split_text-1-example.png
 create mode 100644 public/usage-examples/utilities/split_text-1-example.py
 create mode 100644 public/usage-examples/utilities/split_text-1-example.txt

diff --git a/public/usage-examples/utilities/split_text-1-example-oop.cs b/public/usage-examples/utilities/split_text-1-example-oop.cs
new file mode 100644
index 000000000..30c1af678
--- /dev/null
+++ b/public/usage-examples/utilities/split_text-1-example-oop.cs
@@ -0,0 +1,82 @@
+using System;
+using SplashKitSDK;
+
+namespace SplitTextExample
+{
+    public class SplitText
+    {
+        private Window _window;
+        private string _text;
+        private string[] _parts;
+        private Color _topColor;
+        private Color _bottomColor;
+
+        public SplitText()
+        {
+            // creating window
+            _window = new Window("Split Text Example", 800, 400);
+
+            // I am defining the text to split
+            _text = "apple,banana,carrot";
+
+            // I am splitting the string into parts using SplashKit's split() function
+            _parts = SplashKit.Split(_text, ',');
+
+            // colors for background gradient
+            _topColor = SplashKit.RGBColor(245, 251, 255);
+            _bottomColor = SplashKit.RGBColor(200, 230, 255);
+        }
+
+        private Color BlendColors(Color c1, Color c2, double t)
+        {
+            // linear interpolation for RGB channels
+            int r = (int)((1 - t) * SplashKit.RedOf(c1) + t * SplashKit.RedOf(c2));
+            int g = (int)((1 - t) * SplashKit.GreenOf(c1) + t * SplashKit.GreenOf(c2));
+            int b = (int)((1 - t) * SplashKit.BlueOf(c1) + t * SplashKit.BlueOf(c2));
+            return SplashKit.RGBColor(r, g, b);
+        }
+
+        public void Run()
+        {
+            while (!SplashKit.QuitRequested())
+            {
+                SplashKit.ProcessEvents();
+
+                // draw gradient background
+                for (int y = 0; y < _window.Height; y++)
+                {
+                    double t = (double)y / _window.Height;
+                    Color blended = BlendColors(_topColor, _bottomColor, t);
+                    SplashKit.DrawLine(blended, 0, y, _window.Width, y);
+                }
+
+                // display text
+                SplashKit.DrawText("Original string:", SplashKit.ColorDarkBlue(), "arial", 20, 60, 50);
+                SplashKit.DrawText(_text, SplashKit.ColorBlack(), "arial", 20, 280, 50);
+
+                int yPos = 130;
+                foreach (string s in _parts)
+                {
+                    SplashKit.DrawText("Token: " + s, SplashKit.ColorBlack(), "arial", 18, 60, yPos);
+                    yPos += 40;
+                }
+
+                SplashKit.DrawText("Press ESC to exit", SplashKit.ColorGray(), "arial", 14, 620, 360);
+                _window.Refresh(60);
+
+                if (SplashKit.KeyTyped(KeyCode.EscapeKey))
+                {
+                    break;
+                }
+            }
+
+            _window.Close();
+        }
+
+        public static void Main()
+        {
+            SplitText demo = new SplitText();
+            demo.Run();
+        }
+    }
+}
diff --git a/public/usage-examples/utilities/split_text-1-example-top-level.cs b/public/usage-examples/utilities/split_text-1-example-top-level.cs
new file mode 100644
index 000000000..bf8c81b0b
--- /dev/null
+++ b/public/usage-examples/utilities/split_text-1-example-top-level.cs
@@ -0,0 +1,53 @@
+using SplashKitSDK;
+using static SplashKitSDK.SplashKit;
+
+Color BlendColors(Color c1, Color c2, double t)
+{
+    // linear interpolation for RGB channels
+    int r = (int)((1 - t) * RedOf(c1) + t * RedOf(c2));
+    int g = (int)((1 - t) * GreenOf(c1) + t * GreenOf(c2));
+    int b = (int)((1 - t) * BlueOf(c1) + t * BlueOf(c2));
+    return RGBColor(r, g, b);
+}
+
+OpenWindow("Split Text Example", 800, 400);
+
+// I am defining the text to split
+string text = "apple,banana,carrot";
+
+// I am splitting the string into parts using SplashKit's split() function
+string[] parts = Split(text, ',');
+
+// I am drawing a gradient background manually
+Color top = RGBColor(245, 251, 255);
+Color bottom = RGBColor(200, 230, 255);
+
+for (int y = 0; y < 400; y++)
+{
+    double t = (double)y / 400.0;
+    Color blended = BlendColors(top, bottom, t);
+    DrawLine(blended, 0, y, 800, y);
+}
+
+DrawText("Original string:", ColorDarkBlue(), "arial", 20, 60, 50);
+DrawText(text, ColorBlack(), "arial", 20, 280, 50);
+
+// I am printing each token from the split result
+int yPos = 130;
+foreach (string s in parts)
+{
+    DrawText("Token: " + s, ColorBlack(), "arial", 18, 60, yPos);
+    yPos += 40;
+}
+
+DrawText("Press ESC to exit", ColorGray(), "arial", 14, 620, 360);
+RefreshScreen();
+
+// wait for quit event
+while (!QuitRequested())
+{
+    ProcessEvents();
+    if (KeyTyped(KeyCode.EscapeKey)) break;
+}
+
+CloseAllWindows();
\ No newline at end of file
diff --git a/public/usage-examples/utilities/split_text-1-example.cpp b/public/usage-examples/utilities/split_text-1-example.cpp
new file mode 100644
index 000000000..4ecbcb380
--- /dev/null
+++ b/public/usage-examples/utilities/split_text-1-example.cpp
@@ -0,0 +1,56 @@
+#include "splashkit.h"
+#include <vector>
+
+color blend_colors(color c1, color c2, double t)
+{
+    // linear interpolation for RGB channels
+    int r = (int)((1 - t) * red_of(c1) + t * red_of(c2));
+    int g = (int)((1 - t) * green_of(c1) + t * green_of(c2));
+    int b = (int)((1 - t) * blue_of(c1) + t * blue_of(c2));
+    return rgb_color(r, g, b);
+}
+
+int main()
+{
+    open_window("Split Text Example", 800, 400);
+
+    // I am defining the text to split
+    string text = "apple,banana,carrot";
+
+    // I am splitting the string into parts using SplashKit's split() function
+    vector<string> parts = split(text, ',');
+
+    // I am drawing a gradient background manually
+    color top = rgb_color(245, 251, 255);
+    color bottom = rgb_color(200, 230, 255);
+
+    for (int y = 0; y < 400; y++)
+    {
+        double t = static_cast<double>(y) / 400.0;
+        color blended = blend_colors(top, bottom, t);
+        draw_line(blended, 0, y, 800, y);
+    }
+
+    draw_text("Original string:", color_dark_blue(), "arial", 20, 60, 50);
+    draw_text(text, color_black(), "arial", 20, 280, 50);
+
+    int y = 130;
+    for (string s : parts)
+    {
+        draw_text("Token: " + s, color_black(), "arial", 18, 60, y);
+        y += 40;
+    }
+
+    draw_text("Press ESC to exit", color_gray(), "arial", 14, 620, 360);
+
+    refresh_screen();
+
+    while (!quit_requested())
+    {
+        process_events();
+        if (key_typed(ESCAPE_KEY)) break;
+    }
+
+    close_all_windows();
+    return 0;
+}
diff --git a/public/usage-examples/utilities/split_text-1-example.png b/public/usage-examples/utilities/split_text-1-example.png
new file mode 100644
index 0000000000000000000000000000000000000000..3dbd39ff10ed601614a7ec71b9ec84b7f82bb45b
GIT binary patch
literal 6855
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

literal 0
HcmV?d00001

diff --git a/public/usage-examples/utilities/split_text-1-example.py b/public/usage-examples/utilities/split_text-1-example.py
new file mode 100644
index 000000000..92cd9ba03
--- /dev/null
+++ b/public/usage-examples/utilities/split_text-1-example.py
@@ -0,0 +1,45 @@
+from splashkit import *
+
+def blend_colors(c1, c2, t):
+    # linear interpolation for RGB channels
+    r = int((1 - t) * red_of(c1) + t * red_of(c2))
+    g = int((1 - t) * green_of(c1) + t * green_of(c2))
+    b = int((1 - t) * blue_of(c1) + t * blue_of(c2))
+    return rgb_color(r, g, b)
+
+open_window("Split Text Example", 800, 400)
+
+# I am defining the text to split
+text = "apple,banana,carrot"
+
+# I am splitting the string into parts using SplashKit's split() function
+parts = split(text, ',')
+
+# I am drawing a gradient background manually
+top = rgb_color(245, 251, 255)
+bottom = rgb_color(200, 230, 255)
+
+for y in range(400):
+    t = y / 400
+    blended = blend_colors(top, bottom, t)
+    draw_line(blended, 0, y, 800, y)
+
+draw_text("Original string:", color_dark_blue(), "arial", 20, 60, 50)
+draw_text(text, color_black(), "arial", 20, 280, 50)
+
+# I am printing each token from the split result
+y = 130
+for s in parts:
+    draw_text("Token: " + s, color_black(), "arial", 18, 60, y)
+    y += 40
+
+draw_text("Press ESC to exit", color_gray(), "arial", 14, 620, 360)
+refresh_screen()
+
+# wait for quit event
+while not quit_requested():
+    process_events()
+    if key_typed(KeyCode.escape_key):
+        break
+
+close_all_windows()
\ No newline at end of file
diff --git a/public/usage-examples/utilities/split_text-1-example.txt b/public/usage-examples/utilities/split_text-1-example.txt
new file mode 100644
index 000000000..d99a40f8c
--- /dev/null
+++ b/public/usage-examples/utilities/split_text-1-example.txt
@@ -0,0 +1 @@
+Split Text Example
\ No newline at end of file