DxCreateScreenSource: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Created page with "{{Client function}} __NOTOC__ {{New feature|3.0110|1.1| Only available in 1.1 }} This function creates a screen source, which is a special type of texture that contains the s...")
 
No edit summary
Line 5: Line 5:
}}
}}
This function creates a screen source, which is a special type of [[texture]] that contains the screen as rendered by GTA
This function creates a screen source, which is a special type of [[texture]] that contains the screen as rendered by GTA
Note that 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.


==Syntax==  
==Syntax==  

Revision as of 15:49, 14 June 2011

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

Note that 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.

Syntax

element 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.

Example

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