engineRequestTXD | Multi Theft Auto: Wiki Skip to content
Multi Theft Auto: Wiki

engineRequestTXD

Client-side
Server-side
Shared

Pair: engineFreeTXD

Added in 1.6.0 r22190

This function is used to register the next available TXD ID.

Note

Do not rely on the id numbers returned being consistent across multiple clients or multiple runs of resources. There is no guarantee for the order of the numbers.

Syntax 

​int|false engineRequestTXD ( ​string name )
Required Arguments
  • name: TXD name string up to 24 characters.

Returns

  • int|false: txd id

Returns an integer of the TXD ID that was available to be assigned to game models, false if no free TXD ID available.

Code Examples

client

This example replaces textures for some Grove Street buildings.

-- Load IMG archive
local img = engineLoadIMG('worldmod.img')


-- Enable streaming from this IMG
engineAddImage(img)


-- Allocate a new TXD
local newTxdId = engineRequestTXD("WESTERNHOUSES01")


-- Link IMG files to TXD
engineImageLinkTXD(img, "western.txd", newTxdId)


-- Assign TXD to game models
engineSetModelTXDID(17697, newTxdId)
engineSetModelTXDID(17925, newTxdId)
engineSetModelTXDID(3646, newTxdId)

See Also

Engine Functions
Engine Elements
Reference