EngineStreamingRequestModel

From Multi Theft Auto: Wiki
Jump to navigation Jump to search

ADDED/UPDATED IN VERSION 1.6.1 r22676:
This function sends a loading request to the game model streamer.

Syntax

boolean engineStreamingRequestModel( number modelID [, boolean addRef = false, boolean isBlocking = false ] )

Required Arguments

  • modelID: ID of the model you want to load

Optional Arguments

NOTE: When using optional arguments, you might need to supply all arguments before the one you wish to use. For more information on optional arguments, see optional arguments.

  • addRef: increase references counter to prevent the model from unloading.
  • isBlocking: load model immediately or use async loading.

Returns

Returns true if a new request was created, false otherwise.

References counter

This function has individual references counter for each resource. If you called engineStreamingRequestModel with increasing the counter twice, you should call engineStreamingReleaseModel twice to decrease the counter. MTA resets the counter after stopping a resource and calling engineFreeModel.

Example

Click to collapse [-]
Simple example

This example draws a model

local modelId = 1337

local function drawMyModel()
    dxDrawModel3D(modelId, 0, 0, 4, 0, 0, 0)
end

local function startDraw()
    engineStreamingRequestModel(modelId, true, true)
    addEventHandler("onClientPreRender", root, drawMyModel)
end

local function stopDraw()
    engineStreamingReleaseModel(modelId, true)
    removeEventHandler("onClientPreRender", root, drawMyModel)
end

See Also