EngineImportTXD - Revision history

Fernando187 at 12:10, 19 February 2025

2025-02-19T12:10:12Z

← Older revision		Revision as of 12:10, 19 February 2025
Line 4:		Line 4:

	{{Note\|CJ clothing component textures can be replaced by using the IDs listed in the [[Clothing Component IDs]] article.}}		{{Note\|CJ clothing component textures can be replaced by using the IDs listed in the [[Clothing Component IDs]] article.}}

	{{Note\|Follow loading order ('''COL''' -> '''TXD''' -> '''DFF''') which is used in the example - as other orders can cause collisions, textures or the DFF not to load due to technical limitations.}}		{{Note\|Follow loading order ('''COL''' -> '''TXD''' -> '''DFF''') which is used in the example - as other orders can cause collisions, textures or the DFF not to load due to technical limitations.}}

	{{Tip\|Do your TXD files take megabytes of disk space? You can read some [[Optimize_Custom_TXD\|tips on reducing the size of TXD files]] to compress them without ruining texture quality.}}		{{Tip\|Do your TXD files take megabytes of disk space? You can read some [[Optimize_Custom_TXD\|tips on reducing the size of TXD files]] to compress them without ruining texture quality.}}

Fernando187: edit note about CJ clothing comps

2025-02-19T12:09:57Z

edit note about CJ clothing comps

← Older revision		Revision as of 12:09, 19 February 2025
Line 3:		Line 3:
	This function imports (adds) a loaded RenderWare Texture Dictionary into a specific model. This is necessary in order for the DFF loader to find any new textures. Please '''call this function before loading the DFF model file''', in order to allow the DFF loading process to find the new textures. This function can also replace default GTA textures, so that it becomes possible to e.g. put custom images on existing billboards. Ped and weapon textures are also supported.		This function imports (adds) a loaded RenderWare Texture Dictionary into a specific model. This is necessary in order for the DFF loader to find any new textures. Please '''call this function before loading the DFF model file''', in order to allow the DFF loading process to find the new textures. This function can also replace default GTA textures, so that it becomes possible to e.g. put custom images on existing billboards. Ped and weapon textures are also supported.

	CJ clothing component textures can be replaced by using the ~~ids~~ listed on [[Clothing Component IDs~~\|this page~~]].		{{Note\|CJ clothing component textures can be replaced by using the IDs listed in the [[Clothing Component IDs]] article.}}

	{{Note\|Follow loading order ('''COL''' -> '''TXD''' -> '''DFF''') which is used in the example - as other orders can cause collisions, textures or the DFF not to load due to technical limitations.}}		{{Note\|Follow loading order ('''COL''' -> '''TXD''' -> '''DFF''') which is used in the example - as other orders can cause collisions, textures or the DFF not to load due to technical limitations.}}

	{{Tip\|Do your TXD files take megabytes of disk space? You can read some [[Optimize_Custom_TXD\|tips on reducing the size of TXD files]] to compress them without ruining texture quality.}}		{{Tip\|Do your TXD files take megabytes of disk space? You can read some [[Optimize_Custom_TXD\|tips on reducing the size of TXD files]] to compress them without ruining texture quality.}}

Srslyyyy at 13:08, 12 December 2024

2024-12-12T13:08:32Z

← Older revision		Revision as of 13:08, 12 December 2024
Line 4:		Line 4:

	CJ clothing component textures can be replaced by using the ids listed on [[Clothing Component IDs\|this page]].		CJ clothing component textures can be replaced by using the ids listed on [[Clothing Component IDs\|this page]].

	~~See here for [[Optimize_Custom_TXD\|tips on reducing the size of TXD files]].~~
	{{Note\|Follow loading order ('''COL''' -> '''TXD''' -> '''DFF''') which is used in the example - as other orders can cause collisions, textures or the DFF not to load due to technical limitations.}}		{{Note\|Follow loading order ('''COL''' -> '''TXD''' -> '''DFF''') which is used in the example - as other orders can cause collisions, textures or the DFF not to load due to technical limitations.}}
			{{Tip\|Do your TXD files take megabytes of disk space? You can read some [[Optimize_Custom_TXD\|tips on reducing the size of TXD files]] to compress them without ruining texture quality.}}

	==Syntax==		==Syntax==

Srslyyyy: Update load order info

2024-12-12T13:06:41Z

Update load order info

← Older revision		Revision as of 13:06, 12 December 2024
Line 1:		Line 1:
	{{Client function}}		{{Client function}}
	__NOTOC__~~{{Note\|~~Please ~~note the~~ loading ~~order that is used in~~ the ~~examples as other orders can cause collisions~~, ~~textures or~~ the DFF ~~not~~ to ~~load due~~ to ~~technical limitations}}~~		__NOTOC__
			This function imports (adds) a loaded RenderWare Texture Dictionary into a specific model. This is necessary in order for the DFF loader to find any new textures. Please '''call this function before loading the DFF model file''', in order to allow the DFF loading process to find the new textures. This function can also replace default GTA textures, so that it becomes possible to e.g. put custom images on existing billboards. Ped and weapon textures are also supported.

	~~This function imports (adds) a loaded RenderWare Texture Dictionary into a specific model. This is necessary in order for the DFF loader to find any new~~ textures~~. Please '''call this function before loading the DFF model file''', in order to allow the DFF loading process to find~~ the ~~new textures. This function can also replace default GTA textures, so that it becomes possible to e.g. put custom images~~ on ~~existing billboards. Ped and weapon textures are also supported~~.		CJ clothing component textures can be replaced by using the ids listed on [[Clothing Component IDs\|this page]].

	See here for [[Optimize_Custom_TXD\|tips on reducing the size of TXD files]].		See here for [[Optimize_Custom_TXD\|tips on reducing the size of TXD files]].
	{{~~New feature/item~~\|~~3.0132\|1.3.1\|5254\|~~		{{Note\|Follow loading order ('''COL''' -> '''TXD''' -> '''DFF''') which is used in the example - as other orders can cause collisions, textures or the DFF not to load due to technical limitations.}}
	* CJ clothing component textures ~~can be replaced by using~~ the ~~ids listed on [[Clothing Component IDs\|this page]]~~
	}}

	==Syntax==		==Syntax==

Srslyyyy: /* Example */

2024-04-29T21:37:32Z

Example

@@ Line 22: / Line 22: @@
 ==Example==
-'''Example 1:''' This example loads a combination of a custom TXD and DFF file to replace the Euros vehicle in-game. The collisions are embedded inside the DFF file.
+See [https://wiki.multitheftauto.com/wiki/EngineReplaceModel#Example unified example available in engineReplaceModel.]
 ==See Also==
 {{Engine_functions}}

Srslyyyy: /* Example */

2024-04-29T21:04:10Z

Example

← Older revision		Revision as of 21:04, 29 April 2024
Line 79:		Line 79:
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	function replaceSkin()		function replaceSkin()
	local ~~txd~~ = engineLoadTXD("skinmodel.txd") -- change 'skinmodel' to your mod's file name		local skinTXD = engineLoadTXD("skinmodel.txd") -- change 'skinmodel' to your mod's file name

	engineImportTXD(~~txd~~, 190) -- change the ID 190 into the GTA skin ID you with to replace with mod		engineImportTXD(skinTXD, 190) -- change the ID 190 into the GTA skin ID you with to replace with mod

	local ~~dff~~ = engineLoadDFF("skinmodel.dff") -- change 'skinmodel' to your mod's file name		local skinDFF = engineLoadDFF("skinmodel.dff") -- change 'skinmodel' to your mod's file name

	engineReplaceModel(~~dff~~, 190) -- change the ID 190 into the GTA skin ID you with to replace with mod		engineReplaceModel(skinDFF, 190) -- change the ID 190 into the GTA skin ID you with to replace with mod
	end		end
	addEventHandler("onClientResourceStart", resourceRoot, replaceSkin)		addEventHandler("onClientResourceStart", resourceRoot, replaceSkin)
Line 93:		Line 93:
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	function replaceWeapon()		function replaceWeapon()
	local ~~txd~~ = engineLoadTXD("m4.txd")		local weaponTXD = engineLoadTXD("m4.txd")

	engineImportTXD(~~txd~~, 356)		engineImportTXD(weaponTXD, 356)

	local ~~dff~~ = engineLoadDFF("m4.dff") -- use weapon model ID, not GTA weapon ID (model ID from https://wiki.multitheftauto.com/wiki/Weapons)		local weaponDFF = engineLoadDFF("m4.dff") -- use weapon model ID, not GTA weapon ID (model ID from https://wiki.multitheftauto.com/wiki/Weapons)

	engineReplaceModel(~~dff~~, 356) -- Likewise, model ID, for M4 as example it's 356		engineReplaceModel(weaponDFF, 356) -- Likewise, model ID, for M4 as example it's 356
	end		end
	addEventHandler("onClientResourceStart", resourceRoot, replaceWeapon)		addEventHandler("onClientResourceStart", resourceRoot, replaceWeapon)

Srslyyyy: /* Example */

2024-04-29T21:02:44Z

Example

← Older revision		Revision as of 21:02, 29 April 2024
Line 100:		Line 100:

	engineReplaceModel(dff, 356) -- Likewise, model ID, for M4 as example it's 356		engineReplaceModel(dff, 356) -- Likewise, model ID, for M4 as example it's 356

	end		end
	addEventHandler("onClientResourceStart", resourceRoot, replaceWeapon)		addEventHandler("onClientResourceStart", resourceRoot, replaceWeapon)

Srslyyyy: /* Example */

2024-04-29T21:02:12Z

Example

← Older revision		Revision as of 21:02, 29 April 2024
Line 67:		Line 67:
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	outputChatBox("> replacing billboards")		outputChatBox("> replacing billboards")

	local billboardTXD = engineLoadTXD("models/vgsn_billboard.txd")		local billboardTXD = engineLoadTXD("models/vgsn_billboard.txd")

Srslyyyy: /* Example */

2024-04-29T21:00:24Z

Example

← Older revision		Revision as of 21:00, 29 April 2024
Line 26:		Line 26:
	outputChatBox("> replacing the euros vehicle")		outputChatBox("> replacing the euros vehicle")

	local ~~txd~~ = engineLoadTXD("data/euros.txd")		local eurosTXD = engineLoadTXD("data/euros.txd")
	engineImportTXD(~~txd~~, 587)
	local ~~dff~~ = engineLoadDFF("data/euros.dff")		engineImportTXD(eurosTXD, 587)
	engineReplaceModel(~~dff~~, 587)
			local eurosDFF = engineLoadDFF("data/euros.dff")

			engineReplaceModel(eurosDFF, 587)
	</syntaxhighlight>		</syntaxhighlight>

Line 36:		Line 39:
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	outputChatBox("> loading floor objects")		outputChatBox("> loading floor objects")
	local ~~col_floors~~ = engineLoadCOL("models/office_floors.col")
	engineReplaceCOL(~~col_floors~~, 3781)		local floorsCOL = engineLoadCOL("models/office_floors.col")
	local ~~txd_floors~~ = engineLoadTXD("models/office_floors.txd")
	engineImportTXD(~~txd_floors~~, 3781)		engineReplaceCOL(floorsCOL, 3781)
	local ~~dff_floors~~ = engineLoadDFF("models/office_floors.dff")
	engineReplaceModel(~~dff_floors~~, 3781)		local floorsTXD = engineLoadTXD("models/office_floors.txd")

			engineImportTXD(floorsTXD, 3781)

			local floorsDFF = engineLoadDFF("models/office_floors.dff")

			engineReplaceModel(floorsDFF, 3781)
	</syntaxhighlight>		</syntaxhighlight>

Line 48:		Line 57:
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	outputChatBox("> replacing billboards")		outputChatBox("> replacing billboards")
	local ~~txd_billboards~~ = engineLoadTXD("models/vgsn_billboard.txd")
	engineImportTXD(~~txd_billboards~~, 7300)		local billboardTXD = engineLoadTXD("models/vgsn_billboard.txd")

			engineImportTXD(billboardTXD, 7300)
	</syntaxhighlight>		</syntaxhighlight>

Line 56:		Line 67:
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	outputChatBox("> replacing billboards")		outputChatBox("> replacing billboards")
	local ~~txd_billboards~~ = engineLoadTXD("models/vgsn_billboard.txd")		local billboardTXD = engineLoadTXD("models/vgsn_billboard.txd")
	engineImportTXD(~~txd_billboards~~, 7300)
	engineImportTXD(~~txd_billboards~~, 7301)		engineImportTXD(billboardTXD, 7300)
	engineImportTXD(~~txd_billboards~~, 7302)		engineImportTXD(billboardTXD, 7301)
	engineImportTXD(~~txd_billboards~~, 7303)		engineImportTXD(billboardTXD, 7302)
			engineImportTXD(billboardTXD, 7303)
	</syntaxhighlight>		</syntaxhighlight>

Line 81:		Line 93:
	function replaceWeapon()		function replaceWeapon()
	local txd = engineLoadTXD("m4.txd")		local txd = engineLoadTXD("m4.txd")

	engineImportTXD(txd, 356)		engineImportTXD(txd, 356)
	local dff = engineLoadDFF("m4.dff"~~, 356~~) -- use weapon model ID, not GTA weapon ID (model ID from https://wiki.multitheftauto.com/wiki/Weapons)
			local dff = engineLoadDFF("m4.dff") -- use weapon model ID, not GTA weapon ID (model ID from https://wiki.multitheftauto.com/wiki/Weapons)

	engineReplaceModel(dff, 356) -- Likewise, model ID, for M4 as example it's 356		engineReplaceModel(dff, 356) -- Likewise, model ID, for M4 as example it's 356

Srslyyyy: /* Example */

2024-04-29T20:56:11Z

Example

← Older revision		Revision as of 20:56, 29 April 2024
Line 65:		Line 65:
	'''Example 5:''' This example loads a custom skin mod and replaces SA skin of the defined ID (in this example being '190')		'''Example 5:''' This example loads a custom skin mod and replaces SA skin of the defined ID (in this example being '190')
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	~~addEventHandler ( "onClientResourceStart", resourceRoot,~~		function replaceSkin()
	function ()		local txd = engineLoadTXD("skinmodel.txd") -- change 'skinmodel' to your mod's file name
	local txd = engineLoadTXD("skinmodel.txd") -- change 'skinmodel' to your mod's file name
	engineImportTXD(txd, 190) -- change the ID 190 into the GTA skin ID you with to replace with mod		engineImportTXD(txd, 190) -- change the ID 190 into the GTA skin ID you with to replace with mod
	local dff = engineLoadDFF("skinmodel.dff"~~, 190~~) -- change 'skinmodel' to your mod's file name
	engineReplaceModel(dff, 190) -- change the ID 190 into the GTA skin ID you with to replace with mod		local dff = engineLoadDFF("skinmodel.dff") -- change 'skinmodel' to your mod's file name
	end
	)		engineReplaceModel(dff, 190) -- change the ID 190 into the GTA skin ID you with to replace with mod
			end
			addEventHandler("onClientResourceStart", resourceRoot, replaceSkin)
	</syntaxhighlight>		</syntaxhighlight>

Line 84:		Line 86:

	end		end
	addEventHandler ( "onClientResourceStart", resourceRoot, replaceWeapon)		addEventHandler("onClientResourceStart", resourceRoot, replaceWeapon)
	~~</syntaxhighlight>~~

	~~'''Example 7:''' This example replaces multiple models at the same time using this function just once. (in this example the Grove street)~~
	~~<syntaxhighlight lang="lua">~~
	~~local txd = engineLoadTXD("Los Santos/lae2roadshub.txd")~~
	~~engineImportTXD (txd, 17595, 17597, 17610, 17611, 17612, 17613~~)
	</syntaxhighlight>		</syntaxhighlight>

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

← Older revision		Revision as of 12:10, 19 February 2025
Line 4:		Line 4:

	{{Note\|CJ clothing component textures can be replaced by using the IDs listed in the [[Clothing Component IDs]] article.}}		{{Note\|CJ clothing component textures can be replaced by using the IDs listed in the [[Clothing Component IDs]] article.}}

	{{Note\|Follow loading order ('''COL''' -> '''TXD''' -> '''DFF''') which is used in the example - as other orders can cause collisions, textures or the DFF not to load due to technical limitations.}}		{{Note\|Follow loading order ('''COL''' -> '''TXD''' -> '''DFF''') which is used in the example - as other orders can cause collisions, textures or the DFF not to load due to technical limitations.}}

	{{Tip\|Do your TXD files take megabytes of disk space? You can read some [[Optimize_Custom_TXD\|tips on reducing the size of TXD files]] to compress them without ruining texture quality.}}		{{Tip\|Do your TXD files take megabytes of disk space? You can read some [[Optimize_Custom_TXD\|tips on reducing the size of TXD files]] to compress them without ruining texture quality.}}