You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
> **"Visual Feedback without Interference. Zero Focus Theft. Absolute Click-Through."**
5
5
6
-
FastXXX is built on the principle that modern Java applications require **native-first** acceleration for performance-critical operations that the standard JVM APIs don't fully optimize.
6
+
FastGhostMouse is built on the principle that automation bots, AI models, and testing frameworks desperately need visual debugging, but traditional Java UI solutions destroy the very environment they try to automate.
7
7
8
8
## Core Tenets
9
9
10
-
1.**Native-First Execution**
11
-
Bypass standard Java layers to reach the physical limits of the hardware using hand-tuned C++ and SIMD intrinsics.
10
+
1.**Do Not Disturb the Host**
11
+
An automation overlay must never steal focus (`WS_EX_NOACTIVATE`) and must never block input (`WS_EX_TRANSPARENT`). If a bot clicks, the click must reach the target app, not the overlay.
12
12
13
-
2.**Zero-Copy JNI Architecture**
14
-
Minimize JNI transition costs by using direct memory access patterns and avoiding implicit memory copies between the JVM and the native layer.
13
+
2.**Bypass the AWT/Swing EDT**
14
+
Standard Java windows (`JFrame`) are bound to the Event Dispatch Thread. Tying your bot's visual feedback to the heavy AWT pipeline guarantees micro-stutters and input lag. FastGhostMouse hooks directly into native Win32/DWM rendering to bypass Java's UI constraints entirely.
15
15
16
-
3.**Deterministic Latency**
17
-
Eliminate variance caused by JIT warm-up or garbage collection stalls in critical hot-paths.
16
+
3.**Visual Truth for AI**
17
+
When training or debugging AI agents, seeing the *exact* intended path of the cursor is critical. FastGhostMouse interpolates natively to show smooth trajectories and state changes, giving developers an instant "window into the AI's mind."
18
18
19
-
4.**Hardware-Aware Optimization**
20
-
Leverage modern CPU features (AVX, SSE, NEON) to process data at hardware-native speeds.
21
-
22
-
5.**Blueprint Consistency**
23
-
As part of the **FastJava** ecosystem, FastXXX adheres to a standardized architecture:
24
-
***Native Backend**: Direct C++ implementation.
19
+
4.**Blueprint Consistency**
20
+
As part of the **FastJava** ecosystem, FastGhostMouse adheres to a standardized architecture:
21
+
***Native Backend**: Direct C++ implementation via `FastOverlay`.
25
22
***Unified Loading**: Powered by `FastCore`.
26
-
***Premium Quality**: Built for high-performance systems and autonomous agents.
23
+
***Premium Quality**: Built specifically for high-performance automation and autonomous agents.
27
24
28
25
---
29
-
**⚡ FastXXX — Powering the next generation of Native Java.**
26
+
**❤️ FastGhostMouse — Powering the next generation of Native Java.**
When building automation bots, AI models, or testing frameworks, visualizing what the software is actually doing is one of the hardest challenges. Standard Java solutions for drawing on the screen suffer from severe limitations:
36
+
37
+
-**The Focus Stealing Problem**: Standard undecorated `JFrame` overlays often steal window focus from the target application, immediately breaking the bot's interactions.
38
+
-**Heavy Rendering Pipelines**: Relying on full-blown UI frameworks to draw a simple cursor trail consumes massive CPU/GPU resources, degrading the performance of the game or app you are trying to automate.
39
+
-**Input Blocking**: Most overlay solutions accidentally intercept mouse clicks or keyboard events, preventing the user (or the bot) from interacting with the UI beneath the overlay.
40
+
41
+
**FastGhostMouse** bypasses these limitations by hooking directly into the Windows OS rendering pipeline:
42
+
43
+
-**True Click-Through (`WS_EX_TRANSPARENT`)**: Built on native JNI bindings, the overlay is mathematically invisible to mouse and keyboard events. You can click right through it.
44
+
-**Zero-Focus Disruption (`WS_EX_NOACTIVATE`)**: The overlay is guaranteed to never steal focus from your active game or application.
45
+
-**Featherweight Footprint**: Optimized to draw simple geometry (like an AI cursor trail or prediction nodes) with near-zero latency and negligible CPU cost.
***AVX2** — detected via CPUID. Enables 32-byte vector ops.
5
-
***SSE4.2** — detected via CPUID. 16-byte fallback.
6
-
***Fallback rule**: AVX2 → SSE4.2 → scalar.
3
+
## 1. Native Overlay Engine
4
+
***WS_EX_TRANSPARENT**: The overlay window is mathematically ignored by the Windows input subsystem. Mouse clicks and keyboard events pass directly through to the underlying application.
5
+
***WS_EX_NOACTIVATE**: The overlay will never steal window focus from your active game, application, or browser, ensuring automation bots are not interrupted.
6
+
***WS_EX_LAYERED**: Enables per-pixel alpha transparency and high-performance image blending via standard Windows APIs.
7
7
8
-
## 2. Guarantees
9
-
***Zero-Copy**: All operations use `GetPrimitiveArrayCritical` for direct memory access.
10
-
***Unaligned Access**: Safe on all byte boundaries.
11
-
***Thread-Safety**: All static native methods are thread-safe.
8
+
## 2. API Capabilities
9
+
***useAsSecondaryMouse(x, y, index)**: Captures the active Windows cursor and seamlessly integrates it into a secondary, scriptable hardware cursor.
10
+
***moveTo(x, y)**: Initiates a hardware-accelerated, interpolated movement to the target coordinates.
11
+
***setSmoothing(factor)**: Adjusts the momentum and easing of the cursor. Lower values produce heavier, more human-like drag, while higher values snap instantly.
12
+
***setTextImage**: Attaches dynamic visual text or labels directly beneath the cursor (e.g., "Executing AI Action").
12
13
13
-
## 3. JNI & Memory Contracts
14
-
***Direct Memory Pinning**: No implicit copies are made by the JNI bridge.
15
-
***No Allocation**: All operations work on pre-allocated Java arrays or buffers.
16
-
***Critical Sections**: Native calls minimize blocking to prevent GC impact.
14
+
## 3. FastCore & FastOverlay Bindings
15
+
***JNI Hooks**: `FastGhostMouse` relies on the unified `FastCore` JNI loader to access `FastOverlayWindow` instances.
16
+
***Zero Swing/AWT Logic**: The overlay bypasses the Java Event Dispatch Thread (EDT) completely, preventing UI locks or stutters during complex bot logic.
17
17
18
18
## 4. Platform Support
19
19
| Platform | Status |
20
20
|----------|--------|
21
21
| Windows 10/11 (x64) | ✅ Fully Supported |
22
+
| Linux | 🚧 Planned (X11/Wayland hooks) |
23
+
| macOS | 🚧 Planned |
22
24
23
25
---
24
-
**Part of the FastJava Ecosystem** — *Making the JVM faster.*
25
-
26
-
Made with ⚡ by Andre Stubbe
26
+
**Part of the FastJava Ecosystem** — *Making the JVM faster. Small package. Maximum speed. Zero bloat. 🚀📋*
0 commit comments