Screenshot Service Enhancements

[PatrickJnr]

Screenshot Service Enhancements

This PR introduces new features to the screenshot system, enhancing format flexibility and adding UI-free capture modes.

New Commands

Command	Description
screenshot_clean	Take a screenshot without UI overlay
screenshot_highres_clean <w> <h>	Take a high-res screenshot without UI

New ConVars

ConVar	Default	Description
screenshot_format	PNG	Output format: PNG, JPEG, or WebP
screenshot_quality	90	Quality for lossy formats (1-100)
screenshot_cursor	false	Include mouse cursor (Windows only)
screenshot_steam	true	Add screenshots to Steam library
screenshot_highres_msaa	16	MSAA level for high-res (1, 2, 4, 8, 16)

New Events

• ScreenshotService.OnScreenshotCaptured - Static event fired after any screenshot is saved
• ScreenshotCapturedEventArgs - Provides FilePath, Width, Height, Format, FileSize, IsHighRes

Usage Examples

Clean screenshots (no UI):

• screenshot_clean
• screenshot_highres_clean 3840 2160

WebP for smaller files:

• screenshot_format WebP
• screenshot_quality 95
• screenshot

Custom MSAA for high-res:

• screenshot_highres_msaa 8
• screenshot_highres 6880 2880

Files Changed

• ScreenshotService.cs - Core implementation with format/quality/clean capture support
• Game.cs - Added screenshot_clean and screenshot_highres_clean commands
• Graphics.Hooks.cs - Added SuppressUI flag for clean screenshots
• CameraComponent.cs - Added SuppressUI check in OnCameraRenderUI

Screenshots

With and without UI

With UI	Without UI

WebP 90% Quality vs 1% Quality

90% Quality	1% Quality

MSAA 1 vs 16

MSAA x1	MSAA x16

[handsomematt]

Up to you @lolleko this is your stuff

[lolleko]

Thanks for the PR, but I think those are too many options.
Could you please explain why you need each of them? I would prefer not to add 600 lines of code unless they provide significant value.

• screenshot_format i think just PNG is fine, it's lossless, you can convert it to whatever you want.
• screenshot_quality we had this before, but no one used it. I don't see why you would ever want a low quality jpeg. For the 1% that do need a low qual jpeg, they are able to take the PNG and convert it.
• screenshot_highres_msaa again why would you ever want a lower quality image?
• screenshot_steam makes sense
• screenshot_clean hard no for this one. In editor you can just disable the UI via inspector. For in-game I would prefer a separate command that disables the UI layer (this should be a another PR though).
• screenshot_cursor This seems completely unnecessary, why do you need this?

TL;DR you sold me on screenshot_steam, for the rest I would like to hear what value they add.

[xezno]

It would have been nice if these weren't just commands at this point, but had a place in the editor somewhere

[PatrickJnr]

• screenshot_steam makes sense
• screenshot_clean hard no for this one. In editor you can just disable the UI via inspector. For in-game I would prefer a separate command that disables the UI layer (this should be a another PR though).

I could remove the other commands and have it just screenshot_steam and I could do a PR for screenshot_clean or a keybind to turn off the UI briefly and takes the shot.

[PatrickJnr]

I messed up with some stuff, I'm going to close this pr and create a new one