Skip to content

Improve Mica/Acrylic descriptions on SystemBackdrops page#2161

Open
niels9001 wants to merge 1 commit intomainfrom
fix/backdrops-descriptions-1869
Open

Improve Mica/Acrylic descriptions on SystemBackdrops page#2161
niels9001 wants to merge 1 commit intomainfrom
fix/backdrops-descriptions-1869

Conversation

@niels9001
Copy link
Copy Markdown
Collaborator

Description

Note

This PR was generated with the assistance of GitHub Copilot (AI). All changes should be reviewed carefully.

Fixes #1869

Rewrites the SystemBackdrops page descriptions to clearly explain the difference between Mica and Acrylic backdrops.

Key improvements

  • Lists all 4 backdrop kinds upfront: Mica, Mica Alt, Desktop Acrylic Base, Desktop Acrylic Thin
  • Adds Mica vs. Acrylic comparison: Mica is opaque (wallpaper sampled once), Acrylic is semi-transparent (real-time blurred view)
  • Removes misleading text: Old description said Acrylic is "used only for transient, light-dismiss surfaces" — this is true for in-app AcrylicBrush but not for DesktopAcrylicBackdrop window backdrops
  • Fixes typo: "Inplemented" → clarified as separate AcrylicBrush concept
  • Uses consistent terminology: "kinds" instead of "types" to match the API naming (MicaKind, DesktopAcrylicKind)
  • Updates ControlInfoData.json description to match

Files changed

  • SystemBackdropsPage.xaml — Rewritten all three description TextBlocks
  • ControlInfoData.json — Updated the Description field for SystemBackdrops

Validation

  1. Build: dotnet build WinUIGallery\WinUIGallery.csproj /p:Platform=x64 — 0 errors
  2. Navigate to System Backdrops page and verify descriptions are readable and accurate

Rewrite the SystemBackdrops page descriptions to clearly differentiate
Mica (opaque, samples desktop wallpaper once) from Desktop Acrylic
(semi-transparent, shows blurred content behind window in real-time).

- List all 4 available backdrop kinds upfront: Mica, Mica Alt, Desktop
  Acrylic Base, Desktop Acrylic Thin
- Add a clear Mica vs. Acrylic comparison section
- Remove misleading statement that Acrylic is only for transient surfaces
- Fix typo (Inplemented -> Implemented) and clarify in-app acrylic vs
  window backdrop distinction
- Update ControlInfoData.json description to match
- Fix terminology: types -> kinds to match API naming

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Mica/Acrylic should be described better

1 participant