Skip to content
Multi Theft Auto: Wiki

dxCreateScreenSource

Client-side

This function creates a screen source, which is a special type of texture that contains the screen as rendered by GTA.

Tip
  • It is highly recommended that dxSetTestMode is used when writing and testing scripts using dxCreateScreenSource.
  • Successful screen source creation is not guaranteed, and may fail due to hardware or memory limitations. You should always check to see if this function has returned false.

OOP Syntax Help! I don't understand this!

Syntax 

​dx-screensource|false dxCreateScreenSource ( ​int width, ​int height )
Required arguments
  • width: The width of the texture in pixels.
  • height: The height of the texture in pixels.

Returns

Returns a texture element if successful, false if invalid arguments were passed to the function or there is insufficient resources available.

  • dx-screensource|false: screensource-texture

Code Examples

client 
local myScreenSource


addEventHandler("onClientResourceStart", resourceRoot, function()
    myScreenSource = dxCreateScreenSource(640, 480) -- Create a screen source texture which is 640 x 480 pixels
end)


addEventHandler("onClientRender", root, function()
    if myScreenSource then
        dxUpdateScreenSource(myScreenSource) -- Capture the current screen output from GTA
        dxDrawImage(50, 50, 100, 100, myScreenSource) -- Now use myScreenSource as a material and draw it lots of times
        dxDrawImage(150, 350, 150, 100, myScreenSource)
        dxDrawImage(250, 250, 100, 150, myScreenSource)
        dxDrawImage(350, 30, 150, 150, myScreenSource)
    end
end)

See Also

Drawing Functions
Drawing Elements
Reference