Mouse

The Mouse node tracks cursor activity within the Output Render window. Position is reported in Grafit coordinate space, where the center of the viewport maps to (0, 0) and the shorter viewport dimension spans from -1 to +1. This means position values are resolution-independent and consistent across different window sizes.

Scroll values accumulate over time rather than reporting instantaneous deltas. The Scroll Factor input scales incoming scroll events before they are added to the running total. Toggling Reset Scroll to true clears both Scroll X and Scroll Y back to zero.

Position updates occur at the display refresh rate, ensuring smooth tracking for interactive visuals and cursor-driven animations.

• Driving particle emitter positions with cursor movement
• Creating interactive visuals that respond to mouse clicks
• Implementing scroll-controlled zoom or parameter adjustment
• Building UI-like interactions within the output viewport
• Mapping mouse position to shader uniforms for real-time effects

• Position values extend beyond -1/+1 on the longer viewport axis (e.g., X ranges from -aspectRatio to +aspectRatio in landscape mode)
• Use Scroll Factor to fine-tune how sensitive scroll input feels for your use case
• Combine with a Compare or Logic node to trigger events on click edges
• The node only tracks the mouse inside the Output Render window; moving the cursor outside produces no updates