DxSetRenderTarget

From Multi Theft Auto: Wiki
Revision as of 23:44, 13 June 2011 by Ccw (talk | contribs) (Created page with "{{Client function}} __NOTOC__ {{New feature|3.0110|1.1| Only available in 1.1 }} This function changes the drawing destination for the dx functions. It can be used to select a pr...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Only available in 1.1 This function changes the drawing destination for the dx functions. It can be used to select a previously created render target, or if called with no arguments, restore drawing directly to the screen.

Syntax

bool dxSetShaderRenderTarget ( [element renderTarget] )

Optional Arguments

  • renderTarget: The render target element whose pixels we want to draw on.

If no arguments are supplied, the screen is restored as the drawing destination.

Returns

Returns true if the render target was successfully changed, false otherwise.

Example

addEventHandler("onClientResourceStart", resourceRoot,
    function()
        myRenderTarget = dxCreateRenderTarget( 80, 100 )  -- Create a render target texture which is 80 x 100 pixels
    end
)

addEventHandler( "onClientRender", root,
    function()
        if myRenderTarget then
            dxSetRenderTarget( myRenderTarget )  -- Select custom render target
            dxDrawText ( "Hello", 10, 20 )       -- This will be drawn on myRenderTarget

            dxSetRenderTarget()                  -- Select default render target
            dxDrawText ( "Hello", 10, 20 )       -- This will be drawn directly to the screen
        end
    end
)

See Also