ppEffectEnable: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
(alt syntax)
m (Some wiki formatting)
 
(52 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{Command|= Comments
{{RV|type=command
____________________________________________________________________________________________


| arma2 |= Game name
|game1= arma2
|version1= 1.00


|1.00|= Game version
|game2= arma2oa
____________________________________________________________________________________________
|version2= 1.50


| Enable / disable [[Post process effects]] |= Description
|game3= tkoh
____________________________________________________________________________________________
|version3= 1.00


| effect '''ppEffectEnable''' enable |= Syntax
|game4= arma3
|version4= 0.50


|p1= effect: [[String]] - name of the effect |= PARAMETER1
|gr1= Camera Control


|p2= enable: [[Boolean]] |= PARAMETER2
|descr= Enable / disable [[Post Process Effects]]
{{Feature | important | If effect fails to get enabled (can check it with [[ppEffectEnabled]]) try adding a little [[sleep]] in front of it. }}


|p3= |= PARAMETER3
|s1= effect [[ppEffectEnable]] enable


| Nothing |= RETURNVALUE
|p1= effect: [[String]] - name of the effect


| s2= effect '''ppEffectEnable''' enable |= Syntax
|p2= enable: [[Boolean]]


|p21= effect: [[Number]] - handle of the effect |= PARAMETER1
|r1= [[Nothing]]


|p22= enable: [[Boolean]] |= PARAMETER2
|s2= effect [[ppEffectEnable]] enable


|p23= |= PARAMETER3
|p21= effect: [[Number]] - handle of the effect


| r2= Nothing |= RETURNVALUE
|p22= enable: [[Boolean]]


| s3= effect '''ppEffectEnable''' enable |= Syntax
|r2= [[Nothing]]


|p41= effect: [[Array]] - array of effect handles |= PARAMETER1
|s3= effectArray [[ppEffectEnable]] enable


|p42= enable: [[Boolean]] |= PARAMETER2
|p41= effectArray: [[Array]] of [[Number]]s - array of effect handles


|p43= |= PARAMETER3
|p42= enable: [[Boolean]]


| r3= Nothing |= RETURNVALUE
|r3= [[Nothing]]


|x1= <sqf>"colorCorrections" ppEffectEnable true;</sqf>


|x1= <code>"colorCorrections" [[ppEffectEnable]] [[true]];</code>|= EXAMPLE1
|x2= <sqf>_hndl ppEffectEnable true;</sqf>
|x2= <code>_hndl [[ppEffectEnable]] [[true]];</code>|= EXAMPLE1
|x3= <code>[_hndl1, _hndl2] [[ppEffectEnable]] [[true]];</code>|= EXAMPLE1


____________________________________________________________________________________________
|x3= <sqf>[_hndl1, _hndl2] ppEffectEnable true;</sqf>


| [[Post process effects]], [[ppEffectForceInNVG]], [[ppEffectDestroy]], [[ppEffectCreate]], [[ppEffectCommit]], [[ppEffectCommitted]], [[ppEffectAdjust]] |= SEEALSO
|seealso= [[Post Process Effects]] [[ppEffectForceInNVG]] [[ppEffectDestroy]] [[ppEffectCreate]] [[ppEffectEnabled]] [[ppEffectCommit]] [[ppEffectCommitted]] [[ppEffectAdjust]]
 
|  |= MPBEHAVIOUR
____________________________________________________________________________________________
}}
}}


<h3 style='display:none'>Notes</h3>
{{Note
<dl class='command_description'>
|user= Pi123263
<!-- Note Section BEGIN -->
|timestamp= 20240406133257
|text= Using ppEffectEnable immediatelly enables/disables the effect. If you want the effect to fade in/out it might be better to use ppEffectAdjust.


<!-- Note Section END -->
If you want to fade out an effect using ppEffectAdjust you can set the values for the command back to the default and then use ppEffectCommit to set the time for the fadeout.
</dl>
<br>
 
Example:
<h3 style='display:none'>Bottom Section</h3>
Activate effect:
[[Category:ArmA 2: New Scripting Commands List|{{uc:{{PAGENAME}}}}]]
<sqf>
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
"colorCorrections" ppEffectAdjust [1,1,0,[0,0,0,0],[0,0,0,0.24],[1,1,1,0],[0.6,0.5,0,0,-0.1,0.4,0.8]];
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
"colorCorrections" ppEffectEnable true;
[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]
"colorCorrections" ppEffectCommit 0;
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
</sqf>
And then fade the effect out over 10 seconds:
<sqf>
"colorCorrections" ppEffectAdjust [1,1,0,[0,0,0,0],[1,1,1,1],[0.299, 0.587, 0.114, 0],[-1,-1,0,0,0,0,0]];
"colorCorrections" ppEffectCommit 10;
</sqf>
}}

Latest revision as of 09:27, 7 April 2024

Hover & click on the images for description

Description

Description:
Enable / disable Post Process Effects
If effect fails to get enabled (can check it with ppEffectEnabled) try adding a little sleep in front of it.
Groups:
Camera Control

Syntax 1

Syntax:
effect ppEffectEnable enable
Parameters:
effect: String - name of the effect
enable: Boolean
Return Value:
Nothing

Syntax 2

Syntax:
effect ppEffectEnable enable
Parameters:
effect: Number - handle of the effect
enable: Boolean
Return Value:
Nothing

Syntax 3

Syntax:
effectArray ppEffectEnable enable
Parameters:
effectArray: Array of Numbers - array of effect handles
enable: Boolean
Return Value:
Nothing

Examples

Example 1:
"colorCorrections" ppEffectEnable true;
Example 2:
_hndl ppEffectEnable true;
Example 3:
[_hndl1, _hndl2] ppEffectEnable true;

Additional Information

See also:
Post Process Effects ppEffectForceInNVG ppEffectDestroy ppEffectCreate ppEffectEnabled ppEffectCommit ppEffectCommitted ppEffectAdjust

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
Pi123263 - c
Posted on Apr 06, 2024 - 13:32 (UTC)
Using ppEffectEnable immediatelly enables/disables the effect. If you want the effect to fade in/out it might be better to use ppEffectAdjust. If you want to fade out an effect using ppEffectAdjust you can set the values for the command back to the default and then use ppEffectCommit to set the time for the fadeout.
Example: Activate effect:
"colorCorrections" ppEffectAdjust [1,1,0,[0,0,0,0],[0,0,0,0.24],[1,1,1,0],[0.6,0.5,0,0,-0.1,0.4,0.8]]; "colorCorrections" ppEffectEnable true; "colorCorrections" ppEffectCommit 0;
And then fade the effect out over 10 seconds:
"colorCorrections" ppEffectAdjust [1,1,0,[0,0,0,0],[1,1,1,1],[0.299, 0.587, 0.114, 0],[-1,-1,0,0,0,0,0]]; "colorCorrections" ppEffectCommit 10;