EngineImportCOL: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
mNo edit summary
 
(4 intermediate revisions by 3 users not shown)
Line 1: Line 1:
__NOTOC__
{{Client function}}
{{Client function}}
__NOTOC__
{{Deprecated|engineReplaceCOL|}}
{{Deprecated}}
 
This function imports a RenderWare Collision into the model identified by the model id. This function does not replace the collisions of all models of this type in-game.
This function imports a RenderWare Collision into the model identified by the model id. This function does not replace the collisions of all models of this type in-game.


Line 8: Line 9:
==Syntax==  
==Syntax==  
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
bool engineImportCOL ( col, int model_id )  
bool engineImportCOL ( col theCol, int model_id )  
</syntaxhighlight>  
</syntaxhighlight>  


Line 19: Line 20:


==Example==  
==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.
This example loads a combination of custom DFF, TXD and COL files to replace an in-game model of a set of floors.
<syntaxhighlight lang="lua">
outputChatBox ( "> replacing the euros vehicle" )
 
txd = engineLoadTXD ( "data/euros.txd" )
engineImportTXD ( txd, 587 )
dff = engineLoadDFF ( "data/euros.dff", 587 )
engineReplaceModel ( dff, 587 )
</syntaxhighlight>
 
 
'''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.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
outputChatBox ( "> loading floor objects" )
outputChatBox ( "> loading floor objects" )
Line 36: Line 26:
engineImportTXD ( txd_floors, 3781 )
engineImportTXD ( txd_floors, 3781 )
col_floors = engineLoadCOL ( "models/office_floors.col" )
col_floors = engineLoadCOL ( "models/office_floors.col" )
dff_floors = engineLoadDFF ( "models/office_floors.dff", 0 )
dff_floors = engineLoadDFF ( "models/office_floors.dff" )
engineImportCOL ( col_floors, 3781 )
engineImportCOL ( col_floors, 3781 )
engineReplaceModel ( dff_floors, 3781 )
engineReplaceModel ( dff_floors, 3781 )

Latest revision as of 12:40, 5 August 2021

Emblem-important.png This function is deprecated. This means that its use is discouraged and that it might not exist in future versions.

Please use engineReplaceCOL instead.


This function imports a RenderWare Collision into the model identified by the model id. This function does not replace the collisions of all models of this type in-game.

To ensure proper replacement, please do not use this function for vehicles.

Syntax

bool engineImportCOL ( col theCol, int model_id ) 

Required Arguments

  • col: The COL that was loaded with engineLoadCOL
  • model_id: The model id to import the COL into

Returns

Returns true if the function executed succesfully, false otherwise.

Example

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" )
engineImportCOL ( col_floors, 3781 )
engineReplaceModel ( dff_floors, 3781 )

See Also