ShareX · Vertygo · Oct 2, 2024 · Oct 2, 2024 · Oct 3, 2024 · Oct 13, 2024
diff --git a/ShareX.HelpersLib/Input/MouseClickEffectForm.cs b/ShareX.HelpersLib/Input/MouseClickEffectForm.cs
@@ -0,0 +1,79 @@
+using System;
+using System.Drawing;
+using System.Windows.Forms;
+
+namespace ShareX.HelpersLib
+{
+    // transparent form where mouse effect will be drawn
+    public class MouseClickEffectForm : Form
+    {
+        private bool _drawEffect = false;
+        public MouseClickEffectForm()
+        {
+            Size = new Size(40, 40);
+            FormBorderStyle = FormBorderStyle.None;
+            ShowIcon = false;
+            ShowInTaskbar = false;
+            TopMost = true;
+            AllowTransparency = true;
+            BackColor = Color.White; // Set a key color for transparency
+            TransparencyKey = Color.White; // Make that color transparent
+        }
+
+        /// <summary>
+        /// Draw mouse effect on given mouse position
+        /// </summary>
+        public void DrawMouseEffect(Point cursorPosition)
+        {
+            _drawEffect = true;
+            CenterFormToCursorPosition(cursorPosition);
+            Invalidate(); // redraw form
+        }
+
+        /// <summary>
+        /// Clear mouse effect
+        /// </summary>
+        public void ClearMouseEffect()
+        {
+            _drawEffect = false;
+            Invalidate(); // redraw form
+        }
+
+        /// <summary>
+        /// Draw a hollow circle as an mouse effect
+        /// </summary>
+        protected override void OnPaint(PaintEventArgs e)
+        {
+            if (_drawEffect)
+            {
+                Graphics g = e.Graphics;
+                g.SmoothingMode = System.Drawing.Drawing2D.SmoothingMode.AntiAlias;
+                // Define a pen to draw hollow circle
+                Pen pen = new Pen(Color.Red, 3);
+                int diameter = 10;
+
+                // Calculate the top-left corner to center the circle
+                int x = (ClientSize.Width - diameter) / 2;
+                int y = (ClientSize.Height - diameter) / 2;
+
+                // .NET GDI+ is not precise when drawign circles this would be better off with WPF/vector-based drawing
+                g.DrawEllipse(pen, x, y, diameter, diameter);
+            }
+
+            base.OnPaint(e);
+        }
+
+        private void CenterFormToCursorPosition(Point cursorPosition)
+        {
+            var x = cursorPosition.X - (Width / 2);
+            var y = cursorPosition.Y - (Height / 2);
+            var flags = SetWindowPosFlags.SWP_NOSIZE |
+                        SetWindowPosFlags.SWP_NOOWNERZORDER |
+                        SetWindowPosFlags.SWP_NOACTIVATE;
+
+            // Center the form/circle at the current mouse cursor position
+            NativeMethods.SetWindowPos(Handle, (IntPtr)NativeConstants.HWND_TOPMOST, x, y, 0, 0, flags);
+        }
+
+    }
+}
diff --git a/ShareX.HelpersLib/Input/MouseClickEffectManager.cs b/ShareX.HelpersLib/Input/MouseClickEffectManager.cs
@@ -0,0 +1,81 @@
+using System;
+using System.Windows.Forms;
+
+namespace ShareX.HelpersLib
+{
+    public class MouseClickEffectManager : IDisposable
+    {
+        private MouseHook mouseHook;
+        private MouseClickEffectForm clickEffectForm;
+        private bool _disposed;
+
+        // start click mouse effects
+        public void Start()
+        {
+            var action = new Action(() =>
+            {
+                clickEffectForm = new MouseClickEffectForm();
+                mouseHook = new MouseHook();
+                mouseHook.OnMouseEvent += OnMouseEvent;
+                clickEffectForm.Show();
+            });
+
+            // form needs to be running on main UI thread otherwise it will not show up
+            if (Application.OpenForms[0].InvokeRequired)
+            {
+                Application.OpenForms[0].Invoke(action);
+            }
+            else
+            {
+                action();
+            }
+        }
+
+        /// <summary>
+        /// Mouse event handler
+        /// </summary>
+        private void OnMouseEvent(MouseEventInfo eventInfo)
+        {
+            switch (eventInfo.ButtonState)
+            {
+                case ButtonState.LeftButtonDown:
+                    clickEffectForm.DrawMouseEffect(eventInfo.CursorPosition);
+                    break;
+                default:
+                    clickEffectForm.ClearMouseEffect();
+                    break;
+            }
+        }
+
+        public void Stop()
+        {
+            Dispose();
+        }
+
+        public void Dispose()
+        {
+            Dispose(true);
+        }
+
+        protected virtual void Dispose(bool disposing)
+        {
+            if (_disposed)
+            {
+                return;
+            }
+
+            if (disposing)
+            {
+                mouseHook.OnMouseEvent -= OnMouseEvent;
+                mouseHook.Dispose();
+                clickEffectForm.Close();
+                clickEffectForm.Dispose();
+            }
+
+            mouseHook = null;
+            clickEffectForm = null;
+
+            _disposed = true;
+        }
+    }
+}
diff --git a/ShareX.HelpersLib/Input/MouseEventInfo.cs b/ShareX.HelpersLib/Input/MouseEventInfo.cs
@@ -0,0 +1,19 @@
+
+
+using System.Drawing;
+
+namespace ShareX.HelpersLib
+{
+    public class MouseEventInfo
+    {
+        public ButtonState ButtonState { get; set; }
+        public Point CursorPosition { get; set; }
+    }
+
+    public enum ButtonState
+    {
+        LeftButtonDown,
+        RightButtonDown,
+        ButtonUp
+    }
+}
diff --git a/ShareX.HelpersLib/Input/MouseHook.cs b/ShareX.HelpersLib/Input/MouseHook.cs
@@ -0,0 +1,65 @@
+using System;
+
+namespace ShareX.HelpersLib
+{
+    public class MouseHook : IDisposable
+    {
+        private HookProc _proc;
+        private static IntPtr _hookID = IntPtr.Zero;
+
+        public delegate void MouseEventHandler(MouseEventInfo eventInfo);
+        public event MouseEventHandler OnMouseEvent;
+
+        public MouseHook()
+        {
+            _proc = HookCallback;
+            _hookID = SetHook(_proc); // Set up global mouse hook
+        }
+
+        ~MouseHook()
+        {
+            Dispose();
+        }
+
+        private static IntPtr SetHook(HookProc proc)
+        {
+            using (var curProcess = System.Diagnostics.Process.GetCurrentProcess())
+            using (var curModule = curProcess.MainModule)
+            {
+                return NativeMethods.SetWindowsHookEx(NativeConstants.WH_MOUSE_LL, proc, NativeMethods.GetModuleHandle(curModule.ModuleName), 0);
+            }
+        }
+
+        private IntPtr HookCallback(int nCode, IntPtr wParam, IntPtr lParam)
+        {
+            if (nCode >= 0)
+            {
+                switch ((WindowsMessages)wParam)
+                {
+                    case WindowsMessages.LBUTTONDOWN:
+                        OnMouseEvent(new MouseEventInfo
+                        {
+                            ButtonState = ButtonState.LeftButtonDown,
+                            CursorPosition = CaptureHelpers.GetCursorPosition()
+                        });
+                        break;
+
+                    case WindowsMessages.LBUTTONUP:
+                        OnMouseEvent(new MouseEventInfo
+                        {
+                            ButtonState = ButtonState.ButtonUp,
+                            CursorPosition = CaptureHelpers.GetCursorPosition()
+                        });
+                        break;
+                }
+            }
+
+            return NativeMethods.CallNextHookEx(_hookID, nCode, wParam, lParam);
+        }
+
+        public void Dispose()
+        {
+            NativeMethods.UnhookWindowsHookEx(_hookID); // Clean up hook on exit
+        }
+    }
+}
diff --git a/ShareX.ScreenCaptureLib/ScreenRecording/ScreenRecordingOptions.cs b/ShareX.ScreenCaptureLib/ScreenRecording/ScreenRecordingOptions.cs
@@ -44,6 +44,7 @@ public class ScreenRecordingOptions
         public Rectangle CaptureArea { get; set; }
         public float Duration { get; set; }
         public bool DrawCursor { get; set; }
+        public bool ShowCursorEffect { get; set; }
         public FFmpegOptions FFmpeg { get; set; } = new FFmpegOptions();
 
         public string GetFFmpegCommands()