Skip to main content

SharedTextureUnavailableReason

Electron APIs / overlay / SharedTextureUnavailableReason

type SharedTextureUnavailableReason =
| "unsupportedGraphicsApi"
| "gpuAdapterMismatch"
| "copyFailure";

Why the shared-texture rendering path cannot be used with the current game.

  • unsupportedGraphicsApi—The game's graphics API cannot composite GPU textures (D3D9 / OpenGL / Vulkan). Nothing to fix; the overlay uses the CPU copy path for this game.
  • gpuAdapterMismatch—The game renders on a different GPU adapter than Chromium, and a shared texture handle can only be opened on the adapter that created it. Fixable with IOverwolfOverlayApi.setGpuPreference and an application restart.
  • copyFailure—The game repeatedly failed to open the shared texture handles it received in-game. The overlay retried, then fell back to the CPU copy path. IOverwolfOverlayApi.setGpuPreference may help when the root cause is adapter-related.

See

IOverwolfOverlayApi.on shared-texture-unavailable.

Since

2.0.5