Adjust RetroArch touch overlay opacity and scale without moving hitboxes
Change Overlay Opacity when the controls obscure the game, and change Overlay Scale only when the whole overlay and its touch targets should grow or shrink together. If buttons look right but taps land elsewhere, restore both values and inspect the overlay configuration's placement and hitboxes; opacity cannot move an input region. Save a game override only after confirming portrait, landscape, menu access, and an external-controller escape path.
Do this in order
- 01
Record the RetroArch package, video driver, overlay preset and license, device orientation, display size, current opacity and scale, and the active global or override scope.
- 02
Keep scale at its baseline and lower opacity alone until gameplay remains readable while every required button is still visible enough to target.
- 03
Restore opacity, then change scale alone and test edge buttons, diagonals, simultaneous presses, the RetroArch menu control, and any pointer or lightgun region.
- 04
If the image and touch location disagree, restore both controls and inspect the preset's normalized screen rectangle and per-input hitboxes instead of compensating with more scale.
- 05
Rotate the device and repeat because portrait and landscape can select different presets or geometry; keep a physical controller or known menu gesture available for recovery.
- 06
Save the narrowest game or content-directory override, cold-relaunch, and export the configuration receipt without copying overlay art whose license does not allow redistribution.
Decision and diagnostic table
| Control | What it changes | What it cannot repair |
|---|---|---|
| Overlay opacity | Visual transparency | Touch position or button size |
| Overlay scale | Whole configured overlay size | A wrong per-button hitbox |
| Overlay rectangle | Placement in normalized screen coordinates | A missing input descriptor |
| Game override | Where the chosen settings apply | A broken or unlicensed preset |
The picture and hitboxes share a preset but remain distinct
Libretro overlays define images, a screen rectangle, and input hitboxes. A transparent image can still receive touches, while an attractive button can have the wrong descriptor or hitbox. Diagnose what is visible separately from what event RetroArch receives.
Opacity is the safer first adjustment
Opacity changes obstruction without intentionally changing geometry. Scale affects the full overlay and can move edge controls relative to thumbs, cutouts, or a game's active picture, so test it after readability is settled.
A per-game override needs a recovery route
Libretro documents overlay properties that can be placed in a game-specific configuration. Before saving, prove how to reach the menu in both orientations and how to remove the override if the main overlay control becomes inaccessible.
Overlay configuration does not license game content or artwork. Use ArcadeShelf-owned, permissively licensed, or explicitly authorized overlay assets, preserve attribution where required, and do not redistribute proprietary controller art with a diagnostic file.