EngineLoadCOL: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
mNo edit summary
No edit summary
 
(20 intermediate revisions by 9 users not shown)
Line 1: Line 1:
{{Client function}}
{{Client function}}
__NOTOC__
__NOTOC__
This function loads a RenderWare Collision (COL 1/2/3) file into GTA. The collisions can then be used to provide collisions for in-game objects.
This function loads a RenderWare Collision (COL 1/2/3) file into GTA. The collisions can then be used to provide collisions for in-game objects.


Line 6: Line 7:


This is a client side function. Be sure to transfer your COL file by including it in the meta file.
This is a client side function. Be sure to transfer your COL file by including it in the meta file.
 
{{Note|
'''Note:''' collision libraries (.col files containing multiple collision models) are not supported. See [[COL]] for details.
* 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.
* Collision libraries (.col files containing multiple collision models) are not supported. See [[COL]] for details. Or you can try [[engineGetCOLsFromLibrary]], if you'd like.}}


==Syntax==  
==Syntax==  
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
col engineLoadCOL ( string col_file )  
col engineLoadCOL ( string col_file / string raw_data )  
</syntaxhighlight>  
</syntaxhighlight>  
 
{{OOP||[[COL|EngineCOL]]}}
===Required Arguments===  
===Required Arguments===  
*'''col_file:''' The [[path]] to the [[COL]] file you want to load
*'''col_file / raw_data:''' The [[filepath]] to the [[COL]] file you want to load or whole data buffer of the COL file.


===Returns===
===Returns===
Line 21: Line 23:


==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.
See [https://wiki.multitheftauto.com/wiki/EngineReplaceModel#Example unified example available in engineReplaceModel.]
<syntaxhighlight lang="lua">
outputChatBox ( "> replacing the euros vehicle" )


txd = engineLoadTXD ( "data/euros.txd" )
==Changelog==
engineImportTXD ( txd, 587 )
{{ChangelogHeader}}
dff = engineLoadDFF ( "data/euros.dff", 587 )
{{ChangelogItem|1.4.1-9.07088|Added option to use raw data instead of a file name}}
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">
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 )
</syntaxhighlight>


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

Latest revision as of 12:55, 12 December 2024


This function loads a RenderWare Collision (COL 1/2/3) file into GTA. The collisions can then be used to provide collisions for in-game objects.

For vehicles, please omit this function by embedding your COL file into your DFF file. This way, you can be sure that the COL file is correctly (and automatically) loaded when calling engineLoadDFF.

This is a client side function. Be sure to transfer your COL file by including it in the meta file.

[[{{{image}}}|link=|]] 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.
  • Collision libraries (.col files containing multiple collision models) are not supported. See COL for details. Or you can try engineGetCOLsFromLibrary, if you'd like.

Syntax

col engineLoadCOL ( string col_file / string raw_data )

OOP Syntax Help! I don't understand this!

Method: EngineCOL(...)


Required Arguments

  • col_file / raw_data: The filepath to the COL file you want to load or whole data buffer of the COL file.

Returns

Returns a COL if the file was loaded, false otherwise.

Example

See unified example available in engineReplaceModel.

Changelog

Version Description
1.4.1-9.07088 Added option to use raw data instead of a file name

See Also


Retrieved from "https://wiki.multitheftauto.com/wiki/EngineLoadCOL?oldid=81474"