Skip to main content

SharedTextureUnavailableReason

Electron APIs / overlay / SharedTextureUnavailableReason

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

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, or from the first launch with Chromium's force_high_performance_gpu switch (see IOverwolfOverlayApi.setGpuPreference).
  • 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.
  • handleTransportBlocked—The GPU textures could not be handed to the game process at all. Nothing the application can do; the overlay uses the CPU copy path for this game.

See​

IOverwolfOverlayApi.on shared-texture-unavailable.

Since​

2.0.5