Garry's Mod Wiki



string render.Capture( table captureData )


Captures a part of the current render target and returns the data as a binary string in the given format.

Since the pixel buffer clears itself every frame, this will return a black screen outside of. To capture the user's final view, use GM:PostRender. This will not capture the Steam overlay or third-party injections (such as the Discord overlay, Overwolf, and advanced cheats) on the user's screen.

In PNG mode, this function can produce unexpected result where foreground is rendered as transparent. This is caused by render.SetWriteDepthToDestAlpha set to true when doing most of render operations, including rendering in _rt_fullframefb. If you want to capture render target's content as PNG image only for output quality, set Structures/RenderCaptureData's alpha to false when capturing render targets with render.SetWriteDepthToDestAlpha set to true.

Issue Tracker: 2571


1 table captureData
Parameters of the capture. See Structures/RenderCaptureData.


1 string


How you could use this to save a picture of your screen.

local ScreenshotRequested = false function RequestAScreenshot() ScreenshotRequested = true end -- For the sake of this example, we use a console command to request a screenshot concommand.Add( "make_screenshot", RequestAScreenshot ) hook.Add( "PostRender", "example_screenshot", function() if ( !ScreenshotRequested ) then return end ScreenshotRequested = false local data = render.Capture( { format = "png", x = 0, y = 0, w = ScrW(), h = ScrH() } ) file.Write( "image.png", data ) end )
Output: You should now have image.png in your garrysmod/data folder, containing a screenshot.

Special Pages



Render Time: 59ms

DB GetPage 32
Generate Html 6
SaveChanges (1) 13
Render Body 0
Render Sidebar 6