Skip to content

Add background scaling mode setting#36109

Closed
itsdaliia wants to merge 1 commit into
ppy:masterfrom
itsdaliia:BackgroundImages
Closed

Add background scaling mode setting#36109
itsdaliia wants to merge 1 commit into
ppy:masterfrom
itsdaliia:BackgroundImages

Conversation

@itsdaliia
Copy link
Copy Markdown
Contributor

Closes #36035

Implemented a new BackgroundScaleMode setting with two options:

  • Scale to Fill (default) - Current lazer behavior that scales and crops the background to fill the screen
  • Scale to Fit - Stable behavior that scales the background to fit without cropping, showing letterboxing when necessary

The setting is accessible via Settings → Gameplay → Background and updates in real-time without requiring to reload the map.

Adds a user setting to choose between background scaling modes:
- Scale to Fill (lazer default): Scales and crops to fill the screen
- Scale to Fit (stable default): Scales to fit

The setting is located in Settings > Gameplay > Background and updates
in real-time by reloading the background when changed.

Closes ppy#36035
@diquoks
Copy link
Copy Markdown
Contributor

diquoks commented Dec 22, 2025

did an implementation of this issue yesterday, but was only able to work on pr today, didnt know what else would be interested in

i've reviewed your pull request and made some minor changes to mine implementation (#36111), thank you!

@itsdaliia
Copy link
Copy Markdown
Contributor Author

closing in favor of #36111 which has a more complete implementation.
thanks @diquoks for reviewing my pr and improving on the approach! :)

@itsdaliia itsdaliia closed this Dec 23, 2025
@itsdaliia itsdaliia deleted the BackgroundImages branch December 23, 2025 10:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Background images don't match expected stretch mode for stable users

2 participants