EngineUnloadModel

	This function is deprecated. This means that its use is discouraged and that it might not exist in future versions.
	Please use engineRestoreModel instead.

This function "unloads" a custom model identified by a model id, and reloads the original GTA model.

Syntax

bool engineUnloadModel ( int model_id ) 

Required Arguments

• model_id: The model id used to identify the model that is being reloaded.

Returns

Returns true if the custom model was unloaded succesfully, false otherwise.

Example

This example loads a combination of custom DFF, TXD and COL files to replace an in-game model of a set of floors and unloads it again.

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" )
engineImportCOL ( col_floors, 3781 )
engineReplaceObjectModel ( dff_floors, 3781 )

-- do your logic

engineUnloadModel ( 3781 )

See Also

• engineApplyShaderToWorldTexture
• engineGetModelIDFromName
• engineGetModelLODDistance
• engineGetModelNameFromID

FROM VERSION 1.5.7 r19626 ONWARDS

• engineGetModelPhysicalPropertiesGroup
• engineRestoreModelPhysicalPropertiesGroup
• engineSetModelPhysicalPropertiesGroup
• engineGetObjectGroupPhysicalProperty
• engineRestoreObjectGroupPhysicalProperties
• engineSetObjectGroupPhysicalProperty

FROM VERSION 1.5.7 r20147 ONWARDS

• engineRequestModel
• engineFreeModel

• engineGetModelTextureNames
• engineGetVisibleTextureNames
• engineImportTXD
• engineLoadCOL
• engineLoadDFF
• engineLoadIFP
• engineLoadTXD
• engineRemoveShaderFromWorldTexture
• engineReplaceAnimation
• engineReplaceCOL
• engineReplaceModel
• engineRestoreAnimation
• engineRestoreCOL
• engineRestoreModel
• engineSetAsynchronousLoading
• engineSetModelLODDistance
• engineSetSurfaceProperties
• engineGetSurfaceProperties
• engineResetSurfaceProperties