Difference between revisions of "setRain"
Jump to navigation
Jump to search
Lou Montana (talk | contribs) m (Text replacement - "Category:Scripting Commands ArmA2" to "Category:Scripting Commands Arma 2") |
killzone_kid (talk | contribs) |
||
(68 intermediate revisions by 5 users not shown) | |||
Line 1: | Line 1: | ||
− | {{ | + | {{RV|type=command |
− | |||
− | | | + | |game1= ofp |
+ | |version1= 1.75 | ||
− | |1. | + | |game2= ofpe |
+ | |version2= 1.00 | ||
− | | | + | |game3= arma1 |
+ | |version3= 1.00 | ||
− | | | + | |game4= arma2 |
− | + | |version4= 1.00 | |
− | | | + | |game5= arma2oa |
+ | |version5= 1.50 | ||
+ | |||
+ | |game6= tkoh | ||
+ | |version6= 1.00 | ||
+ | |||
+ | |game7= arma3 | ||
+ | |version7= 0.50 | ||
+ | |||
+ | |gr1= Environment | ||
+ | |||
+ | |eff= global | ||
+ | |||
+ | |serverExec= server | ||
+ | |||
+ | |descr= Sets rain density smoothly over the given transition time. A transition time of zero means an immediate change. | ||
A rain density of zero is no rain, one is maximum rain. Rain is not possible when [[overcast]] is less than 0.7. | A rain density of zero is no rain, one is maximum rain. Rain is not possible when [[overcast]] is less than 0.7. | ||
− | {{Feature arma3 | Since {{arma3}} this command is | + | {{Feature | arma3 | |
− | * | + | Since {{arma3}} this command is multiplayer synchronised: |
− | * | + | * if executed on the server, the changes will propagate globally. |
− | Minimum [[overcast]] needed for rain in {{arma3}} is '''0.5'''.}}| | + | * if executed on a client, the effect is local, temporary and will soon change to the server setting. |
− | + | Minimum [[overcast]] needed for rain in {{arma3}} is '''0.5'''. | |
+ | }} | ||
+ | |||
+ | {{Feature|important| | ||
+ | Alternative syntaxes ({{Link|#Syntax 2}} and {{Link|#Syntax 3}}): | ||
+ | * set rain particle params. Rain particles params are client-side params and are ignored on dedicated server. Use helper function [[BIS_fnc_setRain]] if sync is needed in Multiplayer | ||
+ | * have a '''[[Multiplayer Scripting#Locality|local]]''' {{Icon|localeffect|32}} effect | ||
+ | }} | ||
+ | |||
+ | |mp= Prior to {{arma3}}, each client and the server could have different rain values. | ||
+ | |||
+ | |s1= time [[setRain]] rain | ||
+ | |||
+ | |p1= time: [[Number]] - transition time in seconds to the new value | ||
+ | |||
+ | |p2= rain: [[Number]] - new rain value in range 0..1. | ||
+ | |||
+ | |r1= [[Nothing]] | ||
+ | |||
+ | |s2= {{Icon|localeffect|32}} [[setRain]] rainParams | ||
− | | | + | |s2since= arma3 2.08 |
− | | | + | |p21= rainParams: [[Array]] - array of custom [[Arma 3: CfgWorlds Config Reference#class RainParticles | {{hl|RainParticles}}]] params - see [[rainParams]]. Use empty array [] to reset to default config values |
− | | | + | |s3= {{Icon|localeffect|32}} [[setRain]] config |
− | | | + | |s3since= arma3 2.08 |
− | |||
− | |||
− | |||
− | | | + | |p41= config: [[Config]] - config path to a custom class, which contains [[Arma 3: CfgWorlds Config Reference#class RainParticles | {{hl|RainParticles}}]] class. Use [[configNull]] to reset to default config values |
− | [[ | ||
− | |||
− | |||
− | |||
− | | | + | |x1= <sqf>60 setRain 1;</sqf> |
− | |||
− | + | |x2= Force no rain: | |
− | + | <sqf> | |
− | < | + | 0 setRain 0; |
+ | forceWeatherChange; | ||
+ | 999999 setRain 0; | ||
+ | </sqf> | ||
− | < | + | |x3= Snow like effect (Since {{arma3}} v2.08): |
− | </ | + | <sqf> |
+ | 0 setOvercast 1; | ||
+ | 0 setRain 1; | ||
+ | 0 setFog 0.1; // snow affects visibility at distance | ||
+ | setHumidity 0.9; // don't want to see dust clouds | ||
+ | enableEnvironment [false, true]; // don't want to see snakes and butterflies either | ||
+ | forceWeatherChange; | ||
+ | setRain [ | ||
+ | "a3\data_f\rainnormal_ca.paa", // rainDropTexture | ||
+ | 1, // texDropCount | ||
+ | 0.01, // minRainDensity | ||
+ | 15, // effectRadius | ||
+ | 0.1, // windCoef | ||
+ | 2, // dropSpeed | ||
+ | 0.5, // rndSpeed | ||
+ | 0.5, // rndDir | ||
+ | 0.02, // dropWidth | ||
+ | 0.02, // dropHeight | ||
+ | [0.1, 0.1, 0.1, 1], // dropColor | ||
+ | 0.1, // lumSunFront | ||
+ | 0.1, // lumSunBack | ||
+ | 5.5, // refractCoef | ||
+ | 0.3, // refractSaturation | ||
+ | true, // snow | ||
+ | false // dropColorStrong | ||
+ | ]; | ||
+ | </sqf> | ||
− | + | |x4= After 2.10 | |
− | [ | + | <sqf> |
− | [ | + | 0 setOvercast 1; |
− | [ | + | 0 setRain 1; |
− | + | 0 setFog 0.1; | |
− | + | setHumidity 0.95; | |
− | + | enableEnvironment [false, true]; | |
− | + | forceWeatherChange; | |
− | + | [ | |
+ | "a3\data_f\snowflake4_ca.paa", // rainDropTexture | ||
+ | 4, // texDropCount | ||
+ | 0.01, // minRainDensity | ||
+ | 25, // effectRadius | ||
+ | 0.05, // windCoef | ||
+ | 2.5, // dropSpeed | ||
+ | 0.5, // rndSpeed | ||
+ | 0.5, // rndDir | ||
+ | 0.07, // dropWidth | ||
+ | 0.07, // dropHeight | ||
+ | [1, 1, 1, 0.5], // dropColor | ||
+ | 0.0, // lumSunFront | ||
+ | 0.2, // lumSunBack | ||
+ | 0.5, // refractCoef | ||
+ | 0.5, // refractSaturation | ||
+ | true, // snow | ||
+ | false // dropColorStrong | ||
+ | ] | ||
+ | call BIS_fnc_setRain; | ||
+ | </sqf> | ||
− | + | |seealso= [[rainParams]] [[BIS_fnc_setRain]] [[overcast]] [[setOvercast]] [[rain]] [[nextWeatherChange]] [[forceWeatherChange]] [[setFog]] [[setHumidity]] | |
− | + | }} | |
− | |||
− | |||
− | |||
− | [[ | ||
− | |||
− | |||
− | |||
− | + | {{Note | |
− | + | |user= Zapat | |
− | + | |timestamp= 20151215143100 | |
− | + | |text= [[setTimeMultiplier]] does '''not''' affect transition time. | |
− | + | }} | |
− | Using | + | |
− | + | {{Note | |
− | + | |user= Killzone_Kid | |
− | + | |timestamp= 20161116220600 | |
+ | |text= Using {{Link|#Example 2}} on dedicated server might need additional interference on JIP clients. The reason is that JIP has [[rain]] value > 0 slowly changing to 0. To force client to sync one can execute this on client: | ||
+ | <sqf>skipTime 1; skipTime -1;</sqf> | ||
+ | }} |
Latest revision as of 12:01, 25 July 2022
Description
- Description:
- Sets rain density smoothly over the given transition time. A transition time of zero means an immediate change. A rain density of zero is no rain, one is maximum rain. Rain is not possible when overcast is less than 0.7.
- Multiplayer:
- Prior to Arma 3, each client and the server could have different rain values.
- Groups:
- Environment
Syntax 1
- Syntax:
- time setRain rain
- Parameters:
- time: Number - transition time in seconds to the new value
- rain: Number - new rain value in range 0..1.
- Return Value:
- Nothing
Syntax 2
- Syntax:
- LELocal setRain rainParams
- Parameters:
- rainParams: Array - array of custom RainParticles params - see rainParams. Use empty array [] to reset to default config values
- Return Value:
- Nothing
Syntax 3
- Syntax:
- LELocal setRain config
- Parameters:
- config: Config - config path to a custom class, which contains RainParticles class. Use configNull to reset to default config values
- Return Value:
- Nothing
Examples
- Example 1:
- Example 2:
- Force no rain:
- Example 3:
- Snow like effect (Since Arma 3 v2.08):
0 setOvercast 1; 0 setRain 1; 0 setFog 0.1; // snow affects visibility at distance setHumidity 0.9; // don't want to see dust clouds enableEnvironment [false, true]; // don't want to see snakes and butterflies either forceWeatherChange; setRain [ "a3\data_f\rainnormal_ca.paa", // rainDropTexture 1, // texDropCount 0.01, // minRainDensity 15, // effectRadius 0.1, // windCoef 2, // dropSpeed 0.5, // rndSpeed 0.5, // rndDir 0.02, // dropWidth 0.02, // dropHeight [0.1, 0.1, 0.1, 1], // dropColor 0.1, // lumSunFront 0.1, // lumSunBack 5.5, // refractCoef 0.3, // refractSaturation true, // snow false // dropColorStrong ];
- Example 4:
- After 2.10
0 setOvercast 1; 0 setRain 1; 0 setFog 0.1; setHumidity 0.95; enableEnvironment [false, true]; forceWeatherChange; [ "a3\data_f\snowflake4_ca.paa", // rainDropTexture 4, // texDropCount 0.01, // minRainDensity 25, // effectRadius 0.05, // windCoef 2.5, // dropSpeed 0.5, // rndSpeed 0.5, // rndDir 0.07, // dropWidth 0.07, // dropHeight [1, 1, 1, 0.5], // dropColor 0.0, // lumSunFront 0.2, // lumSunBack 0.5, // refractCoef 0.5, // refractSaturation true, // snow false // dropColorStrong ] call BIS_fnc_setRain;
Additional Information
- See also:
- rainParams BIS_fnc_setRain overcast setOvercast rain nextWeatherChange forceWeatherChange setFog setHumidity
Notes
-
Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note
- Posted on Dec 15, 2015 - 14:31 (UTC)
- setTimeMultiplier does not affect transition time.
Categories:
- Scripting Commands
- Introduced with Operation Flashpoint version 1.75
- Operation Flashpoint: New Scripting Commands
- Operation Flashpoint: Scripting Commands
- Operation Flashpoint: Elite: Scripting Commands
- ArmA: Armed Assault: Scripting Commands
- Arma 2: Scripting Commands
- Arma 2: Operation Arrowhead: Scripting Commands
- Take On Helicopters: Scripting Commands
- Arma 3: Scripting Commands
- Command Group: Environment
- Scripting Commands: Global Effect
- Scripting Commands: Server Execution