From 43a787a5bd435ca38033e7e53ef4374a9019cb7e Mon Sep 17 00:00:00 2001
From: RUNQILIU-123 <835852842@qq.com>
Date: Sun, 5 Apr 2026 18:11:40 +1000
Subject: [PATCH] Add mouse_clicked usage example

---
 .../input/mouse_clicked-1-example-oop.cs      |  37 ++++++++++++++++++
 .../mouse_clicked-1-example-top-level.cs      |  29 ++++++++++++++
 .../input/mouse_clicked-1-example.cpp         |  32 +++++++++++++++
 .../input/mouse_clicked-1-example.png         | Bin 0 -> 16640 bytes
 .../input/mouse_clicked-1-example.py          |  21 ++++++++++
 .../input/mouse_clicked-1-example.txt         |   3 ++
 6 files changed, 122 insertions(+)
 create mode 100644 public/usage-examples/input/mouse_clicked-1-example-oop.cs
 create mode 100644 public/usage-examples/input/mouse_clicked-1-example-top-level.cs
 create mode 100644 public/usage-examples/input/mouse_clicked-1-example.cpp
 create mode 100644 public/usage-examples/input/mouse_clicked-1-example.png
 create mode 100644 public/usage-examples/input/mouse_clicked-1-example.py
 create mode 100644 public/usage-examples/input/mouse_clicked-1-example.txt

diff --git a/public/usage-examples/input/mouse_clicked-1-example-oop.cs b/public/usage-examples/input/mouse_clicked-1-example-oop.cs
new file mode 100644
index 000000000..066f5a991
--- /dev/null
+++ b/public/usage-examples/input/mouse_clicked-1-example-oop.cs
@@ -0,0 +1,37 @@
+using System.Collections.Generic;
+using SplashKitSDK;
+
+namespace MouseClickedExample
+{
+    public class Program
+    {
+        public static void Main()
+        {
+            SplashKit.OpenWindow("Click to Place Markers", 800, 600);
+
+            List<Point2D> clicks = new();
+
+            while (!SplashKit.QuitRequested())
+            {
+                SplashKit.ProcessEvents();
+
+                // Add a marker where the left mouse button was clicked
+                if (SplashKit.MouseClicked(MouseButton.LeftButton))
+                {
+                    clicks.Add(SplashKit.MousePosition());
+                }
+
+                SplashKit.ClearScreen();
+
+                foreach (Point2D pt in clicks)
+                {
+                    SplashKit.FillCircle(Color.Red, pt.X, pt.Y, 8);
+                }
+
+                SplashKit.RefreshScreen(60);
+            }
+
+            SplashKit.CloseAllWindows();
+        }
+    }
+}
\ No newline at end of file
diff --git a/public/usage-examples/input/mouse_clicked-1-example-top-level.cs b/public/usage-examples/input/mouse_clicked-1-example-top-level.cs
new file mode 100644
index 000000000..f08daa800
--- /dev/null
+++ b/public/usage-examples/input/mouse_clicked-1-example-top-level.cs
@@ -0,0 +1,29 @@
+using System.Collections.Generic;
+using SplashKitSDK;
+using static SplashKitSDK.SplashKit;
+
+OpenWindow("Click to Place Markers", 800, 600);
+
+List<Point2D> clicks = new();
+
+while (!QuitRequested())
+{
+    ProcessEvents();
+
+    // Add a marker where the left mouse button was clicked
+    if (MouseClicked(MouseButton.LeftButton))
+    {
+        clicks.Add(MousePosition());
+    }
+
+    ClearScreen(ColorWhite());
+
+    foreach (Point2D pt in clicks)
+    {
+        FillCircle(ColorRed(), pt.X, pt.Y, 8);
+    }
+
+    RefreshScreen(60);
+}
+
+CloseAllWindows();
\ No newline at end of file
diff --git a/public/usage-examples/input/mouse_clicked-1-example.cpp b/public/usage-examples/input/mouse_clicked-1-example.cpp
new file mode 100644
index 000000000..a6d78f1aa
--- /dev/null
+++ b/public/usage-examples/input/mouse_clicked-1-example.cpp
@@ -0,0 +1,32 @@
+#include "splashkit.h"
+#include <vector>
+
+int main()
+{
+    open_window("Click to Place Markers", 800, 600);
+
+    std::vector<point_2d> clicks;
+
+    while (!quit_requested())
+    {
+        process_events();
+
+        // Add a marker where the left mouse button was clicked
+        if (mouse_clicked(LEFT_BUTTON))
+        {
+            clicks.push_back(mouse_position());
+        }
+
+        clear_screen(color_white());
+
+        for (const point_2d &pt : clicks)
+        {
+            fill_circle(COLOR_RED, pt.x, pt.y, 8);
+        }
+
+        refresh_screen(60);
+    }
+
+    close_all_windows();
+    return 0;
+}
\ No newline at end of file
diff --git a/public/usage-examples/input/mouse_clicked-1-example.png b/public/usage-examples/input/mouse_clicked-1-example.png
new file mode 100644
index 0000000000000000000000000000000000000000..c56ef1fa94dc9ce8f21797c37d041330fb47a03e
GIT binary patch
literal 16640
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
O(2eUV^4Zr6fBruQxDw_7

literal 0
HcmV?d00001

diff --git a/public/usage-examples/input/mouse_clicked-1-example.py b/public/usage-examples/input/mouse_clicked-1-example.py
new file mode 100644
index 000000000..ef448e1f2
--- /dev/null
+++ b/public/usage-examples/input/mouse_clicked-1-example.py
@@ -0,0 +1,21 @@
+from splashkit import *
+
+open_window("Click to Place Markers", 800, 600)
+
+clicks = []
+
+while not quit_requested():
+    process_events()
+
+    # Add a marker where the left mouse button was clicked
+    if mouse_clicked(MouseButton.left_button):
+        clicks.append(mouse_position())
+
+    clear_screen(color_white())
+
+    for pt in clicks:
+        fill_circle(color_red(), pt.x, pt.y, 8)
+
+    refresh_screen()
+
+close_all_windows()
\ No newline at end of file
diff --git a/public/usage-examples/input/mouse_clicked-1-example.txt b/public/usage-examples/input/mouse_clicked-1-example.txt
new file mode 100644
index 000000000..c8da88383
--- /dev/null
+++ b/public/usage-examples/input/mouse_clicked-1-example.txt
@@ -0,0 +1,3 @@
+Click to Place Markers
+
+Left click anywhere in the window to place a red marker at the clicked position.
\ No newline at end of file