DxSetBlendMode - Revision history

Fernando187: Remove obsolete Requirements section

2024-11-07T17:00:51Z

Remove obsolete Requirements section

← Older revision		Revision as of 17:00, 7 November 2024
Line 50:		Line 50:
	</syntaxhighlight>		</syntaxhighlight>
	</section>		</section>

	~~==Requirements==~~
	~~{{Requirements\|n/a\|1.3.0-9.03782\|}}~~

	==Changelog==		==Changelog==

Andres28: /* Example */

2022-09-30T22:19:12Z

Example

← Older revision		Revision as of 22:19, 30 September 2022
Line 19:		Line 19:

	==Example==		==Example==
			<section name="Client" class="client" show="true">
	This example shows how to use '''modulate_add''' and '''add''' to avoid quality problems when using a render target:		This example shows how to use '''modulate_add''' and '''add''' to avoid quality problems when using a render target:
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
Line 48:		Line 49:
	)		)
	</syntaxhighlight>		</syntaxhighlight>
			</section>

	==Requirements==		==Requirements==

Surge at 17:30, 1 December 2018

2018-12-01T17:30:20Z

← Older revision		Revision as of 17:30, 1 December 2018
Line 58:		Line 58:
	==See Also==		==See Also==
	{{Drawing_functions}}		{{Drawing_functions}}

			[[hu:dxSetBlendMode]]

Et-win: Typos @ blendMode @ blend ("The is the" to "This is the")

2014-07-16T15:31:58Z

Typos @ blendMode @ blend ("The is the" to "This is the")

← Older revision		Revision as of 15:31, 16 July 2014
Line 10:		Line 10:
	===Required Arguments===		===Required Arguments===
	*'''blendMode :''' The blend mode to use which can be one of:		*'''blendMode :''' The blend mode to use which can be one of:
	**'''blend:''' The source textures are alpha blended to the screen/render target. ~~The~~ is the default mode for drawing and gives the results we all know and love.		**'''blend:''' The source textures are alpha blended to the screen/render target. This is the default mode for drawing and gives the results we all know and love.
	**'''add:''' The source textures are added to the screen/render target.		**'''add:''' The source textures are added to the screen/render target.
	**'''modulate_add:''' The source textures are multiplied by the alpha and then added to the screen/render target.		**'''modulate_add:''' The source textures are multiplied by the alpha and then added to the screen/render target.

Ixjf: Fixed wrong font name being passed to dxDrawText in the example

2014-05-10T11:10:21Z

Fixed wrong font name being passed to dxDrawText in the example

← Older revision		Revision as of 11:10, 10 May 2014
Line 30:		Line 30:
	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, "~~Verdana~~")		dxDrawText("Testing "..getTickCount(), 0, 0, 0, 0, tocolor(255, 255, 255, 255), 2, "clear")

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

Myonlake at 12:32, 2 January 2014

2014-01-02T12:32:00Z

← Older revision		Revision as of 12:32, 2 January 2014
Line 58:		Line 58:
	==See Also==		==See Also==
	{{Drawing_functions}}		{{Drawing_functions}}

	~~[[Category:Needs Example]]~~

X86dev at 10:54, 28 June 2013

2013-06-28T10:54:48Z

← Older revision		Revision as of 10:54, 28 June 2013
Line 13:		Line 13:
	**'''add:''' The source textures are added to the screen/render target.		**'''add:''' The source textures are added to the screen/render target.
	**'''modulate_add:''' The source textures are multiplied by the alpha and then added to the screen/render target.		**'''modulate_add:''' The source textures are multiplied by the alpha and then added to the screen/render target.
	~~<div style="padding-left:19px;">~~		**'''overwrite :''' The source textures are overwritten. This can be useful for clearing render targets.
	~~{{New feature/item\|4.0133\|1.3.0\|4425\|~~
	*'''overwrite :''' The source textures are overwritten. This can be useful for clearing render targets.
	}}
	~~</div>~~

	==Returns==		==Returns==

Ccw at 00:07, 7 May 2013

2013-05-07T00:07:43Z

Ccw at 00:03, 7 May 2013

2013-05-07T00:03:44Z

← Older revision		Revision as of 00:03, 7 May 2013
Line 1:		Line 1:
	{{Client function}}		{{Client function}}
	__NOTOC__		__NOTOC__
	This function sets the current blend mode for the dxDraw functions. Changing the blend mode can increase the quality when drawing text or certain other images to a render target. As a general guide use '''modulate_add''' when drawing text to a render target, and '''add''' when drawing the render target to the screen. Don't forget to restore the default '''blend''' at the end.		This function sets the current blend mode for the dxDraw functions. Changing the blend mode can increase the quality when drawing text or certain other images to a render target. As a general guide use '''modulate_add''' when drawing text to a render target, and '''add''' when drawing the render target to the screen. Don't forget to restore the default '''blend''' at the end - See the example below.

	==Syntax==		==Syntax==
Line 13:		Line 13:
	**'''add:''' The source textures are added to the screen/render target.		**'''add:''' The source textures are added to the screen/render target.
	**'''modulate_add:''' The source textures are multiplied by the alpha and then added to the screen/render target.		**'''modulate_add:''' The source textures are multiplied by the alpha and then added to the screen/render target.
	{{New feature/item\|4.~~0140~~\|1.3.0\|4425\|		{{New feature/item\|4.0133\|1.3.0\|4425\|
	**'''overwrite :''' The source textures are overwritten. This can be useful for clearing render targets.		**'''overwrite :''' The source textures are overwritten. This can be useful for clearing render targets.
	}}		}}
Line 20:		Line 20:
	Returns true if successful, or ''false'' if invalid arguments were passed to the function.		Returns true if successful, or ''false'' if invalid arguments were passed to the function.

	==Example==		==Example==
			This example shows how to use '''modulate_add''' and '''add''' to avoid quality problems when using a render target:
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	--~~TODO~~		local myRenderTarget = dxCreateRenderTarget(500, 500, true)

			-- Function to draw text to our render target texture when the 'r' key is pressed
			function updateRenderTarget()
			dxSetRenderTarget(myRenderTarget, true)
			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, "Verdana")

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

			-- Display render target contents
			addEventHandler("onClientRender", root,
			function()
			dxSetBlendMode("add") -- Set 'add' when drawing the render target on the screen
			dxDrawImage(100, 200, 500, 500, myRenderTarget, -10)
			dxSetBlendMode("blend") -- Restore default blending
			end
			)
	</syntaxhighlight>		</syntaxhighlight>

X86dev at 19:23, 20 September 2012

2012-09-20T19:23:25Z

← Older revision		Revision as of 19:23, 20 September 2012
Line 5:		Line 5:
	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	bool dxSetBlendMode( string blendMode )		bool dxSetBlendMode ( string blendMode )
	</syntaxhighlight>		</syntaxhighlight>

← Older revision		Revision as of 00:07, 7 May 2013
Line 13:		Line 13:
	**'''add:''' The source textures are added to the screen/render target.		**'''add:''' The source textures are added to the screen/render target.
	**'''modulate_add:''' The source textures are multiplied by the alpha and then added to the screen/render target.		**'''modulate_add:''' The source textures are multiplied by the alpha and then added to the screen/render target.
			<div style="padding-left:19px;">
	{{New feature/item\|4.0133\|1.3.0\|4425\|		{{New feature/item\|4.0133\|1.3.0\|4425\|
	**'''overwrite :''' The source textures are overwritten. This can be useful for clearing render targets.		*'''overwrite :''' The source textures are overwritten. This can be useful for clearing render targets.
	}}		}}
			</div>

	==Returns==		==Returns==
Line 25:		Line 27:
	local myRenderTarget = dxCreateRenderTarget(500, 500, true)		local myRenderTarget = dxCreateRenderTarget(500, 500, true)

			--
	-- Function to draw text to our render target texture when the 'r' key is pressed		-- Function to draw text to our render target texture when the 'r' key is pressed
			--
	function updateRenderTarget()		function updateRenderTarget()
	dxSetRenderTarget(myRenderTarget, true)		dxSetRenderTarget(myRenderTarget, true)
Line 32:		Line 36:
	dxDrawText("Testing "..getTickCount(), 0, 0, 0, 0, tocolor(255, 255, 255, 255), 2, "Verdana")		dxDrawText("Testing "..getTickCount(), 0, 0, 0, 0, tocolor(255, 255, 255, 255), 2, "Verdana")

	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 )

			--
	-- Display render target contents		-- Display render target contents
			--
	addEventHandler("onClientRender", root,		addEventHandler("onClientRender", root,
	function()		function()
	dxSetBlendMode("add") -- Set 'add' when drawing the render target on the screen		dxSetBlendMode("add") -- Set 'add' when drawing the render target on the screen
	dxDrawImage(100, 200, 500, 500, myRenderTarget, -10)		dxDrawImage(100, 200, 500, 500, myRenderTarget, -10)
	dxSetBlendMode("blend") -- Restore default blending		dxSetBlendMode("blend") -- Restore default blending
	end		end
	)		)