EngineGetModelTextures

From Multi Theft Auto: Wiki
Revision as of 19:39, 12 November 2020 by Pirulax (talk | contribs) (Add note that the return value structure is differente than stated (according to the source code))
Jump to navigation Jump to search

This function allows you to get the textures of any model.

Syntax

table engineGetModelTextures( string/int modelName/modelID [, string/table textureNames ] )

Required Arguments

  • model: either the model ID or model name.

Optional Arguments

  • textureNames: Only return textures with specified name(s). You can provide a single string or a table of strings. Wildcard matching e.g. "ro?ds*" can be used.

Returns

Returns a table of texture elements [textureName, texture], false otherwise.
Note: According to the source code the actual structure is: t[texture] = textureName

Example

Click to collapse [-]
Client

Get the textures for model ID 3722 and draw them with dxDrawImage.

function init()
	textures = engineGetModelTextures(3722)
	addEventHandler("onClientRender", root, render)
end
addEventHandler("onClientResourceStart", resourceRoot, init)

function render()
	local offset = 0
	for name,texture in pairs(textures) do
		local size = dxGetPixelsSize(dxGetTexturePixels(texture))
		dxDrawImage(0+offset, 0, size, size, texture)
		offset = offset + size
	end
end

Requirements

Minimum server version n/a
Minimum client version 1.5.7-9.20416

Note: Using this feature requires the resource to have the above minimum version declared in the meta.xml <min_mta_version> section. e.g. <min_mta_version client="1.5.7-9.20416" />

See Also