SetWeatherBlended: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
m (Removed some confusing information and made the description a bit easier to understand)
Line 1: Line 1:
__NOTOC__  
__NOTOC__  
{{Server client function}}
{{Server client function}}
{{Note box|This is based on an in-game minute duration of 1,000 milliseconds}}
This function will change the current [[weather]] to another in a smooth manner, over the period of 2 in-game hours (unlike [[setWeather]], which sets a new weather instantly). To ensure this transition performs as expected, you should not call this function until [[getWeather]] indicates that no transition is already being done.
This function will change the [[weather]] from the current weather (set using [[setWeather]]) to another weather state over a period of 60 seconds. The weather will be fully changed within 2 minutes. To ensure smooth weather transition, you should not call this function until [[getWeather]] indicates that no transition is already being done.


==Syntax==  
==Syntax==  
Line 16: Line 15:


==Example==  
==Example==  
This example sets the weather to sunny, then makes it change to a foggy over the period of a minute.
This example sets the weather to sunny, then makes it change to a foggy over the period of two minutes (assuming that a in-game minute is a second in real time).
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
-- Set the weather to sunny
-- Set the weather to sunny

Revision as of 15:28, 28 December 2015

This function will change the current weather to another in a smooth manner, over the period of 2 in-game hours (unlike setWeather, which sets a new weather instantly). To ensure this transition performs as expected, you should not call this function until getWeather indicates that no transition is already being done.

Syntax

bool setWeatherBlended ( int weatherID )

Required Arguments

  • weatherID: The ID of the weather state you wish to set. Valid values are 0 to 255 inclusive.

Returns

Returns true if successful, false if an invalid weatherID is passed.

Example

This example sets the weather to sunny, then makes it change to a foggy over the period of two minutes (assuming that a in-game minute is a second in real time).

-- Set the weather to sunny
setWeather ( 0 )
-- Blend the weather to foggy
setWeatherBlended ( 9 )

See Also