[Merged by Bors] - Fix outdated and badly formatted docs for WindowDescriptor::transparent

[rparrett]

Objective

See title

Before / After

Open questions

The old docs previously linked to a winit but that was preventing transparency for working on Windows 11. The recent winit upgrade should have fixed this.

I'm unable to test on Windows 11 though, so someone should verify that we no longer need to call this out as being broken.

edit: Seems like we're good on Windows 11, thanks.

[mockersf]

it works on macOS if I change

bevy/crates/bevy_render/src/view/window.rs

Line 199 in abbc0cf

alpha_mode: wgpu::CompositeAlphaMode::Auto,

to CompositeAlphaMode::PostMultiplied

[hymm]

worked for me on windows 11

    App::new()
        .insert_resource(WindowDescriptor {
            transparent: false,
            ..default()
        })
        .insert_resource(ClearColor(Color::Rgba {
            red: 0.1,
            green: 0.1,
            blue: 0.1,
            alpha: 0.5,
        }))

[hymm]

Approving just the windows 11 related changes here. I can't test macOS.

[rparrett]

it works on macOS if I change

What would you suggest we do with this documentation of MacOS users? Should we create a bevy issue that documents the workaround and links to the wgpu issue and then link to that?

[targrub]

Running the transparent_window example on Windows 11, I get a Bevy logo, circular, 100% clear (transparent, not translucent) outside that circle. Can't move the window, only close it through the Taskbar (or more drastic ways); can bring it in front of other windows by clicking on the logo. Title of window shown as "app" in Alt-Tab bar.

[rparrett]

Running the transparent_window example on Windows 11, I get a Bevy logo, circular, 100% clear (transparent, not translucent) outside that circle. Can't move the window, only close it through the Taskbar (or more drastic ways); can bring it in front of other windows by clicking on the logo. Title of window shown as "app" in Alt-Tab bar.

Thanks. I think that's normal, as that example also disables the title bar.

[mockersf]

What would you suggest we do with this documentation of MacOS users? Should we create a bevy issue that documents the workaround and links to the wgpu issue and then link to that?

Yeah, new issue sounds good 👍
We don't expose the wgpu config for CompositeAlphaMode anyway, and I'm not sure what impacts it could have

[rparrett]

Alright, now linking off to the linux and mac specific bevy issues.

[alice-i-cecile]

bors r+

[bors]

Build failed (retrying...):

• check-compiles

[bors]

Pull request successfully merged into main.

Build succeeded:

• build-and-install-on-iOS
• build-android
• build (macos-latest)
• build (ubuntu-latest)
• build-wasm
• build (windows-latest)
• build-without-default-features (bevy)
• build-without-default-features (bevy_ecs)
• build-without-default-features (bevy_reflect)
• check-compiles
• check-doc
• check-missing-examples-in-docs
• ci
• markdownlint
• run-examples
• run-examples-on-wasm
• run-examples-on-windows-dx12