Surge at 20:42, 23 December 2018

2018-12-23T20:42:15Z

← Older revision		Revision as of 20:42, 23 December 2018
Line 1:		Line 1:
	{{Client function}}		{{Client function hu}}
	__NOTOC__		__NOTOC__
	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.		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~~==		==Szintaxis==
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	bool dxSetRenderTarget ( [ element renderTarget, bool clear = false ] )		bool dxSetRenderTarget ( [ element renderTarget, bool clear = false ] )
Line 12:		Line 12:
	{{OOP\|\|[[texture\|rendertarget]]:setAsTarget}}		{{OOP\|\|[[texture\|rendertarget]]:setAsTarget}}

	===~~Optional Arguments~~===		===Tetszőleges paraméter===
	*'''renderTarget:''' The render target element whose pixels we want to draw on.		*'''renderTarget:''' The render target element whose pixels we want to draw on.
	*'''clear:''' If set to true, the render target will also be cleared.		*'''clear:''' If set to true, the render target will also be cleared.

	===~~Returns~~===		===Visszatérési érték===
	Returns ''true'' if the render target was successfully changed, ''false'' otherwise.		Returns ''true'' if the render target was successfully changed, ''false'' otherwise.

Line 28:		Line 28:
	}}		}}

	==~~Example~~==		==Példa==
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	addEventHandler("onClientResourceStart", resourceRoot,		addEventHandler("onClientResourceStart", resourceRoot,
Line 77:		Line 77:
	{{ChangelogItem\|1.3.0-9.04431\|Removed restrictions on when dxSetRenderTarget could be called}}		{{ChangelogItem\|1.3.0-9.04431\|Removed restrictions on when dxSetRenderTarget could be called}}

	==~~See Also~~==		==Lásd még==
	{{Drawing_functions}}		{{Drawing_functions hu}}

	[[en:dxSetRenderTarget]]		[[en:dxSetRenderTarget]]

Surge: Created page with "{{Client function}} NOTOC This function changes the drawing destination for the dx functions. It can be used to select a previously created render target, or if called wit..."

2018-12-23T20:41:19Z

Created page with "{{Client function}} __NOTOC__ This function changes the drawing destination for the dx functions. It can be used to select a previously created render target, or if called wit..."

New page

{{Client function}}
__NOTOC__
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==
<syntaxhighlight lang="lua">
bool dxSetRenderTarget ( [ element renderTarget, bool clear = false ] )
</syntaxhighlight>

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

{{OOP||[[texture|rendertarget]]:setAsTarget}}

===Optional Arguments===
*'''renderTarget:''' The render target element whose pixels we want to draw on.
*'''clear:''' If set to true, the render target will also be cleared.

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

==Usage restrictions==
*Items drawn with ''postGUI'' set to ''true'' will not appear on a custom render target.
{{Deprecated feature|3.0131|1.3.0-9.04431|
*dxSetRenderTarget can only be called during the [[onClientRender]], [[onClientHUDRender]] and [[onClientRestore]] events.
}}
{{New_feature|3.0131|1.3.0-9.04431|
*dxSetRenderTarget can be set at any time as long as <min_mta_version> in [[meta.xml]] is set to at least 1.3.0-9.04431 e.g. '''<min_mta_version client<nowiki>=</nowiki>"1.3.0-9.04431" />'''
}}

==Example==
<syntaxhighlight lang="lua">
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 ) -- The message 'Hello' will be drawn on myRenderTarget

dxSetRenderTarget() -- Select default render target
dxDrawText ( "Goodbye", 10, 20 ) -- The message 'Goodbye' will be drawn directly to the screen
end
end
)
</syntaxhighlight>

This example shows how you can prepare render target contents at anytime (from client version 1.3.0-9.04431)
<syntaxhighlight lang="lua">
addEventHandler("onClientResourceStart", resourceRoot,
function()
myRenderTarget = dxCreateRenderTarget( 80, 100 ) -- Create a render target texture which is 80 x 100 pixels
dxSetRenderTarget( myRenderTarget ) -- Select custom render target for drawing
dxDrawRectangle ( 2, 2, 60, 60, tocolor(255,255,0) ) -- Draw anything you like (to the render target)
dxDrawText ( "Hello", 10, 20 )
dxDrawText ( "This is", 10, 40 )
dxDrawText ( "Amazing", 10, 60 )
dxSetRenderTarget() -- Unselect custom render target
end
)

addEventHandler( "onClientRender", root,
function()
if myRenderTarget then
dxDrawImage ( 100, 200, 80, 100, myRenderTarget ) -- Draw myRenderTarget content to the screen
end
end
)
</syntaxhighlight>

==Changelog==
{{ChangelogHeader}}
{{ChangelogItem|1.3.0-9.04431|Removed restrictions on when dxSetRenderTarget could be called}}

==See Also==
{{Drawing_functions}}

[[en:dxSetRenderTarget]]

HU/dxSetRenderTarget - Revision history

Surge at 20:42, 23 December 2018

Surge: Created page with "{{Client function}} __NOTOC__ This function changes the drawing destination for the dx functions. It can be used to select a previously created render target, or if called wit..."

Surge: Created page with "{{Client function}} NOTOC This function changes the drawing destination for the dx functions. It can be used to select a previously created render target, or if called wit..."