Loading
Loading
Loading
mobile footer

Build the Interaction Layer Your Website is Missing.

Browse All EffectsBrowse All EffectsBrowse All EffectsUpgrade to ProUpgrade to ProUpgrade to Pro

70+ effects free, forever. No credit card.

© 2026 Hyperiux. All Rights Reserved.

AI Component CatalogueHey AI, Learn About Us
Platform

Vault

  • Documentation
  • Pricing
  • Blog
  • Community
  • NPM
  • MCP

Categories

  • All Effects
  • WebGL
  • Text
  • Backgrounds
  • Buttons
  • Carousels
  • Scroll
  • Components
  • Navigation
  • Cursor
  • Transitions
  • Loaders

Documents

  • Introduction
  • Installation
  • CLI
  • Dependencies
  • License

Legal

  • License Agreement
  • Terms of Service
  • Privacy Policy
  • Refund Policy
Socials
  • Twitter / X
  • LinkedIn
  • GitHub
  • Instagram
Contact Us
  • hello@hyperiux.com
New effects, in your inbox

Every new drop, plus the occasional behind-the-scenes build. No spam. Unsubscribe anytime.

All Effects
Featured ComponentsText AnimationsAnimated BackgroundsAnimated ButtonsCarousel EffectsScroll EffectsCreative ComponentsNavigationsCursor EffectsTransitionsLoadersWebGL & 3D Effects
Templates
IntroductionInstallationCLIDependenciesLicense
PricingBlogGithubNPMMCP Doc
Loading
Home/effects/Mouse Pixelation

Mouse Pixelation

A pointer-led WebGL pixelation effect that reveals image detail through cursor movement for portfolios, campaigns, and technical hero surfaces.

Three.js@react-three/fiber@react-three/postprocessingGSAP
DemoDemoDemo

Tune the Real Props

Background

Overview

Mouse Pixelation reveals content through cursor movement. It makes the act of looking the first interaction.

Use it when pointer movement should make the hero feel discovered: portfolio imagery, technical visuals, or campaign surfaces where the reveal adds meaning.

The risk in production is pointer dependence. The final image and message must be available when hover is unavailable.


Usage Code

page
1import MousePixelation from '@/components/effects/mouse-pixelation'2 3const page = () => {4  return (5    <>6     <MousePixelation variant={"pixel-circle"} imageUrl={"https://pub-8abee449136941f5b0a1cd2c014534e9.r2.dev/vault-listing-images/assets-images/h-02.jpg"}/>7  </>8  )9}10 11export default page

Example Production Use Case

A photographer's portfolio can use Mouse Pixelation on the opening image of a new series. The photograph sits behind a pixel grid, and cursor movement shifts the blocks so the visitor uncovers detail by looking around the frame.

The outcome is discovery. The first interaction is the act of looking, which suits work that rewards a second glance. The series title, credits, and the full image stay available for touch visitors who cannot hover.

A creative campaign page can use the same component when pixelation is already part of the visual language.


Best Used For

  • Pointer-led hero surfaces where interaction reveals image detail without hiding the message.
  • Creative portfolios where the cursor can become part of the looking experience.
  • Technical brand pages where pixelation supports the visual language.

Not For

Not for low-power-first pages, dense content, dashboards, checkout, or routes where performance is the main conversion lever.


Performance Budget

Cap DPR at 1.0 on touch/mobile and up to 1.5 on mid-range desktop. Pause Mouse Pixelation offscreen and in hidden tabs, reduce postprocessing before shipping, and keep texture sizes controlled.


Accessibility and Mobile

Keep meaningful content in HTML outside the canvas. On mobile, reduce shader quality and switch to a poster if the scene cannot hold frame rate.


Common Mistakes

  • Requiring pointer movement for the page to make sense on touch devices.
  • Pixelating critical text or controls instead of imagery.
  • Forgetting the clean still image state for reduced motion and mobile.

Changelog

added reduced-motion
Initial release

API Reference

PropTypeDefaultDescription
v1NumberOfGridsnumber35V1 · Pixel Circles: number of grid cells across the effect.
v1Lerpnumber0.1V1 · Pixel Circles: smoothing of the mouse-following motion.
v1BackgroundColorstring#000000V1 · Pixel Circles: canvas background color.
v2NumberOfGridsnumber35V2 · Pixel Shift: number of grid cells across the effect.
v2Lerpnumber0.1V2 · Pixel Shift: smoothing of the mouse-following motion.
v3NumberOfGridsnumber35V3 · Pixel Cube: number of grid cells across the effect.
v3Lerpnumber0.1V3 · Pixel Cube: smoothing of the mouse-following motion.
v3CubeSizenumber1V3 · Pixel Cube: scale of the cube.
v3GridEmbossingnumber1V3 · Pixel Cube: depth of the extruded grid.

Questions, Answered.

What GPU budget should Mouse Pixelation use on mobile and desktop?

The pixelation samples the image as the cursor moves, so cap DPR at 1.0 on mobile and 1.5 on desktop and keep the source texture appropriately sized. Update the effect around the pointer rather than the whole frame where possible. Note that the core interaction is pointer-based, which shapes the mobile story.

What poster fallback should replace Mouse Pixelation when WebGL fails?

Show the clean, un-pixelated image so the content is fully visible without the effect. The HTML copy is unaffected. Make sure nothing important depended on pixelation to be seen.

How should Mouse Pixelation pause when offscreen or in a hidden tab?

Pause rendering and pointer tracking when the canvas is offscreen or the tab hidden, and idle when the pointer is away. Resume on visibility and interaction. Idling between movements keeps it inexpensive.

Which content should stay outside the Mouse Pixelation canvas?

Real content stays in HTML; the pixelation is a visual layer over imagery, not a place to store text or links. Because the reveal is pointer-driven, ensure touch and keyboard users still get the full image and meaning. Keep actions as DOM elements.

When should I choose a static image instead of Mouse Pixelation?

Choose a static image when most traffic is touch (where there's no hover to drive the effect), when performance matters, or when the pixelation is novelty rather than purpose. If the interaction won't reach your audience, show the plain image. Reserve it for pointer-first, exploratory pages.

Request a Custom Animation

Need a custom effect? Tell us what to create.

Related Effects

Explore All EffectsExplore All EffectsExplore All Effects
Fractal Glass
Three.js

Fractal Glass

WebGL

Progressive Bloom Valley
Pro
Three.jspostprocessing@react-three/drei

Progressive Bloom Valley

WebGL

Hero Banner Animated
Pro
GSAPThree.jsMotion

Hero Banner Animated

WebGL

Curved Plane
Pro
Three.js

Curved Plane

WebGL

Interactive Blur Reveal
WebGL Shader

Interactive Blur Reveal

WebGL