EngineSetModelLODDistance: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
mNo edit summary
No edit summary
Line 3: Line 3:
This function sets a custom LOD distance for any object / model ID. This is the distance at which objects of that model ID are switched to their LOD model, or (if there is no LOD model) become invisible.
This function sets a custom LOD distance for any object / model ID. This is the distance at which objects of that model ID are switched to their LOD model, or (if there is no LOD model) become invisible.


'''Note:''' the MTA streamer deletes objects that are further than 500 units away, regardless of LOD distance.<br />
'''Notes:'''
Also, GTA currently has the limitation whereby the object will not be displayed if the distance to the object center is more than 300 units.
The actual draw distance used is modified by the draw distance slider in the settings 'Video' tab of the MTA client.
 
*When the 'Video' tab draw distance slider is 0%, the engineSetModelLODDistance setting approximately matches the draw distance used.
:''e.g. engineSetModelLODDistance(1337,100) will mean model 1337 will be visible up to a distance of '''100''' units.''
 
*When the 'Video' tab draw distance slider is 100%, the engineSetModelLODDistance setting is approximately doubled before use.
:''e.g. engineSetModelLODDistance(1337,100) will mean model 1337 will be visible up to a distance of '''200''' units.''
 
However, there is a general draw distance limit of 300 units. So engineSetModelLODDistance(1337,400) will mean model 1337 will be visible up to a distance of 300 units no matter what the 'Video' tab says.
 
Therefore, unless it's really important, engineSetModelLODDistance should not be set to anything greater than 170.<br>
170 will still give the maximum draw distance (of 300 units) on clients that have a 'Video' tab draw distance setting of 100%, and it will help reduce lag for players who chose a lower draw distance in their settings.
 
{{New feature/item|3.0120|1.2||
For low LOD elements, engineSetModelLODDistance still has a limit of 300 units, but the actual draw distance used is 3 times the setting value.
}}


==Syntax==  
==Syntax==  

Revision as of 02:23, 5 December 2011

This function sets a custom LOD distance for any object / model ID. This is the distance at which objects of that model ID are switched to their LOD model, or (if there is no LOD model) become invisible.

Notes: The actual draw distance used is modified by the draw distance slider in the settings 'Video' tab of the MTA client.

  • When the 'Video' tab draw distance slider is 0%, the engineSetModelLODDistance setting approximately matches the draw distance used.
e.g. engineSetModelLODDistance(1337,100) will mean model 1337 will be visible up to a distance of 100 units.
  • When the 'Video' tab draw distance slider is 100%, the engineSetModelLODDistance setting is approximately doubled before use.
e.g. engineSetModelLODDistance(1337,100) will mean model 1337 will be visible up to a distance of 200 units.

However, there is a general draw distance limit of 300 units. So engineSetModelLODDistance(1337,400) will mean model 1337 will be visible up to a distance of 300 units no matter what the 'Video' tab says.

Therefore, unless it's really important, engineSetModelLODDistance should not be set to anything greater than 170.
170 will still give the maximum draw distance (of 300 units) on clients that have a 'Video' tab draw distance setting of 100%, and it will help reduce lag for players who chose a lower draw distance in their settings.

For low LOD elements, engineSetModelLODDistance still has a limit of 300 units, but the actual draw distance used is 3 times the setting value.

Syntax

bool engineSetModelLODDistance ( int model, float distance ) 

Required Arguments

  • model: The model / object ID number you want to change the LOD distance of.
  • distance: New LOD distance value in San Andreas units.

Returns

Returns true if the function executed succesfully, false otherwise.

Example

Click to collapse [-]
Client
-- TODO

See Also