capture-screenshot crashes Unreal Editor after PIE menu UI is open

[softdaddy-o]

Description

While using the CLI to capture an Unreal Editor/PIE viewport with an in-game menu UI open, the capture-screenshot command threw a Windows structured exception and the editor session became inconsistent. Follow-up capture calls failed because the connection to the editor bridge was closed or returned HTTP 404. A crash reporter window opened after the failure.

Steps to Reproduce

1. Start Unreal Editor with a project that has SoftUEBridge enabled.
2. Start PIE and open an in-game fullscreen menu UI, specifically an equipment/inventory-style UMG menu.
3. Run capture-screenshot window --format jpeg --output file.
4. In parallel or immediately after, run capture-screenshot viewport --format jpeg --output file or capture-viewport --source game --format jpeg --output file.
5. Observe that the first capture can fail with a Windows structured exception and later bridge calls fail with closed connection/HTTP 404.

Expected Behavior

Screenshot capture should either save the requested image or return a non-fatal error. It should not crash or destabilize Unreal Editor, and follow-up bridge calls should remain usable.

Actual Behavior

capture-screenshot failed with: Windows structured exception 0x00004000 in tool 'capture-screenshot'. UE state may be inconsistent. A subsequent viewport capture failed with [WinError 10054] An existing connection was forcibly closed by the remote host, and capture-viewport returned HTTP 404. The editor session was disrupted and a crash reporter process opened.

System Information

• CLI version: 1.25.10
• Python: 3.12.12
• OS: Windows-11-10.0.26200-SP0
• Bridge: unreachable

[softdaddy-o]

Fixed in v1.28.0. Install with: pip install soft-ue-cli==1.28.0. capture-screenshot now validates captured image dimensions and pixel count before compression to avoid editor crashes from invalid buffers.