SetVehicleDirtEnabled - Revision history

IManGaaX at 21:42, 3 January 2026

2026-01-03T21:42:31Z

← Older revision		Revision as of 21:42, 3 January 2026
Line 31:		Line 31:

	function isVehicleDirtEnabled(theVehicle)		function isVehicleDirtEnabled(theVehicle)
			assert(isElement(theVehicle) and getElementType(theVehicle) == "vehicle", "Bad argument @ 'isVehicleDirtEnabled' [Expected vehicle element at argument 1, got "..(isElement(theVehicle) and getElementType(theVehicle) or type(theVehicle)).."]")

	if isElement(enabledVehicles[theVehicle]) then		if isElement(enabledVehicles[theVehicle]) then
	return false		return false
	end		end

	return true		return true
	end		end

IManGaaX at 20:38, 1 January 2026

2026-01-01T20:38:58Z

← Older revision		Revision as of 20:38, 1 January 2026
Line 86:		Line 86:
	end		end
	end, 5000, 1)		end, 5000, 1)

			--// Also u can use 'isVehicleDirtEnabled' to check.
	</syntaxhighlight>		</syntaxhighlight>
	</section>		</section>

IManGaaX: add isVehicleDirtEnabled

2026-01-01T20:34:07Z

add isVehicleDirtEnabled

← Older revision		Revision as of 20:34, 1 January 2026
Line 29:		Line 29:
	}		}
	}]]		}]]

			function isVehicleDirtEnabled(theVehicle)
			if isElement(enabledVehicles[theVehicle]) then
			return false
			end
			return true
			end

	function setVehicleDirtEnabled(theVehicle, enabledState)		function setVehicleDirtEnabled(theVehicle, enabledState)

IManGaaX at 20:29, 1 January 2026

2026-01-01T20:29:31Z

← Older revision		Revision as of 20:29, 1 January 2026
Line 16:		Line 16:
	===Returns===		===Returns===
	* '''true''' if the operation was successful (shader applied or removed, or already in the requested state).		* '''true''' if the operation was successful (shader applied or removed, or already in the requested state).
	* '''false''' if the operation failed (~~e.g.~~ shader creation failure).		* '''false''' if the operation failed (shader creation failure).

	==Code==		==Code==
Line 43:		Line 43:
	end		end
	end		end
	~~return true~~
	else		else
	if isElement(enabledVehicles[theVehicle]) then		if isElement(enabledVehicles[theVehicle]) then
Line 50:		Line 49:
	enabledVehicles[theVehicle] = nil		enabledVehicles[theVehicle] = nil
	end		end
	~~return true~~
	end		end

			return true
	end		end

IManGaaX at 18:50, 1 January 2026

2026-01-01T18:50:29Z

← Older revision		Revision as of 18:50, 1 January 2026
Line 3:		Line 3:
	This function toggles a dirt removal [[shader]] effect on the specified [[vehicle]].		This function toggles a dirt removal [[shader]] effect on the specified [[vehicle]].

	[[Image:SetVehicleDirtEnabled-false.png\|thumb\|~~256px~~\|right\|[[Image:SetVehicleDirtEnabled-true.png\|~~256px~~\|right]]]]		[[Image:SetVehicleDirtEnabled-false.png\|thumb\|320px\|right\|[[Image:SetVehicleDirtEnabled-true.png\|320px\|right]]]]

	{{Note\|This function applies or removes a custom [[shader]] that removes dirt [[texture]] from the [[vehicle]]'s surface. It also handles [[shader]] cleanup automatically when the [[vehicle]] is destroyed.}}		{{Note\|This function applies or removes a custom [[shader]] that removes dirt [[texture]] from the [[vehicle]]'s surface. It also handles [[shader]] cleanup automatically when the [[vehicle]] is destroyed.}}

IManGaaX: add images

2026-01-01T18:47:48Z

add images

← Older revision		Revision as of 18:47, 1 January 2026
Line 2:		Line 2:
	<lowercasetitle>setVehicleDirtEnabled</lowercasetitle>		<lowercasetitle>setVehicleDirtEnabled</lowercasetitle>
	This function toggles a dirt removal [[shader]] effect on the specified [[vehicle]].		This function toggles a dirt removal [[shader]] effect on the specified [[vehicle]].

			[[Image:SetVehicleDirtEnabled-false.png\|thumb\|256px\|right\|[[Image:SetVehicleDirtEnabled-true.png\|256px\|right]]]]

	{{Note\|This function applies or removes a custom [[shader]] that removes dirt [[texture]] from the [[vehicle]]'s surface. It also handles [[shader]] cleanup automatically when the [[vehicle]] is destroyed.}}		{{Note\|This function applies or removes a custom [[shader]] that removes dirt [[texture]] from the [[vehicle]]'s surface. It also handles [[shader]] cleanup automatically when the [[vehicle]] is destroyed.}}

IManGaaX at 18:38, 1 January 2026

2026-01-01T18:38:29Z

← Older revision		Revision as of 18:38, 1 January 2026
Line 28:		Line 28:
	}]]		}]]

	function setVehicleDirtEnabled(theVehicle, ~~enabled~~)		function setVehicleDirtEnabled(theVehicle, enabledState)
	assert(isElement(theVehicle) and getElementType(theVehicle) == "vehicle", "Bad argument @ 'setVehicleDirtEnabled' [Expected vehicle element at argument 1, got "..(isElement(theVehicle) and getElementType(theVehicle) or type(theVehicle)).."]")		assert(isElement(theVehicle) and getElementType(theVehicle) == "vehicle", "Bad argument @ 'setVehicleDirtEnabled' [Expected vehicle element at argument 1, got "..(isElement(theVehicle) and getElementType(theVehicle) or type(theVehicle)).."]")
	assert(type(~~enabled~~) == "boolean", "Bad argument @ 'setVehicleDirtEnabled' [Expected boolean at argument 2, got "..(type(~~enabled~~)).."]")		assert(type(enabledState) == "boolean", "Bad argument @ 'setVehicleDirtEnabled' [Expected boolean at argument 2, got "..(type(enabledState)).."]")

	if not ~~enabled~~ then		if not enabledState then
	if not isElement(enabledVehicles[theVehicle]) then		if not isElement(enabledVehicles[theVehicle]) then
	enabledVehicles[theVehicle] = dxCreateShader(shaderCode, 0, 100, false, "vehicle")		enabledVehicles[theVehicle] = dxCreateShader(shaderCode, 0, 100, false, "vehicle")

IManGaaX at 18:37, 1 January 2026

2026-01-01T18:37:04Z

← Older revision		Revision as of 18:37, 1 January 2026
Line 10:		Line 10:
	===Required Arguments===		===Required Arguments===
	* '''theVehicle''': the vehicle element on which to toggle the dirt effect.		* '''theVehicle''': the vehicle element on which to toggle the dirt effect.
	* '''enabledState''': ~~boolean value;~~ set to false to remove dirt, true to show default dirt.		* '''enabledState''': set to false to remove dirt, true to show default dirt.

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

IManGaaX at 18:36, 1 January 2026

2026-01-01T18:36:23Z

← Older revision		Revision as of 18:36, 1 January 2026
Line 28:		Line 28:
	}]]		}]]

	function setVehicleDirtEnabled(~~vehicle~~, enabled)		function setVehicleDirtEnabled(theVehicle, enabled)
	assert(isElement(~~vehicle~~) and getElementType(~~vehicle~~) == "vehicle", "Bad argument @ 'setVehicleDirtEnabled' [Expected vehicle element at argument 1, got "..(isElement(~~vehicle~~) and getElementType(~~vehicle~~) or type(~~vehicle~~)).."]")		assert(isElement(theVehicle) and getElementType(theVehicle) == "vehicle", "Bad argument @ 'setVehicleDirtEnabled' [Expected vehicle element at argument 1, got "..(isElement(theVehicle) and getElementType(theVehicle) or type(theVehicle)).."]")
	assert(type(enabled) == "boolean", "Bad argument @ 'setVehicleDirtEnabled' [Expected boolean at argument 2, got "..(type(enabled)).."]")		assert(type(enabled) == "boolean", "Bad argument @ 'setVehicleDirtEnabled' [Expected boolean at argument 2, got "..(type(enabled)).."]")

	if not enabled then		if not enabled then
	if not isElement(enabledVehicles[~~vehicle~~]) then		if not isElement(enabledVehicles[theVehicle]) then
	enabledVehicles[~~vehicle~~] = dxCreateShader(shaderCode, 0, 100, false, "vehicle")		enabledVehicles[theVehicle] = dxCreateShader(shaderCode, 0, 100, false, "vehicle")
	if isElement(enabledVehicles[~~vehicle~~]) then		if isElement(enabledVehicles[theVehicle]) then
	engineApplyShaderToWorldTexture(enabledVehicles[~~vehicle~~], "vehiclegrunge256", ~~vehicle~~)		engineApplyShaderToWorldTexture(enabledVehicles[theVehicle], "vehiclegrunge256", theVehicle)
	else		else
	return false		return false
Line 43:		Line 43:
	return true		return true
	else		else
	if isElement(enabledVehicles[~~vehicle~~]) then		if isElement(enabledVehicles[theVehicle]) then
	engineRemoveShaderFromWorldTexture(enabledVehicles[~~vehicle~~], "vehiclegrunge256", ~~vehicle~~)		engineRemoveShaderFromWorldTexture(enabledVehicles[theVehicle], "vehiclegrunge256", theVehicle)
	destroyElement(enabledVehicles[~~vehicle~~])		destroyElement(enabledVehicles[theVehicle])
	enabledVehicles[~~vehicle~~] = nil		enabledVehicles[theVehicle] = nil
	end		end
	return true		return true

IManGaaX at 18:24, 1 January 2026

2026-01-01T18:24:26Z

← Older revision		Revision as of 18:24, 1 January 2026
Line 73:		Line 73:
	--// Show the dirt on a vehicle after 5 seconds		--// Show the dirt on a vehicle after 5 seconds
	setTimer(function()		setTimer(function()
	if ~~isElement(~~theVeh) then		if theVeh then
	setVehicleDirtEnabled(theVeh, true)		setVehicleDirtEnabled(theVeh, true)
	end		end