feat(finalshot): add exclusive window capture mode using PrintWindow API

- Introduce UsePrintWindow setting to toggle exclusive window capture
- Implement PrintWindow API call for capturing window without overlaps
- Add fallback to CopyFromScreen if PrintWindow fails or throws exception
- Update logging to reflect capture mode and PrintWindow usage
- Extend configuration and README with UsePrintWindow option details
- Bump AssemblyVersion, skin definition version, and build script patch number

Author: NSTechBytes

Build.ps1

@@ -1,4 +1,4 @@
-#usage -----> powershell -ExecutionPolicy Bypass -Command "& {. .\Build.ps1; Dist -major 1 -minor 6 -patch 0}"
+#usage -----> powershell -ExecutionPolicy Bypass -Command "& {. .\Build.ps1; Dist -major 1 -minor 7 -patch 0}"
 $msbuild = "C:\Program Files\Microsoft Visual Studio\2022\Community\Msbuild\Current\Bin\MSBuild.exe"
 
 function Add-RMSkinFooter {

FinalShot/AssemblyInfo.cs

@@ -2,7 +2,7 @@
 using System.Runtime.CompilerServices;
 
 [assembly: AssemblyCopyright("© 2025 - nstechbytes 🇵🇰")]
-[assembly: AssemblyVersion("1.6.0.0")]
+[assembly: AssemblyVersion("1.7.0.0")]
 
 // Do not change the entries below!
 #if X64

FinalShot/FinalShot.cs

@@ -65,6 +65,7 @@ public class Settings
         public int JpegQuality { get; private set; }
         public Rectangle PredefinedRegion { get; private set; }
         public bool ShowNotification { get; private set; }
+        public bool UsePrintWindow { get; private set; }
 
         public Settings(API api)
         {
@@ -74,6 +75,7 @@ public Settings(API api)
             ShowCursor = api.ReadInt("ShowCursor", 0) > 0;
             JpegQuality = api.ReadInt("JpgQuality", 70);
             ShowNotification = api.ReadInt("ShowNotification", 0) > 0;
+            UsePrintWindow = api.ReadInt("UsePrintWindow", 0) > 0;
             int x = api.ReadInt("PredefX", 0);
             int y = api.ReadInt("PredefY", 0);
             int w = api.ReadInt("PredefWidth", 0);
@@ -117,6 +119,9 @@ private struct RECT
         [DllImport("user32.dll")]
         private static extern bool DrawIcon(IntPtr hDC, int X, int Y, IntPtr hIcon);
 
+        [DllImport("user32.dll")]
+        private static extern bool PrintWindow(IntPtr hWnd, IntPtr hdcBlt, uint nFlags);
+
         [DllImport("user32.dll", SetLastError = true)]
         private static extern bool GetIconInfo(IntPtr hIcon, out ICONINFO pIconInfo);
 
@@ -232,7 +237,7 @@ public static void TakeCustom(Settings settings, Action finishCallback)
 
         public static void TakeWindowScreenshot(Settings settings, string windowTitle)
         {
-            Logger.Log($"TakeWindowScreenshot() called. WindowTitle='{windowTitle}'");
+            Logger.Log($"TakeWindowScreenshot() called. WindowTitle='{windowTitle}', UsePrintWindow={settings.UsePrintWindow}");
             if (string.IsNullOrEmpty(settings.SavePath))
             {
                 Logger.Log("TakeWindowScreenshot: SavePath is empty, aborting.");
@@ -271,7 +276,41 @@ public static void TakeWindowScreenshot(Settings settings, string windowTitle)
                     using (var bmp = new Bitmap(width, height))
                     using (var g = Graphics.FromImage(bmp))
                     {
-                        g.CopyFromScreen(bounds.Location, Point.Empty, bounds.Size);
+                        if (settings.UsePrintWindow)
+                        {
+                            // Use PrintWindow API for exclusive window capture
+                            Logger.Log("TakeWindowScreenshot: Using PrintWindow API");
+                            IntPtr hdc = g.GetHdc();
+                            try
+                            {
+                                // PW_RENDERFULLCONTENT = 0x00000002
+                                bool result = PrintWindow(hWnd, hdc, 0x00000002);
+                                if (!result)
+                                {
+                                    Logger.Log("TakeWindowScreenshot: PrintWindow failed, falling back to CopyFromScreen");
+                                    g.ReleaseHdc(hdc);
+                                    g.CopyFromScreen(bounds.Location, Point.Empty, bounds.Size);
+                                }
+                                else
+                                {
+                                    g.ReleaseHdc(hdc);
+                                    Logger.Log("TakeWindowScreenshot: PrintWindow succeeded");
+                                }
+                            }
+                            catch (Exception ex)
+                            {
+                                Logger.Log($"TakeWindowScreenshot: PrintWindow exception: {ex.Message}");
+                                try { g.ReleaseHdc(hdc); } catch { }
+                                g.CopyFromScreen(bounds.Location, Point.Empty, bounds.Size);
+                            }
+                        }
+                        else
+                        {
+                            // Use CopyFromScreen for screen-based capture (includes overlapping windows)
+                            Logger.Log("TakeWindowScreenshot: Using CopyFromScreen");
+                            g.CopyFromScreen(bounds.Location, Point.Empty, bounds.Size);
+                        }
+
                         if (settings.ShowCursor)
                             DrawCursor(g, bounds);
                         SaveImageSafely(bmp, settings);

README.md

@@ -32,7 +32,8 @@ FinalShot supports full‑screen captures, predefined regions, custom selection,
   Draw a region on‑the‑fly with your mouse.
 
 - **Window Capture** (`-ws|windowtitle`)  
-  Capture a specific window by its exact title.
+  Capture a specific window by its exact title.  
+  Supports two modes: exclusive window capture (using `PrintWindow` API) or screen-based capture (includes overlapping windows).
 
 - **Toast Notifications**  
   Beautiful themed notifications that adapt to Windows Dark/Light mode with screenshot preview.
@@ -87,6 +88,8 @@ SavePath=C:\Users\You\Pictures\shot.png
 ShowCursor=1
 ; 1 = show notification with preview, 0 = no notification
 ShowNotification=1
+; Window capture mode (1 = exclusive window, 0 = screen-based)
+UsePrintWindow=1
 ; JPEG quality (only if SavePath ends in .jpg/.jpeg)
 JpgQuality=85
 ; Predefined region (for -ps):
@@ -144,6 +147,7 @@ DebugLog=0
 | `ScreenshotFinishAction`| Rainmeter bang or command to run after saving.                                                   | (empty)     |
 | `ShowCursor`            | Include mouse cursor in capture? (1 = yes, 0 = no)                                               | 0           |
 | `ShowNotification`      | Show toast notification with preview after capture? (1 = yes, 0 = no)                           | 0           |
+| `UsePrintWindow`        | Window capture mode: 1 = exclusive window (no overlaps), 0 = screen-based (includes overlaps)   | 0           |
 | `JpgQuality`            | JPEG compression quality (0–100). Only applies to `.jpg` or `.jpeg` files.                        | 70          |
 | `PredefX`, `PredefY`    | Top‑left coordinates of the predefined capture region.                                           | 0           |
 | `PredefWidth`, `PredefHeight` | Width & height of the predefined capture region.                                            | 0           |
@@ -179,20 +183,32 @@ ShowCursor=0
 ShowNotification=1
 ```
 
-### Window Capture
+### Window Capture (Exclusive Mode)
 ```ini
 [MeasureWindow]
 Measure=Plugin
 Plugin=FinalShot
 SavePath=#@#Screenshots\Window.png
 ShowCursor=0
 ShowNotification=1
+; Capture only the window (no overlapping windows)
+UsePrintWindow=1
 
 [CaptureNotepad]
 Meter=String
 LeftMouseUpAction=[!CommandMeasure MeasureWindow "-ws|Untitled - Notepad"]
 ```
 
+### Window Capture (Screen-Based Mode)
+```ini
+[MeasureWindowScreen]
+Measure=Plugin
+Plugin=FinalShot
+SavePath=#@#Screenshots\WindowScreen.png
+; Capture whatever is visible on screen (includes overlapping windows)
+UsePrintWindow=0
+```
+
 ---
 
 ## Debug Logging

Resources/Skins/FinalShot/Main.ini

@@ -1,6 +1,6 @@
 {
     "skinDir":  ".\\Resources\\Skins",
-    "version":  "1.6.0",
+    "version":  "1.7.0",
     "minimumVersion":  "4.5",
     "author":  "nstechbytes",
     "variableFiles":  "",
@@ -17,5 +17,5 @@
     "load":  "FinalShot\\Main.ini",
     "headerImage":  ".\\Resources\\banner.bmp",
     "configPrefix":  "FinalShot",
-    "output":  ".\\dist\\FinalShot_v1.6.0.rmskin"
+    "output":  ".\\dist\\FinalShot_v1.7.0.rmskin"
 }