Summary
manage_scene(action="screenshot", capture_source="game_view", include_image=true) can miss UI Toolkit overlays in Play Mode.
Problem
When include_image=true is used without an explicit camera target, the screenshot path captures through camera rendering so it can return image bytes inline in the response.
That misses UI Toolkit content because UI Toolkit is composited after the camera render.
Expected behavior
When requesting a game_view screenshot with include_image=true in Play Mode, the returned inline image should include the final composited frame, including UI Toolkit overlays.
Repro
- Enter Play Mode in a scene that displays UI Toolkit content in the Game view.
- Call
manage_scene(action="screenshot", capture_source="game_view", include_image=true).
- Inspect the returned image.
- Observe that world rendering is present but UI Toolkit overlays are missing.
Proposed fix
Use composited frame capture for the affected inline-image path, while keeping existing behavior for explicit camera screenshots and other screenshot modes.
Notes
This appears specific to the game_view + include_image=true Play Mode path.
Summary
manage_scene(action="screenshot", capture_source="game_view", include_image=true)can miss UI Toolkit overlays in Play Mode.Problem
When
include_image=trueis used without an explicit camera target, the screenshot path captures through camera rendering so it can return image bytes inline in the response.That misses UI Toolkit content because UI Toolkit is composited after the camera render.
Expected behavior
When requesting a
game_viewscreenshot withinclude_image=truein Play Mode, the returned inline image should include the final composited frame, including UI Toolkit overlays.Repro
manage_scene(action="screenshot", capture_source="game_view", include_image=true).Proposed fix
Use composited frame capture for the affected inline-image path, while keeping existing behavior for explicit camera screenshots and other screenshot modes.
Notes
This appears specific to the
game_view+include_image=truePlay Mode path.