EngineImageLinkTXD: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
 
(2 intermediate revisions by the same user not shown)
Line 2: Line 2:
{{Client function}}
{{Client function}}


{{New feature/item|4|1.6.0|21695|This function links TXD file with an IMG container.}}
{{New feature/item|4|1.6.0|21695|This function links TXD file with an IMG container. This function does not change a model immediately. You should use [[engineRestreamWorld]] to reload models.}}


==Syntax==
==Syntax==
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
boolean engineImageLinkTXD ( img img_file, string file_path, int modelID )
boolean engineImageLinkTXD ( img img_file, string file_path, int txdID )
</syntaxhighlight>
</syntaxhighlight>


Line 13: Line 13:
* '''img_file''': The [[IMG]] file you want to link.
* '''img_file''': The [[IMG]] file you want to link.
* '''file_path''': Path to the [[TXD]] file you want to link.
* '''file_path''': Path to the [[TXD]] file you want to link.
* '''modelID''': ID of the model you want to link to.
* '''txdID''': ID of the texture dictionary you want to link to. Use [[engineGetModelTXDID]] or [[engineRequestTXD]] to get this value.


===Returns===
===Returns===
Line 35: Line 35:
engineImageLinkDFF( img, "infernus.dff", infernusModelID )
engineImageLinkDFF( img, "infernus.dff", infernusModelID )
engineImageLinkTXD( img, "infernus.txd", infernusModelTxdID )
engineImageLinkTXD( img, "infernus.txd", infernusModelTxdID )
-- Reload game models
engineRestreamWorld()
</syntaxhighlight>
</syntaxhighlight>


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

Latest revision as of 20:32, 21 July 2024

ADDED/UPDATED IN VERSION 1.6.0 r21695:
This function links TXD file with an IMG container. This function does not change a model immediately. You should use engineRestreamWorld to reload models.

Syntax

boolean engineImageLinkTXD ( img img_file, string file_path, int txdID )


OOP Syntax Help! I don't understand this!

Method: img:linkTXD(...)


Required Arguments

  • img_file: The IMG file you want to link.
  • file_path: Path to the TXD file you want to link.
  • txdID: ID of the texture dictionary you want to link to. Use engineGetModelTXDID or engineRequestTXD to get this value.

Returns

Returns true if IMG file was successfully linked, false otherwise.

Example

You could use the following code: 

-- Load IMG
local img = engineLoadIMG( "file.img" )

-- Enable streaming from this IMG
engineAddImage( img )

-- Get model TXD id
local infernusModelID = 411
local infernusModelTxdID = engineGetModelTXDID( infernusModelID )

-- Link DFF and TXD to IMG files
engineImageLinkDFF( img, "infernus.dff", infernusModelID )
engineImageLinkTXD( img, "infernus.txd", infernusModelTxdID )

-- Reload game models
engineRestreamWorld()

See Also


Retrieved from "https://wiki.multitheftauto.com/wiki/EngineImageLinkTXD?oldid=79938"