feat: activation and tool change hint popup center bottom screen that fades away.

Author: RuntimeRascal

CHANGELOG.md

@@ -11,6 +11,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **Windows Store Package**
   - Added windows store package project and publish first version to windows store.
   - Added new custom splash screen.
+  - Add activation and tool change hint popup center bottom screen that fades away.
 
 ### Changed
 - Versioning semantics to 4-part

Src/GhostDraw/Helpers/DrawingModeHintMessageBuilder.cs

@@ -0,0 +1,39 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using GhostDraw.Core;
+
+namespace GhostDraw.Helpers;
+
+/// <summary>
+/// Builds the user-facing text shown in the drawing mode hint popup.
+/// </summary>
+public static class DrawingModeHintMessageBuilder
+{
+    public static string Build(DrawTool activeTool, IReadOnlyList<int> hotkeyKeys, bool isLockMode)
+    {
+        var toolName = GetToolDisplayName(activeTool);
+        var hotkeyDisplayName = VirtualKeyHelper.GetCombinationDisplayName(hotkeyKeys?.ToList() ?? new List<int>());
+        var exitInstruction = isLockMode
+            ? $"Press Esc or {hotkeyDisplayName} to exit draw mode"
+            : $"Press Esc or release {hotkeyDisplayName} to exit draw mode";
+
+        return string.Join(Environment.NewLine,
+            $"Current tool: {toolName}",
+            "Press F1 for help",
+            "Press Delete to clear canvas",
+            exitInstruction);
+    }
+
+    private static string GetToolDisplayName(DrawTool tool) => tool switch
+    {
+        DrawTool.Pen => "Pen",
+        DrawTool.Line => "Line",
+        DrawTool.Arrow => "Arrow",
+        DrawTool.Eraser => "Eraser",
+        DrawTool.Rectangle => "Rectangle",
+        DrawTool.Circle => "Circle",
+        DrawTool.Text => "Text",
+        _ => tool.ToString()
+    };
+}

Src/GhostDraw/Views/OverlayWindow.xaml.cs

@@ -20,6 +20,9 @@ public partial class OverlayWindow : Window, IOverlayWindow
     private readonly DrawingHistory _drawingHistory;
     private bool _isDrawing = false;
     private bool _isHelpVisible = false;
+    private bool _hasShownDrawingHint = false;
+    private DateTimeOffset _lastDrawingHintShownAt = DateTimeOffset.MinValue;
+    private static readonly TimeSpan DrawingHintDebounce = TimeSpan.FromMilliseconds(400);
 
     // Tool instances
     private readonly PenTool _penTool;
@@ -190,6 +193,8 @@ public void EnableDrawing()
         ClearDrawing();
 
         _isDrawing = true;
+        _hasShownDrawingHint = false;
+        _lastDrawingHintShownAt = DateTimeOffset.MinValue;
 
         // Initialize active tool based on current settings
         var settings = _appSettings.CurrentSettings;
@@ -227,6 +232,8 @@ public void DisableDrawingInternal(bool clearHistory)
     {
         _logger.LogInformation("?? Drawing disabled");
         _isDrawing = false;
+        _hasShownDrawingHint = false;
+        _lastDrawingHintShownAt = DateTimeOffset.MinValue;
 
         // Deactivate current tool and cancel any in-progress operations
         if (_activeTool != null)
@@ -415,6 +422,11 @@ public void OnToolChanged(DrawTool newTool)
             // Update cursor for new tool
             UpdateCursor();
 
+            if (_isDrawing)
+            {
+                ShowDrawingModeHint(fromToolChange: true);
+            }
+
             _logger.LogInformation("Tool changed to {Tool}", newTool);
         }
         catch (Exception ex)
@@ -612,12 +624,34 @@ private void HideCanvasClearedToast()
     /// <summary>
     /// Shows the drawing mode hint with animation (displayed when entering drawing mode)
     /// </summary>
-    private void ShowDrawingModeHint()
+    private void ShowDrawingModeHint(bool fromToolChange = false)
     {
         try
         {
-            DrawingModeHint.Show("Press Delete to clear canvas  |  ESC to exit");
-            _logger.LogDebug("Drawing mode hint shown");
+            if (fromToolChange && !_hasShownDrawingHint)
+            {
+                // Avoid double-show during initial activation when tool change events fire
+                return;
+            }
+
+            var now = DateTimeOffset.UtcNow;
+            if (fromToolChange && (now - _lastDrawingHintShownAt) < DrawingHintDebounce)
+            {
+                _logger.LogDebug("Drawing mode hint throttled (from tool change)");
+                return;
+            }
+
+            var settings = _appSettings.CurrentSettings;
+            var message = DrawingModeHintMessageBuilder.Build(
+                settings.ActiveTool,
+                settings.HotkeyVirtualKeys,
+                settings.LockDrawingMode);
+
+            DrawingModeHint.Show(message);
+            _hasShownDrawingHint = true;
+            _lastDrawingHintShownAt = now;
+            _logger.LogDebug("Drawing mode hint shown with tool {Tool} and hotkey {Hotkey} (LockMode={LockMode})",
+                settings.ActiveTool, settings.HotkeyDisplayName, settings.LockDrawingMode);
         }
         catch (Exception ex)
         {

Src/GhostDraw/Views/UserControls/DrawingModeHintControl.xaml

@@ -25,6 +25,8 @@
                    FontFamily="Segoe UI"
                    FontSize="16"
                    Foreground="#B0B0B0"
-                   Text="Press Delete to clear canvas  |  ESC to exit"/>
+                   TextAlignment="Center"
+                   TextWrapping="Wrap"
+                   Text="Current tool: Pen
Press F1 for help
Press Delete to clear canvas
Press Esc or hotkey to exit draw mode"/>
     </Border>
 </UserControl>

Tests/GhostDraw.Tests/DrawingModeHintMessageBuilderTests.cs

@@ -0,0 +1,36 @@
+using System;
+using GhostDraw.Core;
+using GhostDraw.Helpers;
+
+namespace GhostDraw.Tests;
+
+public class DrawingModeHintMessageBuilderTests
+{
+    [Fact]
+    public void Build_LockMode_UsesPressHotkeyMessage()
+    {
+        var message = DrawingModeHintMessageBuilder.Build(DrawTool.Line, new[] { 0x11, 0x12, 0x58 }, true);
+
+        var expected = string.Join(Environment.NewLine,
+            "Current tool: Line",
+            "Press F1 for help",
+            "Press Delete to clear canvas",
+            "Press Esc or Ctrl + Alt + X to exit draw mode");
+
+        Assert.Equal(expected, message);
+    }
+
+    [Fact]
+    public void Build_HoldMode_UsesReleaseHotkeyMessage()
+    {
+        var message = DrawingModeHintMessageBuilder.Build(DrawTool.Text, new[] { 0x10, 0x20 }, false);
+
+        var expected = string.Join(Environment.NewLine,
+            "Current tool: Text",
+            "Press F1 for help",
+            "Press Delete to clear canvas",
+            "Press Esc or release Shift + Space to exit draw mode");
+
+        Assert.Equal(expected, message);
+    }
+}

docs/TODO.md

@@ -46,11 +46,11 @@
 	- [X] openFolderAfterScreenshot default to `true`
 - [X] Splash screen uses `docs\hero-orig.png` (WPF splash + MSIX SplashScreen.png)
 - [X] Tray about screen update with accurate info
-- [ ] Tool change toast bottom center screen fades away
-- [ ] Activation toast bottom center screen
-  - [ ] Show current tool
-  - [ ] How to exit. Depending on activation hotkey
-  - [ ] F1 for help
+- [X] Tool change toast bottom center screen fades away
+- [X] Activation toast bottom center screen
+  - [X] Show current tool
+  - [X] How to exit. Depending on activation hotkey
+  - [X] F1 for help
 - [X] Ensure setting dir work in both msi version and win store version
 - [X] All project build warnings, messages and errors are resolved
 - [ ] All documents updated with correct information. Not needed documents removed.