EngineImportTXD: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 1: Line 1:
{{Client function}}
{{Client function}}
__NOTOC__
__NOTOC__
This function imports a RenderWare Texture Dictionary into the model identified by the model id. This is necessary in order for the DFF loader to find any new textures. This does however not replace the original textures of the model.
This function imports a RenderWare Texture Dictionary into the model identified by the model id. This is necessary in order for the DFF loader to find any new textures.  
 
{{New feature|3|1.0|
* As of revision 673 of 1.0 this combined with engineLoadTXD can replace default GTA objects for example billboards (Note: you do not need to replace a DFF or col if you are replacing a default GTA object)
}}
* To prevent issues with textures (object models) please call this function before loading the DFF model file, in order to allow the DFF loading process to find the new textures.
* To prevent issues with textures (object models) please call this function before loading the DFF model file, in order to allow the DFF loading process to find the new textures.


Line 41: Line 43:




{{New feature|3|1.0|
'''Example 3:''' This example replaces the victim billboards in last venturas (when replacing default models you do not need to replace a dff or col)
<syntaxhighlight lang="lua">
outputChatBox ( "> replacing billboards" )
txd_floors = engineLoadTXD ( "models/vgsn_billboard.txd" )
engineImportTXD ( txd_floors, 7300 )
</syntaxhighlight>
}}
==See Also==
==See Also==
{{Engine_functions}}
{{Engine_functions}}

Revision as of 22:45, 19 April 2009

This function imports a RenderWare Texture Dictionary into the model identified by the model id. This is necessary in order for the DFF loader to find any new textures.

  • As of revision 673 of 1.0 this combined with engineLoadTXD can replace default GTA objects for example billboards (Note: you do not need to replace a DFF or col if you are replacing a default GTA object)
  • To prevent issues with textures (object models) please call this function before loading the DFF model file, in order to allow the DFF loading process to find the new textures.

Syntax

bool engineImportTXD ( txd texture, int model_id )

Required Arguments

  • texture: The TXD that was loaded with engineLoadTXD
  • model_id: The model id to import the TXD into

Returns

Returns true if the function executed succesfully, false otherwise.

Example

Example 1: This example loads a combination of a custom DFF and TXD file to replace the Euros vehicle in-game. The collisions are embedded inside the DFF file. 

outputChatBox ( "> replacing the euros vehicle" )

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


Example 2: This example loads a combination of custom DFF, TXD and COL files to replace an in-game model of a set of floors. 

outputChatBox ( "> loading floor objects" )
txd_floors = engineLoadTXD ( "models/office_floors.txd" )
engineImportTXD ( txd_floors, 3781 )
col_floors = engineLoadCOL ( "models/office_floors.col" )
dff_floors = engineLoadDFF ( "models/office_floors.dff", 0 )
engineReplaceCOL ( col_floors, 3781 )
engineReplaceModel ( dff_floors, 3781 )


Example 3: This example replaces the victim billboards in last venturas (when replacing default models you do not need to replace a dff or col) 

outputChatBox ( "> replacing billboards" )
txd_floors = engineLoadTXD ( "models/vgsn_billboard.txd" )
engineImportTXD ( txd_floors, 7300 )

See Also


Retrieved from "https://wiki.multitheftauto.com/wiki/EngineImportTXD?oldid=19195"