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
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Client function}}
{{Client function}}
__NOTOC__
__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 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==  
Line 10: Line 9:
element dxCreateScreenSource ( int width, int height )
element dxCreateScreenSource ( int width, int height )
</syntaxhighlight>  
</syntaxhighlight>  
 
{{OOP||[[Texture|DxScreenSource]]}}
===Required Arguments===  
===Required Arguments===  
*'''width :''' The width of the texture in pixels.
*'''width :''' The width of the texture in pixels.
Line 41: Line 40:
==See Also==
==See Also==
{{Drawing_functions}}
{{Drawing_functions}}
[[hu:dxCreateScreenSource]]

Latest revision as of 10:38, 15 October 2018

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 )

OOP Syntax Help! I don't understand this!

Method: DxScreenSource(...)


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