Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

Windows transparent margins composite as black: bundled GLFW redirection alpha is uninitialized

オープン
#109 コメント 1 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 2 日以内に返信

@Linductor-alkaid がすでに取り組んでいます。

2026年10月14日 から。

  • #112 @Linductor-alkaid による — オープン

評価

難易度
4/5
見積もり時間
3〜5日
初心者へのやさしさ
22/100
issue の種類
バグ
明瞭さ
おおむね明確
活発さ
活発
技術スタック
cpp

調査の方向性

Start with the bundled GLFW 3.4 Win32 windowProc, specifically the WM_PAINT branch, and compare it with the upstream fix in glfw/glfw#2815 that is referenced in the issue. Then run the transparent_window_viewer fixture on Windows and check the corner RGBA values. Done means the transparent margin shows the desktop instead of black, opaque windows are unchanged, and the four backend Release build/test checks pass. The work is already in progress by the author, so coordinate before starting.

索引モデルが issue の本文から書いたものです。

説明

Reproduction

Windows 11 build 26200, NVIDIA RTX 3070 Ti Laptop GPU, driver 32.0.15.9174, MSVC 19.44 x64. EUI dev 89c2d0f.
Build and launch the GLFW/OpenGL transparent_window_viewer fixture. Its 36px outer margin intermittently becomes black even though framebufferTransparent is true. The user confirmed black margins on the actual desktop. Mirage reproduces black rounded corners with the same dependency.

Confirmed isolation and repair

Instrumenting the actual fixture reports corner RGBA=0,0,0,0 with glGetError=0. Clearing the GL default framebuffer was an initial hypothesis; it did not reliably fix the real fixture and has been discarded. A controlled compositor test can also pass on the old code when DWM's backing allocation happens to be zeroed, which explains the intermittent behavior.

The missing initialization is in GLFW's Win32 DWM redirection surface, independently of GL framebuffer alpha. GLFW already tracks this issue in https://github.com/glfw/glfw/issues/2816 and proposed fix https://github.com/glfw/glfw/pull/2815. The bundled 3.4 windowProc has only a damage notification for WM_PAINT and does not define that surface's alpha.

Backporting the small transparent-only WM_PAINT PatBlt(BLACKNESS) repair restores actual desktop transparency on this machine: the formerly black outer margin now shows the wallpaper and desktop icons. Opaque window handling, renderer framebuffer and application geometry stay unchanged; no region crop or color key is used.

A compositor regression uses an owned known-color background and cached UI rendering. Four backend Release build/test checks and relevant fixture inspection are in progress. The separate existing Windows SDL2 compilation blocker is tracked in #110 so it can be reviewed independently.

主要言語
C++
スター
2k
フォーク
177
平均マージ
19時間 58分
マージ済み PR(30日)
9

環境構築

このプロジェクトには開発コンテナ、Dockerfile、コントリビューションガイドがありません。まず README を読み、一般的な手順ははじめてのコントリビューションガイドを参照してください。

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

sudoevolve/EUI-NEO のほかの issue

sudoevolve/EUI-NEO の issue をすべて見る

似ている issue

C++ の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。