Maintenance script: UI Lua API import (WAR 1.4.8)

2026-10-16T19:51:51Z

UI Lua API import (WAR 1.4.8)

New page

{{LuaApi|group=Window}}
Sets the alpha (opacity) of the text of a window and all of its descendants.

<pre>
WindowSetFontAlpha(windowName, alpha)
</pre>

== Arguments ==
;windowName : <code>string</code> – Name of the window.
;alpha : <code>number</code> – New font alpha, from 0 (invisible) to 1 (opaque).

== Returns ==
Nothing.

== Details ==
* Values below 0 are stored as 0 and values above 1 as 1.
* The same value is written to the window and to every descendant, replacing their own font alpha. Unlike [[API:WindowSetAlpha|WindowSetAlpha]], the value is not multiplied by the parent's.
* If the window itself already has this font alpha, nothing happens, and its descendants are not updated either, even if some of them have a different value.
* The window alpha set with [[API:WindowSetAlpha|WindowSetAlpha]] is separate. To fade a window including its text, set both.
* The function needs at least two arguments and only reads the last two.

== Errors ==
* <code>Error in function call 'WindowSetFontAlpha': Window %s does not exist</code>

== Example ==
Fading a tooltip, window and text together, from <code>easystem_tooltips/source/tooltips.lua</code>:
<pre>
function Tooltips.SetTooltipAlpha( alpha )
WindowSetAlpha( Tooltips.curTooltipWindow, alpha )
WindowSetFontAlpha( Tooltips.curTooltipWindow, alpha )
end
</pre>

== See also ==
* [[API:WindowGetFontAlpha|WindowGetFontAlpha]]
* [[API:WindowSetAlpha|WindowSetAlpha]]

API:WindowSetFontAlpha - Revision history

Maintenance script: UI Lua API import (WAR 1.4.8)