DxCreateRenderTarget - Revision history

Einheit-101: /* Required Arguments */

2025-01-09T23:37:55Z

Required Arguments

← Older revision		Revision as of 23:37, 9 January 2025
Line 23:		Line 23:
	*'''withAlpha:''' The render target will be created with an alpha channel. 'false' will turn images' alpha channels to black color		*'''withAlpha:''' The render target will be created with an alpha channel. 'false' will turn images' alpha channels to black color
	{{Added feature/item\|1.6.1\|1.6.0\|21938\|		{{Added feature/item\|1.6.1\|1.6.0\|21938\|
	*'''surfaceFormat :''' See [[Surface format\|Surface formats]]		*'''surfaceFormat :''' A string containing the surface format. See [[Surface format\|Surface formats]]. Default format without alpha is "x8r8g8b8", default with alpha is "a8r8g8b8".
	}}		}}

CrosRoad95 at 16:34, 10 August 2023

2023-08-10T16:34:17Z

← Older revision		Revision as of 16:34, 10 August 2023
Line 12:		Line 12:
	element dxCreateRenderTarget ( int width, int height [, bool withAlpha = false ] )		element dxCreateRenderTarget ( int width, int height [, bool withAlpha = false ] )
	</syntaxhighlight>		</syntaxhighlight>
			{{Added feature/item\|1.6.1\|1.6.0\|21938\|
			<syntaxhighlight lang="lua">
			element dxCreateRenderTarget ( int width, int height, surface-format surfaceFormat )
			</syntaxhighlight>
			}}
	{{OOP\|\|[[Texture\|DxRenderTarget]]}}		{{OOP\|\|[[Texture\|DxRenderTarget]]}}
	===Required Arguments===		===Required Arguments===
Line 17:		Line 22:
	*'''height :''' The height of the texture in pixels.		*'''height :''' The height of the texture in pixels.
	*'''withAlpha:''' The render target will be created with an alpha channel. 'false' will turn images' alpha channels to black color		*'''withAlpha:''' The render target will be created with an alpha channel. 'false' will turn images' alpha channels to black color
			{{Added feature/item\|1.6.1\|1.6.0\|21938\|
			*'''surfaceFormat :''' See [[Surface format\|Surface formats]]
			}}

	===Returns===		===Returns===

LopSided: typo

2021-08-21T17:08:59Z

typo

← Older revision		Revision as of 17:08, 21 August 2021
Line 28:		Line 28:
	A render target is like a blank canvas. You can draw on the render target as many times as you like - and even clear it.		A render target is like a blank canvas. You can draw on the render target as many times as you like - and even clear it.

	If your dxDraw* calls are static (meaning the appearance doesn't change), or only ~~updates~~ periodically, then a render target can be useful not only for cleaner code - but for performance reasons too. Instead of making possibly hundreds of dxDraw* calls every frame, you can simply make those calls on a single frame and draw directly to the render target, then use a '''single''' dxDrawImage call every frame afterwards to display the render target.		If your dxDraw* calls are static (meaning the appearance doesn't change), or only update periodically, then a render target can be useful not only for cleaner code - but for performance reasons too. Instead of making possibly hundreds of dxDraw* calls every frame, you can simply make those calls on a single frame and draw directly to the render target, then use a '''single''' dxDrawImage call every frame afterwards to display the render target.

	Render targets can also be used to create and display the same thing multiple times, as shown in the example below.		Render targets can also be used to create and display the same thing multiple times, as shown in the example below.

LopSided: Update explanation of render target

2021-08-21T17:06:55Z

Update explanation of render target

← Older revision		Revision as of 17:06, 21 August 2021
Line 24:		Line 24:

	==Explanation==		==Explanation==
	What is a ~~rendertarget~~?		What is a render target?
	A ~~rendertarget~~ is like a ~~big, white paper(or if you set alpha to true, it will be a transparent paper) that you~~ can draw on,
	~~after you drawn on it, you can draw it~~ as many times as you like~~, without impacting performance~~. ~~It could be used for~~		A render target is like a blank canvas. You can draw on the render target as many times as you like - and even clear it.
	~~dashboard, where a few hundred~~ dxDraw* ~~functions~~ are ~~called~~, so, ~~instead~~ of ~~calling these~~ every frame, you can ~~just~~
	~~draw it~~ on a render target, ~~and draw~~ the render target, ~~instead of every information one by one~~.		If your dxDraw* calls are static (meaning the appearance doesn't change), or only updates periodically, then a render target can be useful not only for cleaner code - but for performance reasons too. Instead of making possibly hundreds of dxDraw* calls every frame, you can simply make those calls on a single frame and draw directly to the render target, then use a '''single''' dxDrawImage call every frame afterwards to display the render target.

			Render targets can also be used to create and display the same thing multiple times, as shown in the example below.

LopSided: Minor formatting / layout change

2021-08-21T16:50:06Z

Minor formatting / layout change

← Older revision		Revision as of 16:50, 21 August 2021
Line 37:		Line 37:
	addEventHandler("onClientResourceStart", resourceRoot,		addEventHandler("onClientResourceStart", resourceRoot,
	function()		function()
	myRenderTarget = dxCreateRenderTarget(250, 100, true) -- Create a render target		myRenderTarget = dxCreateRenderTarget(250, 100, true) -- Create a render target

	if (myRenderTarget) then		if (myRenderTarget) then
	updateRenderTarget()		updateRenderTarget() -- Our function to draw to the render target (see below)
	end		end
	end		end
Line 57:		Line 57:
	)		)

	--
	~~-- Function to draw text to our render target with '''modulate_add''' blend mode when the 'r' key is pressed~~
	--
	function updateRenderTarget()		function updateRenderTarget()
	dxSetRenderTarget(myRenderTarget, true)		dxSetRenderTarget(myRenderTarget, true)
	dxSetBlendMode("modulate_add") -- Set 'modulate_add' when drawing stuff on the render target		dxSetBlendMode("modulate_add") -- Set 'modulate_add' when drawing stuff on the render target

	dxDrawText("Hello " .. getTickCount(), 10, 10, 0, 0, tocolor(255, 255, 255, 255), 2, "clear") -- Draw a message		dxDrawText("Hello " .. getTickCount(), 10, 10, 0, 0, tocolor(255, 255, 255, 255), 2, "clear") -- Draw a message
	dxDrawRectangle(10, 50, 40, 40, tocolor(math.random(255), math.random(255), math.random(255))) -- Draw a square with random color		dxDrawRectangle(10, 50, 40, 40, tocolor(math.random(255), math.random(255), math.random(255))) -- Draw a square with random color

	-- ... etc, imagine you have a lot of dxDraw* calls to make, this is where render targets come in handy!		-- ... etc, imagine you have a lot of dxDraw* calls to make, this is where render targets come in handy!

	dxSetBlendMode("blend") -- Restore default blending		dxSetBlendMode("blend") -- Restore default blending
	dxSetRenderTarget() -- Restore default render target		dxSetRenderTarget() -- Restore default render target
	end		end

			-- We can even update the render target on the fly, by binding it to a key
	bindKey("r", "down", updateRenderTarget)		bindKey("r", "down", updateRenderTarget)

LopSided at 16:38, 21 August 2021

2021-08-21T16:38:59Z

← Older revision		Revision as of 16:38, 21 August 2021
Line 66:		Line 66:
	dxDrawText("Hello " .. getTickCount(), 10, 10, 0, 0, tocolor(255, 255, 255, 255), 2, "clear") -- Draw a message		dxDrawText("Hello " .. getTickCount(), 10, 10, 0, 0, tocolor(255, 255, 255, 255), 2, "clear") -- Draw a message
	dxDrawRectangle(10, 50, 40, 40, tocolor(math.random(255), math.random(255), math.random(255))) -- Draw a square with random color		dxDrawRectangle(10, 50, 40, 40, tocolor(math.random(255), math.random(255), math.random(255))) -- Draw a square with random color

			-- ... etc, imagine you have a lot of dxDraw* calls to make, this is where render targets come in handy!

	dxSetBlendMode("blend") -- Restore default blending		dxSetBlendMode("blend") -- Restore default blending

LopSided: Update example to actually make sense and use this feature properly

2021-08-21T16:36:53Z

Update example to actually make sense and use this feature properly

← Older revision		Revision as of 16:36, 21 August 2021
Line 33:		Line 33:
	==Example==		==Example==
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	local myRenderTarget ~~= dxCreateRenderTarget(500, 500, true)~~		local myRenderTarget

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

			if (myRenderTarget) then
			updateRenderTarget()
			end
	end		end
	)		)
Line 43:		Line 48:
	function()		function()
	if myRenderTarget then		if myRenderTarget then
	~~dxSetRenderTarget( myRenderTarget ) -- Start drawing on myRenderTarget~~		-- Draw the render target lots of times in different positions on the screen
	~~dxDrawText ( "Hello", 10, 20 )~~ -- Draw ~~a message~~		dxDrawImage(350, 50, 250, 100, myRenderTarget)
	~~dxSetRenderTarget() -- Stop drawing~~ on ~~myRenderTarget~~		dxDrawImage(450, 380, 250, 100, myRenderTarget)
			dxDrawImage(550, 250, 250, 100, myRenderTarget)
	dxDrawImage( 50, 50, ~~100~~, 100, myRenderTarget ) ~~-- Now use myRenderTarget as a material and draw it lots of times~~		dxDrawImage(650, 70, 250, 100, myRenderTarget)
	dxDrawImage( ~~150~~, ~~350~~, ~~150~~, 100, myRenderTarget )
	dxDrawImage( 250, 250, 100~~, 150~~, myRenderTarget )
	dxDrawImage( ~~350~~, 30, ~~150~~, ~~150~~, myRenderTarget )
	end		end
	end		end
Line 62:		Line 64:
	dxSetBlendMode("modulate_add") -- Set 'modulate_add' when drawing stuff on the render target		dxSetBlendMode("modulate_add") -- Set 'modulate_add' when drawing stuff on the render target

	dxDrawText("~~Testing~~ "..getTickCount(), 0, 0, 0, 0, tocolor(255, 255, 255, 255), 2, "clear")		dxDrawText("Hello " .. getTickCount(), 10, 10, 0, 0, tocolor(255, 255, 255, 255), 2, "clear") -- Draw a message
			dxDrawRectangle(10, 50, 40, 40, tocolor(math.random(255), math.random(255), math.random(255))) -- Draw a square with random color

	dxSetBlendMode("blend") -- Restore default blending		dxSetBlendMode("blend") -- Restore default blending
	dxSetRenderTarget() -- Restore default render target		dxSetRenderTarget() -- Restore default render target
	end		end
	bindKey("r", "down", updateRenderTarget )		bindKey("r", "down", updateRenderTarget)

	</syntaxhighlight>		</syntaxhighlight>

Konders: Fixed example, now its works fine

2020-02-16T06:23:21Z

Fixed example, now its works fine

← Older revision		Revision as of 06:23, 16 February 2020
Line 33:		Line 33:
	==Example==		==Example==
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
			local myRenderTarget = dxCreateRenderTarget(500, 500, true)
	addEventHandler("onClientResourceStart", resourceRoot,		addEventHandler("onClientResourceStart", resourceRoot,
	function()		function()
Line 53:		Line 54:
	end		end
	)		)

	~~local myRenderTarget = dxCreateRenderTarget(500, 500, true)~~

	--		--

Surge at 14:39, 14 October 2018

2018-10-14T14:39:43Z

← Older revision		Revision as of 14:39, 14 October 2018
Line 74:		Line 74:
	==See Also==		==See Also==
	{{Drawing_functions}}		{{Drawing_functions}}

			[[hu:dxCreateRenderTarget]]

JeViCo at 16:35, 14 September 2018

2018-09-14T16:35:57Z

← Older revision		Revision as of 16:35, 14 September 2018
Line 16:		Line 16:
	*'''width :''' The width of the texture in pixels.		*'''width :''' The width of the texture in pixels.
	*'''height :''' The height of the texture in pixels.		*'''height :''' The height of the texture in pixels.
	*'''withAlpha:''' The render target will be created with an alpha channel.		*'''withAlpha:''' The render target will be created with an alpha channel. 'false' will turn images' alpha channels to black color

	===Returns===		===Returns===