ctrlSetFade: Difference between revisions

From Bohemia Interactive Community
(Added informative note about very specific behavior related to this command. And changed other feature to warning. And changed my own note slightly.)
m (Text replacement - "<sqf>([^↵][^\/]*↵[^\/]*)<\/sqf>" to "<sqf> $1 </sqf>")
 
(2 intermediate revisions by the same user not shown)
Line 19: Line 19:


|descr= Sets wanted transparency for control animation. Requires [[ctrlCommit]] to commit changes. To hide or show a control instantly, use [[ctrlShow]].
|descr= Sets wanted transparency for control animation. Requires [[ctrlCommit]] to commit changes. To hide or show a control instantly, use [[ctrlShow]].
{{ Feature | Warning| Despite having <syntaxhighlight lang="cpp" inline>fade = 1;</syntaxhighlight> inside the config of a control, <sqf inline>ctrlFade</sqf> will '''still report a fade of 0'''.<br>
{{Feature|informative|
Which results in <sqf inline>ctrlSetFade 0</sqf> '''doing nothing'''.<br>
If there are multiple (interactable) controls on top of each other but the top-most control is faded using <sqf inline>ctrlSetFade 1</sqf>,
To counter that, first use <sqf inline>ctrlSetFade 1</sqf>, then <sqf inline>ctrlCommit 0</sqf> ( to instantly apply it ), and then you can use [[ctrlSetFade]] to set the fade to any value you wish.}}
this control will interfere with other controls that were defined earlier and in the exact same position.
{{ Feature | Informative | If there are multiple (interact-able) controls on top of each other but the top-most is faded using <sqf inline>ctrlSetFade 1</sqf>, the top-most control will interfere with controls that were defined earlier and in the exact same position. To counter that, the faded control '''needs to be disabled''' with [[ctrlEnable]].}}
To counter that, the faded control '''must''' be disabled with [[ctrlEnable]].
}}
 
|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
|s1= controlName [[ctrlSetFade]] fade


Line 31: Line 36:
|r1= [[Nothing]]
|r1= [[Nothing]]


|x1= <sqf>_control ctrlSetFade 1;
|x1= <sqf>
_control ctrlCommit 5;</sqf>
_control ctrlSetFade 1;
_control ctrlCommit 5;
</sqf>


|seealso= [[ctrlFade]] [[cutFadeOut]] [[ctrlCommit]]
|seealso= [[ctrlFade]] [[cutFadeOut]] [[ctrlCommit]]
Line 38: Line 45:


{{Note
{{Note
|user= Nelis.75733126
|user= Nelis75733126
|timestamp= 20240416211007
|timestamp= 20240416211007
|text=in Arma 3 2.17, when <sqf inline>ctrlSetFade</sqf> is used on a CtrlToolbox or RscToolbox, it only has effect on the text of it.
|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.
}}
}}

Latest revision as of 11:35, 3 September 2024

Logo A1 black.png 1.00Logo A2.png 1.00A2 OA Logo.png 1.50tkoh logo small.png 1.00Arma 3 logo black.png 0.50
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.
Retrieved from "https://community.bistudio.com/wiki?title=ctrlSetFade&oldid=369232"