Add support for builtin DComp swapchains #7550

n1ght-hunter · 2025-04-16T06:17:44Z

Description
add support for builtin DComp swapchains to the dx12 backend.
My main goal for this was to get window transparency to work on windows

Testing
Tested using a basic wgpu app with transparency

Squash or Rebase?
Squash

Checklist

Run cargo fmt.
Run taplo format.
Run cargo clippy --tests. If applicable, add:
- --target wasm32-unknown-unknown
Run cargo xtask test to run tests.
If this contains user-facing changes, add a CHANGELOG.md entry.

I dont know if its normal or not but when running cargo xtask test i had 201 tests fail with code 0xc0000005: Invalid access to memory location. (os error 998) this is run on windows 10

cwfitzgerald

Generally looking good, some comments.

wgpu-hal/src/dx12/mod.rs

wgpu-types/src/instance.rs

wgpu-hal/src/dx12/mod.rs

n1ght-hunter · 2025-04-17T12:51:38Z

will get to this in the next day or two

…tions

… traits

…options

…d of use_dcomp

…-hunter/wgpu into dev/windows-os-transparent

n1ght-hunter · 2025-05-06T16:52:13Z

@cwfitzgerald would you be able to re review when you get time thanks

cwfitzgerald

Sorry for the delay, looks good in general with a few small comments. I also think that the hardcoded list of blending modes needs to be adjusted based on if DXGI or DComp is selected

wgpu-hal/src/dx12/dcomp.rs

Anutrix · 2025-05-30T06:35:09Z

Might totally be unfounded and not apply here but DirectComposition on Windows has issues with NVIDIA GPU when used with multiple monitors with different and high(60+) refresh rates. This was seen on Firefox so might be specific to it.
Recent ticket: https://bugzilla.mozilla.org/show_bug.cgi?id=1968876 . Couldn't find original ticket.

cwfitzgerald · 2025-05-30T18:56:58Z

I definitely wouldn't worry about it here. That issue seems to be Windows 10 specific too.

melody-rs · 2025-06-03T22:02:28Z

Oh! Thank you for doing this, transparency support in wgpu has been a pretty big pain point for me in the past

n1ght-hunter · 2025-06-10T16:18:56Z

Im just traveling abroad atm should be able to get to this in the next week or so

cwfitzgerald · 2025-06-25T18:51:33Z

Boop :)

MarijnS95 · 2025-07-06T15:30:47Z

So if I understand this correctly, normally one would create and manage a composition (device, target) externally, and pass either the IDCompositionVisual (where wgpu will insert the internally-crated IDXGISwapChain1 as content into the visual) or a HANDLE to an opaque "composition surface" (which the caller should insert as the content of a visual themselves - useful for cross-process sharing) into wgpu surface creation. Allowing users to render into arbitrary surfaces with wgpu while possibly combining it with a much more complicated composition/transformation tree and surfaces filled by other sources.

This PR seems to abstract away the most basic form of that, by creating and managing that DirectComposition device and a single Visual spanning the full Target that wraps the window (where hopefully "someone" disables the backing redirection buffer...) so that users no longer have to deal with it?

i.e. maybe this PR should be retitled and have a better description of what it achieves. Technically "dcomp on Windows" is already supported :)

wgpu-hal/src/dx12/dcomp.rs

n1ght-hunter · 2025-08-04T06:41:18Z

i have updated this pr now. i believe i have fixed all comments except for title of pr.
im terrible with coming up with titles so suggestions are welcome

cwfitzgerald

Sorry for another round of comments, we're almost there!

CHANGELOG.md

wgpu-types/src/instance.rs

cwfitzgerald · 2025-08-13T23:49:12Z

wgpu-types/src/instance.rs

+    /// Use the DXGI presentation system.
+    #[default]
+    Dxgi,
+    /// Use the DirectComposition presentation system.


Suggested change

/// Use the DirectComposition presentation system.

/// Use a DXGI swapchain made from a DirectComposition visual made from the window.

///

/// This supports transparent windows, but does not support fullscreen optimization.

@cwfitzgerald these user-facing documentation bits need links to upstream documentation exactly how all this works. Perhaps we need to explain that users cannot or should not use this in conjunction with SurfaceTargetUnsafe::CompositionVisual/SurfaceTargetUnsafe::SurfaceHandle if they're already managing a layer tree externally (themselves).

Can you backup (link) exactly how this doesn't support "fullscreen optimization" (like borderless fullscreen)? I was under the impression that this uses flip-style present as well which should allow for hardware-compositable/presentable planes in the sawpchain?

EDIT: Or are you saying this because translucent surfaces inevitably require the underlying plane(s) to be rendered and blended (hopefully accelerated in hardware by MPO blending) too? If the user disables alpha blending on the swapchain it should still be able to make this optimization.

Should we also recommend users to set WS_EX_NOREDIRECTIONBITMAP?

these user-facing documentation bits need links to upstream documentation exactly how all this works. Perhaps we need to explain that users cannot or should not use this in conjunction with SurfaceTargetUnsafe::CompositionVisual/SurfaceTargetUnsafe::SurfaceHandle if they're already managing a layer tree externally (themselves).

I agree, though we can leave this to another PR and spin off an issue from this one, I don't want to hold it up too long as I've already let it sit a while.

Can you backup (link) exactly how this doesn't support "fullscreen optimization" (like borderless fullscreen)? I was under the impression that this uses flip-style present as well which should allow for hardware-compositable/presentable planes in the sawpchain?

I thought I had a conversation about this with Jesse on the d3d12 discord a while ago but I can't find it, so I'll ask again and see what they say.

Should we also recommend users to set WS_EX_NOREDIRECTIONBITMAP?

I honestly don't know.

Re: mpo

I was wrong! Things made from visuals are still eligible for full screen optimization.

wgpu-types/src/instance.rs

Co-authored-by: Connor Fitzgerald <[email protected]>

n1ght-hunter · 2025-08-14T13:20:50Z

@cwfitzgerald done :)

wgpu-types/src/instance.rs

MarijnS95 · 2025-08-14T13:37:24Z

wgpu-hal/src/dx12/dcomp.rs

+            profiling::scope!("DirectComposition::DCompositionCreateDevice");
+            unsafe { DirectComposition::DCompositionCreateDevice2(None) }.map_err(|err| {
+                log::error!("DirectComposition::DCompositionCreateDevice failed: {err}");
+                crate::SurfaceError::Other("DirectComposition::DCompositionCreateDevice")


It's surprising that SurfaceError doesn't have an inner error like InstanceError.

whats the go with? i presume that is for another pr if required?

MarijnS95 · 2025-08-14T13:44:18Z

wgpu-types/src/instance.rs

+    /// Use the DXGI presentation system.
+    #[default]
+    Dxgi,
+    /// Use the DirectComposition presentation system.


@cwfitzgerald these user-facing documentation bits need links to upstream documentation exactly how all this works. Perhaps we need to explain that users cannot or should not use this in conjunction with SurfaceTargetUnsafe::CompositionVisual/SurfaceTargetUnsafe::SurfaceHandle if they're already managing a layer tree externally (themselves).

Can you backup (link) exactly how this doesn't support "fullscreen optimization" (like borderless fullscreen)? I was under the impression that this uses flip-style present as well which should allow for hardware-compositable/presentable planes in the sawpchain?

EDIT: Or are you saying this because translucent surfaces inevitably require the underlying plane(s) to be rendered and blended (hopefully accelerated in hardware by MPO blending) too? If the user disables alpha blending on the swapchain it should still be able to make this optimization.

CHANGELOG.md

wgpu-hal/src/dx12/dcomp.rs

MarijnS95 · 2025-08-14T13:54:47Z

wgpu-types/src/instance.rs

+    /// Use the DXGI presentation system.
+    #[default]
+    Dxgi,
+    /// Use the DirectComposition presentation system.


Should we also recommend users to set WS_EX_NOREDIRECTIONBITMAP?

melody-rs · 2025-08-14T21:17:42Z

Could we maybe get an example showing how to use DComp to make window transparency work?

Window transparency with wgpu has been a frustration for a while now and having a working example to base things off of would be super helpful imo

n1ght-hunter · 2025-08-15T03:43:06Z

Could we maybe get an example showing how to use DComp to make window transparency work?

Window transparency with wgpu has been a frustration for a while now and having a working example to base things off of would be super helpful imo

sure i have a testing example i can its basiclly just a triangle with partly clear background

Co-authored-by: Marijn Suijten <[email protected]>

cwfitzgerald · 2025-08-20T17:30:09Z

Could we maybe get an example showing how to use DComp to make window transparency work?

I think we should, but we can do this as a follow up.

cwfitzgerald · 2025-08-27T20:23:56Z

@n1ght-hunter casual poke!

cwfitzgerald

I have a few final tweaks, but I'll push a commit to do them so we don't need to do another round of this.

MarijnS95 · 2025-09-11T15:02:41Z

CHANGELOG.md


-This creates a single `IDCompositionVisual` over the entire window that is used by the `Surface`. If a user wants to manage the composition tree themselves, they should create their own device and composition, and pass the relevant visual down into `wgpu` via `IDCompositionTarget::CompositionVisual` or `IDCompositionTarget::SurfaceHandle`.
+This creates a single `IDCompositionVisual` over the entire window that is used by the mf`Surface`. If a user wants to manage the composition tree themselves, they should create their own device and composition, and pass the relevant visual down into `wgpu` via `SurfaceTargetUnsafe::CompositionVisual`.


@cwfitzgerald what is an mf`Surface`?

Also SurfaceTargetUnsafe::SurfaceHandle is still an option, especially when shared across processes.

what is an mfSurface?

A typo 😅

Thanks for catching these issues, I'll push a PR fixing these up.

MarijnS95 · 2025-09-11T15:07:52Z

wgpu-types/src/instance.rs

+    /// - `DxgiFromVisual` or `Visual`
+    /// - `DxgiFromHwnd` or `Hwnd` for [`Self::DxgiFromHwnd`]


Does the first line miss for [`Self::DxgiFromVisual`], to match the Hwnd line?

MarijnS95 · 2025-09-11T15:08:52Z

wgpu-types/src/instance.rs

-    /// This supports transparent windows, but does not support fullscreen optimization.
-    DirectComposition,
+    /// This creates a single [`IDCompositionVisual`] over the entire window that is used by the `Surface`.
+    /// If a user wants to manage the composition tree themselves, they should create their own device and


I hope it's clear to users that you don't mean to create a graphics device but an IDCompositionDevice 😅

MarijnS95 · 2025-09-11T15:09:22Z

wgpu-types/src/instance.rs

@@ -449,29 +449,36 @@ impl NoopBackendOptions {
 pub enum Dx12SwapchainKind {
    /// Use a DXGI swapchain made directly from the window's HWND.
    ///
-    /// This supports fullscreen optimization, making borderless windows just as efficient as exclusive fullscreen. It does not support transparent windows.
+    /// This does not support transparency but has better support from developer tooling from RenderDoc.


from developer tooling like RenderDoc?

n1ght-hunter added 4 commits April 13, 2025 15:57

add dx12 dcomp option to backend options

e6d7e5f

impl dcomp for the dx12 backend

c328699

Merge branch 'gfx-rs:trunk' into dev/windows-os-transparent

3f91a00

Merge branch 'gfx-rs:trunk' into dev/windows-os-transparent

b8131bf

n1ght-hunter requested review from crowlKats and a team as code owners April 16, 2025 06:17

Add Dcomp support to DX12 backend in changelog

1f70a9a

cwfitzgerald requested changes Apr 16, 2025

View reviewed changes

wgpu-hal/src/dx12/mod.rs Outdated Show resolved Hide resolved

wgpu-types/src/instance.rs Outdated Show resolved Hide resolved

wgpu-hal/src/dx12/mod.rs Outdated Show resolved Hide resolved

wgpu-hal/src/dx12/mod.rs Show resolved Hide resolved

cwfitzgerald self-assigned this Apr 16, 2025

n1ght-hunter added 7 commits April 23, 2025 16:28

move decomp to another module

60a747c

refactor: replace use_dcomp with presentation_system in Dx12BackendOp…

8b012f3

…tions

refactor: enhance Dx12PresentationSystem with Copy, PartialEq, and Eq…

91d98af

… traits

refactor: replace use_dcomp with presentation_system in Dx12 backend …

bae60c3

…options

Merge branch 'trunk' into dev/windows-os-transparent

194a685

refactor: update Dx12BackendOptions to use presentation_system instea…

32ce523

…d of use_dcomp

Merge branch 'dev/windows-os-transparent' of https://github.com/n1ght…

157c1c6

…-hunter/wgpu into dev/windows-os-transparent

n1ght-hunter requested a review from cwfitzgerald April 23, 2025 04:48

Merge branch 'trunk' into dev/windows-os-transparent

cd41a6e

cwfitzgerald requested changes May 29, 2025

View reviewed changes

wgpu-hal/src/dx12/dcomp.rs Outdated Show resolved Hide resolved

wgpu-hal/src/dx12/dcomp.rs Outdated Show resolved Hide resolved

MarijnS95 reviewed Jul 6, 2025

View reviewed changes

wgpu-hal/src/dx12/dcomp.rs Outdated Show resolved Hide resolved

This was referenced Jul 6, 2025

Increased input-to-screen latency on vulkan #6932

Open

Extended Presentation API Investigation #2869

Open

cwfitzgerald changed the title ~~Add dcomp on windows~~ Add support for builtin DComp swapchains Aug 13, 2025

cwfitzgerald requested changes Aug 13, 2025

View reviewed changes

n1ght-hunter and others added 8 commits August 15, 2025 01:06

Update wgpu-types/src/instance.rs

62758fe

Co-authored-by: Connor Fitzgerald <[email protected]>

Update wgpu-types/src/instance.rs

25f68fa

Co-authored-by: Connor Fitzgerald <[email protected]>

Update wgpu-types/src/instance.rs

7b5d124

Co-authored-by: Connor Fitzgerald <[email protected]>

Update wgpu-types/src/instance.rs

eab2de6

Co-authored-by: Connor Fitzgerald <[email protected]>

Update CHANGELOG.md

a9ddf45

Co-authored-by: Connor Fitzgerald <[email protected]>

Update CHANGELOG.md

55659a1

Co-authored-by: Connor Fitzgerald <[email protected]>

Merge branch 'trunk' into dev/windows-os-transparent

92afbbc

fmt

783e730

n1ght-hunter requested a review from cwfitzgerald August 14, 2025 13:20

MarijnS95 reviewed Aug 14, 2025

View reviewed changes

Update CHANGELOG.md

1a9ff41

Co-authored-by: Marijn Suijten <[email protected]>

n1ght-hunter added 3 commits September 2, 2025 19:56

use a single scope profle for all of DCompState init

1fd08cf

Allow "directcomposition" as an alias for "dcomp" in Dx12SwapchainKind

e5589fd

Merge branch 'trunk' into dev/windows-os-transparent

bdb0a22

cwfitzgerald approved these changes Sep 10, 2025

View reviewed changes

cwfitzgerald added 2 commits September 10, 2025 20:08

Final tweeks

2410441

merge

a21b4d1

cwfitzgerald force-pushed the dev/windows-os-transparent branch from 3b85cea to a21b4d1 Compare September 11, 2025 00:09

cwfitzgerald enabled auto-merge (squash) September 11, 2025 00:12

cwfitzgerald merged commit 3902b0c into gfx-rs:trunk Sep 11, 2025
40 checks passed

MarijnS95 reviewed Sep 11, 2025

View reviewed changes

oscartbeaumont mentioned this pull request Sep 14, 2025

DComp Swapchains CapSoftware/Cap#1009

Draft


		This creates a single `IDCompositionVisual` over the entire window that is used by the `Surface`. If a user wants to manage the composition tree themselves, they should create their own device and composition, and pass the relevant visual down into `wgpu` via `IDCompositionTarget::CompositionVisual` or `IDCompositionTarget::SurfaceHandle`.
		This creates a single `IDCompositionVisual` over the entire window that is used by the mf`Surface`. If a user wants to manage the composition tree themselves, they should create their own device and composition, and pass the relevant visual down into `wgpu` via `SurfaceTargetUnsafe::CompositionVisual`.

		/// - `DxgiFromVisual` or `Visual`
		/// - `DxgiFromHwnd` or `Hwnd` for [`Self::DxgiFromHwnd`]

Add support for builtin DComp swapchains #7550

Add support for builtin DComp swapchains #7550

Conversation

n1ght-hunter commented Apr 16, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

cwfitzgerald left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

n1ght-hunter commented Apr 17, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

n1ght-hunter commented May 6, 2025

Uh oh!

cwfitzgerald left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Anutrix commented May 30, 2025

Uh oh!

cwfitzgerald commented May 30, 2025

Uh oh!

melody-rs commented Jun 3, 2025

Uh oh!

n1ght-hunter commented Jun 10, 2025

Uh oh!

cwfitzgerald commented Jun 25, 2025

Uh oh!

MarijnS95 commented Jul 6, 2025

Uh oh!

Uh oh!

n1ght-hunter commented Aug 4, 2025

Uh oh!

cwfitzgerald left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

MarijnS95 Aug 14, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

n1ght-hunter commented Aug 14, 2025

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

MarijnS95 Aug 14, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

melody-rs commented Aug 14, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

n1ght-hunter commented Aug 15, 2025

Uh oh!

cwfitzgerald commented Aug 20, 2025

Uh oh!

n1ght-hunter commented Apr 16, 2025 •

edited

Loading

n1ght-hunter commented Apr 17, 2025 •

edited

Loading

MarijnS95 Aug 14, 2025 •

edited

Loading

MarijnS95 Aug 14, 2025 •

edited

Loading

melody-rs commented Aug 14, 2025 •

edited

Loading