EngineApplyShaderToWorldTexture - Revision history

XNikoXD: Buildings are not supported

2025-09-12T10:02:42Z

Buildings are not supported

← Older revision		Revision as of 10:02, 12 September 2025
Line 21:		Line 21:
	===Optional Arguments===		===Optional Arguments===
	{{New feature/item\|3.0130\|1.3.0\|4140\|		{{New feature/item\|3.0130\|1.3.0\|4140\|
	*'''targetElement:''' The element to restrict applying the shader to. If this is not set the shader will be applied to everything using the texture name. Valid element types for targetElement are [[vehicle\|vehicles]], [[Object\|objects]], [[Ped\|peds~~]] and [[Building\|buildings~~]].		*'''targetElement:''' The element to restrict applying the shader to. If this is not set the shader will be applied to everything using the texture name. Valid element types for targetElement are [[vehicle\|vehicles]], [[Object\|objects]] and [[Ped\|peds]].
	}}		}}
	*'''appendLayers:''' allows two or more layered shaders to be applied in the same texture. You may want to modify the ''DepthBias'' in the technique pass to avoid Z-fighting artifacts when using this.		*'''appendLayers:''' allows two or more layered shaders to be applied in the same texture. You may want to modify the ''DepthBias'' in the technique pass to avoid Z-fighting artifacts when using this.

Prox: /* Optional Arguments */ add Building as for latest update

2025-02-21T07:49:45Z

Optional Arguments: add Building as for latest update

← Older revision		Revision as of 07:49, 21 February 2025
Line 21:		Line 21:
	===Optional Arguments===		===Optional Arguments===
	{{New feature/item\|3.0130\|1.3.0\|4140\|		{{New feature/item\|3.0130\|1.3.0\|4140\|
	*'''targetElement:''' The element to restrict applying the shader to. If this is not set the shader will be applied to everything using the texture name. Valid element types for targetElement are [[vehicle\|vehicles]], [[Object\|objects]] ~~and~~ [[Ped\|peds]].		*'''targetElement:''' The element to restrict applying the shader to. If this is not set the shader will be applied to everything using the texture name. Valid element types for targetElement are [[vehicle\|vehicles]], [[Object\|objects]], [[Ped\|peds]] and [[Building\|buildings]].
	}}		}}
	*'''appendLayers:''' allows two or more layered shaders to be applied in the same texture. You may want to modify the ''DepthBias'' in the technique pass to avoid Z-fighting artifacts when using this.		*'''appendLayers:''' allows two or more layered shaders to be applied in the same texture. You may want to modify the ''DepthBias'' in the technique pass to avoid Z-fighting artifacts when using this.

Srslyyyy: Replace to root.

2022-11-01T23:50:01Z

Replace to root.

← Older revision		Revision as of 23:50, 1 November 2022
Line 38:		Line 38:
	dxSetShaderValue (theTechnique, "gTexture", explosionTexture)		dxSetShaderValue (theTechnique, "gTexture", explosionTexture)
	end		end
	addEventHandler("onClientResourceStart",resourceRoot,replaceEffect)		addEventHandler("onClientResourceStart", resourceRoot, replaceEffect)
	</syntaxhighlight>		</syntaxhighlight>

Line 59:		Line 59:
	end		end
	end		end
	addEventHandler("onClientVehicleEnter", ~~getRootElement()~~, applyShader)		addEventHandler("onClientVehicleEnter", root, applyShader)

	function removeShader(thePlayer, seat)		function removeShader(thePlayer, seat)

Srslyyyy: Replace to root.

2022-11-01T23:49:19Z

Replace to root.

← Older revision		Revision as of 23:49, 1 November 2022
Line 69:		Line 69:
	end		end
	end		end
	addEventHandler("onClientVehicleExit", ~~getRootElement()~~, removeShader)		addEventHandler("onClientVehicleExit", root, removeShader)
	</syntaxhighlight>		</syntaxhighlight>

Dutchman101: outdated & unusual section

2018-10-23T21:41:43Z

outdated & unusual section

← Older revision		Revision as of 21:41, 23 October 2018
Line 86:		Line 86:
	</syntaxhighlight>		</syntaxhighlight>
	* Save the above code as [shadername]'''.fx'''		* Save the above code as [shadername]'''.fx'''

	~~==Changelog==~~
	~~{{ChangelogHeader}}~~
	~~{{ChangelogItem\|1.3.0-9.04140\|Added targetElement argument}}~~
	~~{{ChangelogItem\|1.3.0-9.04418\|Added peds to allowed element types (for pixel shaders only)}}~~
	~~{{ChangelogItem\|1.3.1-9.04939\|Added peds to allowed element types (full support)}}~~

	==See Also==		==See Also==
	{{Engine_functions}}		{{Engine_functions}}
	{{Drawing_functions}}		{{Drawing_functions}}

Dutchman101: mediawiki likes messing with formatting

2018-10-23T21:40:56Z

mediawiki likes messing with formatting

← Older revision		Revision as of 21:40, 23 October 2018
Line 47:		Line 47:
	</syntaxhighlight>		</syntaxhighlight>

	This ~~untested~~ example will apply a shader to the current vehicle of the local player		This example will apply a shader to the current vehicle of the local player
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	theTechnique = dxCreateShader( "shader.fx" )		theTechnique = dxCreateShader( "shader.fx" )
Line 64:		Line 64:
	local theVehicle = source		local theVehicle = source

	if seat == 0 and thePlayer == localPlayer then		if seat == 0 and thePlayer == localPlayer then
	engineRemoveShaderFromWorldTexture(theTechnique, "vehiclegrunge256", theVehicle)		engineRemoveShaderFromWorldTexture(theTechnique, "vehiclegrunge256", theVehicle)
	engineRemoveShaderFromWorldTexture(theTechnique, "?emap*", theVehicle)		engineRemoveShaderFromWorldTexture(theTechnique, "?emap*", theVehicle)
	end		end
	end		end

Dutchman101: uniform style

2018-10-23T21:37:41Z

uniform style

← Older revision		Revision as of 21:37, 23 October 2018
Line 43:		Line 43:
	This example will apply a shader to the "des_logwall" world texture (which is used by the house near the 'play' gamemode spawn point)		This example will apply a shader to the "des_logwall" world texture (which is used by the house near the 'play' gamemode spawn point)
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	~~myShader~~ = dxCreateShader( "~~hello~~.fx" )		theTechnique = dxCreateShader("shader.fx")
	engineApplyShaderToWorldTexture( ~~myShader~~, "des_logwall" )		engineApplyShaderToWorldTexture(theTechnique, "des_logwall")
	</syntaxhighlight>		</syntaxhighlight>

	This untested example will apply a shader to the current vehicle of the local player		This untested example will apply a shader to the current vehicle of the local player
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	~~myShader~~ = dxCreateShader( "~~hello~~.fx" )		theTechnique = dxCreateShader( "shader.fx" )

	~~addEventHandler("onClientVehicleEnter", root,~~		function applyShader(thePlayer, seat)
	function(thePlayer, seat)		local theVehicle = source
	local theVehicle = source
	~~if seat == 0 and thePlayer == localPlayer then~~
	~~engineApplyShaderToWorldTexture( myShader, "vehiclegrunge256", theVehicle )~~
	~~engineApplyShaderToWorldTexture( myShader, "?emap*", theVehicle )~~
	~~end~~
	~~end~~
	)

	addEventHandler("~~onClientVehicleExit~~", ~~root~~,		if seat == 0 and thePlayer == localPlayer then
	function(thePlayer, seat)		engineApplyShaderToWorldTexture(theTechnique, "vehiclegrunge256", theVehicle)
	local theVehicle = source		engineApplyShaderToWorldTexture(theTechnique, "?emap*", theVehicle)
	if seat == 0 and thePlayer == localPlayer then		end
	engineRemoveShaderFromWorldTexture( ~~myShader~~, "vehiclegrunge256", theVehicle )		end
	engineRemoveShaderFromWorldTexture( ~~myShader~~, "?emap*", theVehicle )		addEventHandler("onClientVehicleEnter", getRootElement(), applyShader)
	end
	end		function removeShader(thePlayer, seat)
	)		local theVehicle = source

			if seat == 0 and thePlayer == localPlayer then
			engineRemoveShaderFromWorldTexture(theTechnique, "vehiclegrunge256", theVehicle)
			engineRemoveShaderFromWorldTexture(theTechnique, "?emap*", theVehicle)
			end
			end
			addEventHandler("onClientVehicleExit", getRootElement(), removeShader)
	</syntaxhighlight>		</syntaxhighlight>

Dutchman101 at 21:16, 23 October 2018

2018-10-23T21:16:49Z

← Older revision		Revision as of 21:16, 23 October 2018
Line 71:		Line 71:
	)		)
	</syntaxhighlight>		</syntaxhighlight>


	Basic texture replacement shader example (compatible with all script examples on this page):		Basic texture replacement shader example (compatible with all script examples on this page):
Line 84:		Line 85:
	}		}
	</syntaxhighlight>		</syntaxhighlight>
			* Save the above code as [shadername]'''.fx'''

	==Changelog==		==Changelog==

Dutchman101: typo

2018-10-23T21:05:49Z

typo

← Older revision		Revision as of 21:05, 23 October 2018
Line 72:		Line 72:
	</syntaxhighlight>		</syntaxhighlight>

	Basic texture replacement shader example (compatible with all examples on this page):		Basic texture replacement shader example (compatible with all script examples on this page):
	<syntaxhighlight lang="fx">		<syntaxhighlight lang="fx">
	texture gTexture;		texture gTexture;

Dutchman101: added examples

2018-10-23T21:05:22Z

added examples

@@ Line 29: / Line 29: @@
 ==Example==
 This example will apply a shader to the "des_logwall" world texture (which is used by the house near the 'play' gamemode spawn point)
 <syntaxhighlight lang="lua">
@@ Line 58: / Line 70: @@
      end
+)
 </syntaxhighlight>