ctrlSetFade: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
No edit summary
m (Text replacement - "<sqf>([^↵][^\/]*↵[^\/]*)<\/sqf>" to "<sqf> $1 </sqf>")
 
(57 intermediate revisions by 7 users not shown)
Line 1: Line 1:
{{Command|= Comments
{{RV|type=command
____________________________________________________________________________________________


| arma |= Game name
|game1= arma1
|version1= 1.00


|1.00|= Game version
|game2= arma2
____________________________________________________________________________________________
|version2= 1.00


| Sets wanted transparency for control animation. |= Description
|game3= arma2oa
____________________________________________________________________________________________
|version3= 1.50


| controlName '''ctrlSetFade''' fade |= Syntax
|game4= tkoh
|version4= 1.00


|p1= controlName: [[Control]] |= Parameter 1
|game5= arma3
|version5= 0.50


|p2= fade: [[Number]] |= Parameter 2
|gr1= GUI Control


| [[Nothing]] |= Return value
|descr= Sets wanted transparency for control animation. Requires [[ctrlCommit]] to commit changes. To hide or show a control instantly, use [[ctrlShow]].
____________________________________________________________________________________________
{{Feature|informative|
 
If there are multiple (interactable) controls on top of each other but the top-most control is faded using <sqf inline>ctrlSetFade 1</sqf>,
|x1= <pre>_control ctrlSetFade 1</pre> |= Example 1
this control will interfere with other controls that were defined earlier and in the exact same position.
____________________________________________________________________________________________
To counter that, the faded control '''must''' be disabled with [[ctrlEnable]].
}}


| [[ctrlFade]] |= See also
|pr= Despite having <syntaxhighlight lang="cpp" inline>fade = 1;</syntaxhighlight> in a control's config, [[ctrlFade]] will still report a fade of 0 - resulting in <sqf inline>ctrlSetFade 0</sqf> doing nothing.<br>
To counter that, first use <sqf inline>ctrlSetFade 1</sqf>, then <sqf inline>ctrlCommit 0</sqf> to apply it, and only then [[ctrlSetFade]] can be used as usual.


}}
|s1= controlName [[ctrlSetFade]] fade


<h3 style="display:none">Notes</h3>
|p1= controlName: [[Control]]
<dl class="command_description">
<!-- Note Section BEGIN -->


<!-- Note Section END -->
|p2= fade: [[Number]]
</dl>


<h3 style="display:none">Bottom Section</h3>
|r1= [[Nothing]]


[[Category:Scripting Commands|CTRLSETFADE]]
|x1= <sqf>
[[Category:Scripting Commands ArmA|CTRLSETFADE]]
_control ctrlSetFade 1;
[[Category:Command_Group:_GUI_Control|{{uc:{{PAGENAME}}}}]]
_control ctrlCommit 5;
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
</sqf>
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]


<!-- CONTINUE Notes -->
|seealso= [[ctrlFade]] [[cutFadeOut]] [[ctrlCommit]]
<dl class="command_description">
}}
<dd class="notedate">Posted on March 10, 2015 - 02:02 (UTC)</dd>
 
<dt class="note">[[User:Feint|Feint]]</dt>
{{Note
<dd class="note">
|user= Nelis75733126
This command sets the amount of fade. For example:
|timestamp= 20240416211007
<code>
|text=in {{arma3}} 2.17, when <sqf inline>ctrlSetFade</sqf> is used on a CtrlToolbox or RscToolbox, it only has effect on the text of it.
_ctrl ctrlSetFade 1; // hides the control<br>
}}
_ctrl ctrlSetFade 0.5; // control is 50% visible<br>
_ctrl ctrlSetFade 0; // control is fully visible
</code>
</dd>
</dl>
<!-- DISCONTINUE Notes -->

Latest revision as of 11:35, 3 September 2024

Hover & click on the images for description

Description

Description:
Sets wanted transparency for control animation. Requires ctrlCommit to commit changes. To hide or show a control instantly, use ctrlShow.
If there are multiple (interactable) controls on top of each other but the top-most control is faded using ctrlSetFade 1,

this control will interfere with other controls that were defined earlier and in the exact same position.

To counter that, the faded control must be disabled with ctrlEnable.
Problems:
Despite having fade = 1; in a control's config, ctrlFade will still report a fade of 0 - resulting in ctrlSetFade 0 doing nothing.
To counter that, first use ctrlSetFade 1, then ctrlCommit 0 to apply it, and only then ctrlSetFade can be used as usual.
Groups:
GUI Control

Syntax

Syntax:
controlName ctrlSetFade fade
Parameters:
controlName: Control
fade: Number
Return Value:
Nothing

Examples

Example 1:
_control ctrlSetFade 1; _control ctrlCommit 5;

Additional Information

See also:
ctrlFade cutFadeOut ctrlCommit

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
Nelis75733126 - c
Posted on Apr 16, 2024 - 21:10 (UTC)
in Arma 3 2.17, when ctrlSetFade is used on a CtrlToolbox or RscToolbox, it only has effect on the text of it.